Files
harness_coding_docs/docs/clean-state-checklist.md
chengma f4664266cc
Harness governance / validate (push) Has been cancelled
docs(workflow): complete H-414 cross-agent gates
2026-07-31 15:37:10 +08:00

2.2 KiB

干净收尾检查清单

每轮会话结束前逐项过一遍,确保仓库处于"下一轮无需人工修复即可直接开工"的状态。 这是把"提前宣告完成"挡在门外的最后一道关卡,配合 05-coding-rules.md 的验证清单使用。

收尾前确认:

  • 标准启动路径仍可用(./init.sh 或本项目等价命令能跑通)。
  • 标准验证 / smoke 仍可运行,结果如实。
  • 本轮执行记录已写进当前任务文件(docs/tasks/T-<编号>.md)的 ## 执行记录(含跑过的命令和结果作为证据)。
  • 任务文件 frontmatter 的 status 真实反映 DONE 与未验证的边界,没有"假 DONE"。
  • 必需的人工 / 设备验收已经完成;尚在等待时任务保持 DOING 或 BLOCKED,没有提前标记 DONE。
  • 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_harness_governance.py;启用且可连接 Gitea 时,还运行了只读 python scripts/audit_gitea_coordination.py --repo 【owner/repo】 --dispatcher 【Gitea登录名】。

任意一项不满足,就先补到满足,再结束会话。