检查点 4:规范检查
截止时间:2026 年 11 月 15 日(周日)23:59(北京时间)。提交方式见网络学堂。
本次要求
1. 对照项目设计,检查完成情况。
对照项目设计时确定的目标、功能和任务安排,逐项说明目前完成了什么,是否达到原定要求。已完成的部分给出运行或测试结果;未完成的部分说明原因,以及准备在最终提交前完成哪些工作。
保留原有设计和计划。开发中调整过目标、功能或实现方案的,写清改了什么、为什么改,以及调整后的完成情况。已有成果、课程中新增的工作和仍未完成的内容要分开说明。
2. 说明主要任务的完成经过。
选取一项主要任务,回顾从设计到实现的过程:当时分成了哪些步骤,按什么顺序完成,遇到了哪些问题、如何处理。结合对应的 AI 对话和代码提交,说明 AI 完成了哪些工作,你作了哪些决定、修改和检查。
本人至少运行一条主要流程或一项核心改动,检查一个正常情况和一个相关的边界或错误情况,记录操作、输入、预期与实际结果。可以通过界面操作;说明哪些检查由本人完成、哪些由 AI 执行,使用模拟数据或接口时注明。
说明相较检查点 3 新增或修正了什么,以及对助教反馈的处理情况。
3. 核对项目文档和开发记录。
提交项目的 AGENTS.md,结合实际开发说明使用了哪些规则、执行过程中是否作过修改。检查 README.md 和 AGENTS.md 中的目录、启动和测试命令,更新已经失效的内容。
保留完整 AI 对话和 Git 历史,包括失败尝试及可导出的工具执行结果。报告中提到的开发任务和检查结果,应注明对应会话、提交或附件位置。此前阶段的记录可以注明已提交的位置,本次提交新增记录。
提交材料
每人提交一个压缩包,命名为 学号_姓名_checkpoint4.zip。继续使用 GitLab 管理代码,提交前推送本次改动,确认助教可以访问报告中指定的版本。
提交目录:
学号_姓名_checkpoint4/
├── report.md # 报告正文不超过 2 页,格式按网络学堂要求
├── ai-records/ # 本阶段完整 AI 交互记录
│ └── ...
├── attachments/ # 可选:报告引用的图片、运行日志等
│ └── ...
└── project/ # 提供完整 GitLab 仓库链接时可省略
├── .git/ # 打包仓库时保留版本历史
├── README.md # 环境、启动与检查方法
├── AGENTS.md # 项目中使用的开发规则
├── PLAN.md # 原有设计与任务计划,附完成情况和调整说明
└── ... # 代码、测试和必要样例
设计与计划文档、完成情况说明和 AGENTS.md 均需提交到 GitLab。文件名和位置沿用项目现有安排即可,在报告中注明。交仓库压缩包时,内容应与报告中的提交编号一致,不要打包依赖安装目录、虚拟环境和缓存。操作方法见 Git 使用基础。
报告正文不超过 2 页,至少写清:
- 姓名、学号、项目名称,以及相较检查点 3 的进展和反馈处理情况。
- 原设计中的目标和任务是否完成,哪些作过调整、原因是什么,剩余工作准备怎样处理。
- 一项主要任务的开发经过,AI 参与的工作、本人作出的判断,以及正常和边界情况的检查结果。
AGENTS.md的实际使用情况,以及本阶段对开发规则所作的修改;没有修改的说明即可。- GitLab 地址、分支、检查点 3 与本次提交编号,以及设计与计划文档、完整 AI 记录和附件的位置。
详细设计、任务完成情况、对话和日志另附。图片随压缩包提交,使用相对路径引用。
评分标准(5 分)
| 分项 | 分值 | 主要看什么 |
|---|---|---|
| 按期提交与材料完整性 | 1 | 按时提交;报告不超过 2 页,代码、设计与计划文档、AGENTS.md 和 AI 记录齐全,链接及版本正确 |
| 阶段成果 | 2 | 对照原设计检查功能和任务的完成情况,已完成部分有运行结果;设计调整、未完成项和剩余问题说明清楚 |
| 方法与过程记录 | 2 | 开发经过、计划调整、AGENTS.md 的使用和本人检查有具体记录,能对应到 AI 对话及 Git 提交 |
完整评分构成见大作业评分细则。
后续安排:11 月 22 日前完成同伴互评;根据同伴互评反馈修改后,11 月 29 日前提交最终版,说明修改与验证结果,未采纳的建议说明理由。截止时间均为当日 23:59(北京时间)。12 月 1 日课堂展示,项目由教学团队依据最终提交质量选定。详见课程安排。