26 lines
2.2 KiB
Markdown
26 lines
2.2 KiB
Markdown
# 干净收尾检查清单
|
|
|
|
> 每轮会话结束前逐项过一遍，确保仓库处于"下一轮无需人工修复即可直接开工"的状态。
|
|
> 这是把"提前宣告完成"挡在门外的最后一道关卡，配合 [`05-coding-rules.md`](05-coding-rules.md) 的验证清单使用。
|
|
|
|
收尾前确认：
|
|
|
|
- [ ] 标准启动路径仍可用（`./init.sh` 或本项目等价命令能跑通）。
|
|
- [ ] 标准验证 / smoke 仍可运行，结果如实。
|
|
- [ ] 本轮执行记录已写进当前任务文件（`docs/tasks/T-<编号>.md`）的 `## 执行记录`（含跑过的命令和结果作为证据）。
|
|
- [ ] 任务文件 frontmatter 的 `status` 真实反映 `DONE` 与未验证的边界，没有"假 DONE"。
|
|
- [ ] 必需的人工 / 设备验收已经完成；尚在等待时任务保持 `DOING` 或 `BLOCKED`，没有提前标记 `DONE`。
|
|
- [ ] [`current-state.md`](current-state.md) 的项目级快照与现实一致（启动/验证路径、目录要点、blocker）。
|
|
- [ ] 没有半成品改动处于未记录状态；如有，已写明 `BLOCKED` / `PARTIAL` 和原因。
|
|
- [ ] 代码处于可安全恢复的状态（必要时已提交，提交信息清晰）。
|
|
- [ ] 任务所有者已亲自检查 `git status --short`、`git diff` 和 `git diff --cached`；本轮实际修改没有超出任务 `write_paths`，也没有与其他活跃任务发生路径重叠。
|
|
- [ ] 已执行 `git diff --check`，并按格式化工具 / `.gitattributes` 检查没有意外空白或行尾变化。
|
|
- [ ] 已按 `03-tech-stack.md` 的验证矩阵独立重跑任务相关验证和所有已触发门禁，没有仅凭执行者 / 子 Agent / 工具的自我报告判定完成。
|
|
- [ ] 需要部署或交接构建产物时，已记录产物路径、生成命令和项目规定的指纹。
|
|
- [ ] 启用 Gitea 时，Issue 的唯一 `status/*`、claim / 工作分支、PR 和任务状态彼此一致；未完成任务没有误删 claim。
|
|
- [ ] 已运行仓库内真实存在的治理检查；当前至少包括
|
|
`python scripts/validate_agent_context.py`。仅在以后实际引入对应脚本和 Gitea 工作流后，
|
|
才增加 Gitea 审计门禁，不能引用不存在的占位脚本。
|
|
|
|
任意一项不满足，就先补到满足，再结束会话。
|