AI 辅助编程：生成只是开始，验证才算完成¶

对应课程：Week 3｜AI-assisted Coding · 专题最小练习：2–3 小时 · 完整 Week 3：约 24 小时 · 最终产出：可测试的代码、Prompt 记录与人工审查

AI coding assistant 可以帮助解释代码、生成草稿、补充测试和发现边界条件，但不能替你确认需求、数据授权、安全性与结论。课程采用同一个闭环：

Define → Ask → Inspect → Test → Disclose
定义任务   请求建议   人工审查   运行验证   披露使用

模块学习卡与完成路径¶

字段	本页约定
对应周次	Week 3
适合谁	已有一个小型代码任务，能够运行并检查测试的学生
预计时间	最小 2–3 小时；完整 Week 3 约 24 小时
学什么	Task Card、最小上下文、代码审查、验证矩阵与 AI 使用披露
官方来源	所用 AI 工具官方文档、语言/库官方文档和项目测试框架文档
最小动作	写一张 Task Card，让 AI 提供建议，人工审查并用测试验证一次
提交证据	Task Card、关键交互记录、代码 diff、测试输出和人工决策说明
完成自查	能解释最终代码，指出接受/拒绝建议的证据，未泄漏敏感数据
下一步	返回 Week 3整理完整证据

路径	完成范围
最小	一张 Task Card、一次 AI 建议、一次人工审查和对应测试
标准	完成五步闭环、正常/异常测试和 AI 使用记录
进阶	比较两种 Prompt/模型建议，或增加属性测试、安全检查与回归测试

项目	约定
前置条件	一个边界明确的小任务、可运行代码、测试入口；不含密钥、私人文档或未授权数据
唯一入口	先填写本页 Task Card，再打开 AI 工具；没有验收标准时不开始生成代码
版本	记录 AI 工具/模型名称与日期、代码 commit、语言、依赖和测试框架版本
预计耗时	30 分钟定义任务，60–90 分钟审查与测试，30 分钟记录决策
算力与成本	不需要 GPU；可使用已有或免费工具，不要求购买订阅/API 额度
输入	Task Card、最少必要代码、错误信息、输入输出示例与约束
预期输出	`task-card.md`、`ai-use-log.md`、代码 diff、测试与 review 记录
成功判定	验收标准有测试证据支持，最终改动可解释、可复现、可披露
常见失败与恢复	建议过宽时缩小 Task；代码不可运行时回到最小复现；测试只覆盖 happy path 时补充边界和失败案例

完成本页后，你应能：

## Task Card
- 目标：
- 当前行为：
- 期望行为：
- 输入与输出示例：
- 必须满足的约束：
- 不允许修改的范围：
- 验收标准：
- 已知失败案例：

任务卡中必须出现可以检查的动词，例如“对不存在的文件返回非零退出码”，而不是“让代码更健壮”。

一个有效请求通常包含：

示例：

请审查下面的 Python CLI 函数。目标是让不存在的输入文件返回退出码 2，
并保留现有成功路径。不要增加第三方依赖，也不要修改输出文件格式。
先列出风险和测试用例，再给最小补丁。验收标准：3 个正常测试、
2 个异常测试全部通过，--help 行为不变。

不能提供给外部 AI 的内容

API key、密码、私人文档、未公开论文、受限数据、真实用户信息，以及你无权分享的代码。必要时使用最小复现、合成数据和脱敏片段。

逐项检查：

当 AI 无法说明假设或来源时，不应把“看起来合理”当作证据。

Week 3 至少完成下面五类测试：

推荐从标准库 unittest 开始：

python -m unittest discover -v

测试失败时先记录现象和假设，再请 AI 协助缩小范围。不要反复要求“修好它”并盲目接受整段重写。

prompt-log.md 不需要保存所有聊天内容，只保留影响代码和结论的关键回合：

## Interaction 01
- 任务：
- 提供给 AI 的必要上下文：
- AI 的核心建议：
- 我接受、修改或拒绝了什么：
- 验证方式与结果：
- 仍未解决的风险：

最终 README 中增加一段 AI 使用披露：工具名称、使用环节、人工修改、测试证据与剩余限制。

完成判定 / Definition of Done

学生能解释最终 diff；测试覆盖正常与异常路径；至少一项 AI 建议被有理由地修改或拒绝；任何结论都不只依赖 AI 自我评价。

完成验证闭环后，进入Week 4｜Vision-Language Models。继续使用 AI 时沿用同一记录方式，不向工具上传课程中的私人文档或密钥。