跳转至

检查点 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 页,至少写清:

  1. 姓名、学号、项目名称,以及相较检查点 3 的进展和反馈处理情况。
  2. 原设计中的目标和任务是否完成,哪些作过调整、原因是什么,剩余工作准备怎样处理。
  3. 一项主要任务的开发经过,AI 参与的工作、本人作出的判断,以及正常和边界情况的检查结果。
  4. AGENTS.md 的实际使用情况,以及本阶段对开发规则所作的修改;没有修改的说明即可。
  5. GitLab 地址、分支、检查点 3 与本次提交编号,以及设计与计划文档、完整 AI 记录和附件的位置。

详细设计、任务完成情况、对话和日志另附。图片随压缩包提交,使用相对路径引用。

评分标准(5 分)

分项 分值 主要看什么
按期提交与材料完整性 1 按时提交;报告不超过 2 页,代码、设计与计划文档、AGENTS.md 和 AI 记录齐全,链接及版本正确
阶段成果 2 对照原设计检查功能和任务的完成情况,已完成部分有运行结果;设计调整、未完成项和剩余问题说明清楚
方法与过程记录 2 开发经过、计划调整、AGENTS.md 的使用和本人检查有具体记录,能对应到 AI 对话及 Git 提交

完整评分构成见大作业评分细则。

后续安排:11 月 22 日前完成同伴互评;根据同伴互评反馈修改后,11 月 29 日前提交最终版,说明修改与验证结果,未采纳的建议说明理由。截止时间均为当日 23:59(北京时间)。12 月 1 日课堂展示,项目由教学团队依据最终提交质量选定。详见课程安排。