Update harness coding documentation templates

2026-06-24 17:07:53 +08:00
parent d6c0e5b612
commit 2b4a842d7a
13 changed files with 189 additions and 79 deletions
@@ -0,0 +1,31 @@
+# 执行进度记录
+
+> 本文件是只追加的历史流水，用来记录任务执行过程、验证命令、阻塞点和关键决策。
+> 当前目录、当前命令、下一个可领取任务等可覆盖快照，写入 [`docs/current-state.md`](docs/current-state.md)。
+
+## 职责边界
+
+- `docs/06-tasks.md`：任务看板，维护任务状态、依赖和验收要点。
+- `progress.md`：历史流水，只追加记录每轮执行发生了什么。
+- `docs/current-state.md`：当前快照，可覆盖更新仓库现实、可运行命令和下一步。
+
+不要在本文重复维护当前目录结构、当前运行命令或下一个任务；这些信息以 `docs/current-state.md` 为准。
+
+## 记录格式
+
+每完成或中断一轮任务，在文件末尾追加一条记录：
+
+```markdown
+## 【YYYY-MM-DD】T-【编号】 【任务名】
+
+- 状态：【DONE / BLOCKED / PARTIAL】
+- 变更：【修改了哪些文件或模块】
+- 验证：【运行的真实命令和结果】
+- 阻塞：【如有，写明原因和需要谁决策】
+- 决策：【如有，记录本轮确定的关键取舍】
+- 下一步：【建议下一个任务 ID 或待确认事项】
+```
+
+## 执行记录
+
+<!-- 新项目开始后，从这里向下追加记录。 -->