Files
harness_coding_docs/docs/clean-state-checklist.md
T
chengma e9e6dede7a
Harness governance / validate (push) Has been cancelled
docs(review): add risk-based read-only agent gates
2026-07-16 19:04:02 +08:00

1.8 KiB

干净收尾检查清单

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

收尾前确认:

  • 标准启动路径仍可用(./init.sh 或本项目等价命令能跑通)。
  • 标准验证 / smoke 仍可运行,结果如实。
  • 本轮执行记录已写进当前任务文件(docs/tasks/T-<编号>.md)的 ## 执行记录(含跑过的命令和结果作为证据)。
  • 任务文件 frontmatter 的 status 真实反映 DONE 与未验证的边界,没有"假 DONE"。
  • current-state.md 的项目级快照与现实一致(启动/验证路径、目录要点、blocker)。
  • 没有半成品改动处于未记录状态;如有,已写明 BLOCKED / PARTIAL 和原因。
  • 代码处于可安全恢复的状态(必要时已提交,提交信息清晰)。
  • 本轮实际修改没有超出任务 write_paths,也没有与其他活跃任务发生路径重叠。
  • review_mode: test / dual 的必需评审已覆盖当前 PR head;未启用 PR 时至少覆盖最后一个实现变更提交,且之后只有当前任务文件的评审证据提交。没有沿用旧 SHA 结论或遗留阻断 / 高风险发现。
  • 启用 Gitea 时,Issue 的唯一 status/*、claim / 工作分支、PR 和任务状态彼此一致;未完成任务没有误删 claim。
  • 已运行 python scripts/validate_harness_governance.py;启用且可连接 Gitea 时,还运行了只读 python scripts/audit_gitea_coordination.py --repo 【owner/repo】 --dispatcher 【Gitea登录名】。

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