附录C AI协同项目证据包模板

本模板用于第1—11章的章项目和第12章综合项目。课堂项目可以只填写与当前任务有关的字段，但不能删除任务边界、测试、人工接管和交接信息。

一、任务与验收合同

1．任务名称

用一个动作和一个明确对象命名，例如“把企业运营服务请求整理为待确认工作单”，不要使用“万能助手”“智能平台”等宽泛名称。

2．使用者与工作结果

• 主要使用者：
• 当前工作方式：
• 希望改善的结果：
• 如果做错，可能影响谁：
• 任务责任人：

3．输入、处理与输出

4．验收样例

至少列出一个正常、一个边界、一个陌生和一个故障样例。写明输入、预期输出、不可接受行为和由谁判定。

二、项目上下文

1．材料与来源

2．项目文件

建议至少说明：

• README：任务、运行入口、环境和边界；
• input或data：样例和数据说明；
• src或Notebook：完整实现；
• tests：固定测试样例；
• acceptance.py：一键检查文件、语法、测试和参考结果；
• reports：真实运行结果与采用判断；
• output：可重建但不纳入正式源稿的临时结果；
• evidence：运行、差异、回归和验收记录。

3．环境与设备

• 操作系统与主要运行环境：
• Python或其他运行时版本：
• 模型文件或服务位置：
• 是否使用云端数据：
• 设备型号和官方资料：
• H0虚拟或预录替代路径：

三、AI协同开发记录

证据1：学生提供任务与上下文

记录学生实际提供的任务、材料、限制和文件范围。删除账号、密钥和隐私信息。

证据2：AI追问与候选方案

记录AI提出的关键缺失条件、候选实现和风险。标出学生补充、修改或拒绝的内容及理由。

证据3：完整首版及解释

记录首版文件清单、运行入口、输入输出、模型位置和测试方法。不能只保存一段无法独立运行的代码。

每章配套工程应能用python acceptance.py运行离线核心验收。模型或云服务不能运行时，验收入口仍要清楚区分“结构与测试已通过”和“真实模型尚未运行”，不能把前者冒充后者。

证据4：运行观察与错误反馈

记录实际命令、环境、输入、完整错误或输出，以及与预期不一致的位置。不要只写“运行失败”。

证据5：限定修改与文件差异

证据6：固定回归与最终判断

记录同一测试集修改前后的结果，说明采用、限用、退回或停止的决定及责任人。

四、数据卡

• 数据用途和禁止用途：
• 数据来源、采集或生成方式：
• 样本数量、类别或时间范围：
• 标签由谁制定和检查：
• 训练、验证、测试怎样隔离：
• 缺失、重复、偏差和已知问题：
• 隐私、授权、保存和删除：
• 当前版本及与上一版本差异：

五、模型卡

• 模型任务与输出：
• 模型来源和版本：
• 训练或迁移数据：
• 规则或人工基线：
• 主要评价指标和实际样例数：
• 不同环境、对象或群体的表现：
• 已知失败和不适用范围：
• 置信分数与人工复核规则：
• 部署位置、延迟、费用和资源：
• 更新、回归、回滚和维护责任：

六、测试与验收记录

验收结论只能选择以下一种，并写明条件：

1. 通过：允许在明确范围内使用。
2. 限用：仅允许指定使用者、数据、时间或人工监督条件。
3. 退回：必须完成指定修改并重新回归。
4. 停止：当前收益不足、风险不可接受或无法可靠维护。

七、交接清单

• [ ] 另一组能根据README建立环境并运行最小样例。
• [ ] 输入、输出、单位、字段和文件位置清楚。
• [ ] 数据和模型版本可以追溯。
• [ ] 正常、边界、陌生和故障测试可以重复。
• [ ] 高代价错误、停止条件和人工接管明确。
• [ ] 密钥、隐私和无授权资料未进入交付包。
• [ ] 已知问题、未完成事项和下一步责任人明确。
• [ ] 回滚包和上一可用版本仍可获取。

八、维护记录