docs(tasks): make one-task-per-file the default task mode (H-409)

- docs/tasks/README.md: default mode for single and multi agent, drop switch narrative
- docs/06-tasks.md: demote to read-only roadmap (phases, milestones, backlog, suggested split list without status)
- progress.md: optional archive / project-level event log; execution records live in task files
- current-state.md: project-level snapshot; task status authoritative in task frontmatter
- sync all referencing docs (start-here, coding-rules, READMEs, adoption/clean-state checklists, method-map, evaluator-rubric)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
chengma
2026-07-13 09:34:48 +08:00
co-authored by Claude Fable 5
parent 58ebb1fe26
commit 795a852aa9
15 changed files with 138 additions and 138 deletions
+15 -17
View File
@@ -1,31 +1,29 @@
# 执行进度记录
# 执行进度记录(可选 · 历史归档)
> 本文件是只追加的历史流水,用来记录任务执行过程、验证命令、阻塞点和关键决策。
> 当前目录、当前命令、下一个可领取任务等可覆盖快照,写入 [`docs/current-state.md`](docs/current-state.md)。
> **默认模式下本文件是可选工件**:执行记录写进各任务文件(`docs/tasks/T-<编号>.md`)的 `## 执行记录`,本文件不逐任务追加,约定见 [`docs/tasks/README.md`](docs/tasks/README.md)。
> 保留本文件的两个用途:① 归档采用一任务一文件之前的历史流水;② 可选记录跨任务的项目级大事记(阶段切换、重大决策、事故复盘)。
## 职责边界
- `docs/06-tasks.md`:任务看板,维护任务状态、依赖和验收要点。
- `progress.md`:历史流水,只追加记录每轮执行发生了什么。
- `docs/current-state.md`:当前快照,可覆盖更新仓库现实、可运行命令和下一步。
- `docs/tasks/T-<编号>.md`:任务规格、状态(frontmatter)和执行记录,任务级事实以此为准。
- `docs/06-tasks.md`:只读路线图(阶段划分、里程碑、待办池)。
- `docs/current-state.md`:当前快照,可覆盖更新仓库现实、可运行命令和 blocker。
- `progress.md`(本文):可选历史归档 / 项目级大事记,不维护任务状态,不逐任务追加。
不要在本文重复维护当前目录结构、当前运行命令或下一个任务;这些信息以 `docs/current-state.md` 为准。
## 记录格式
## 记录格式(如启用大事记)
每完成或中断一轮任务,在文件末尾追加一条记录:
记录项目级大事记时,在文件末尾追加:
```markdown
## 【YYYY-MM-DD】T-【编号】 【任务名】
## 【YYYY-MM-DD】【事件 / 决策标题】
- 状态:【DONE / BLOCKED / PARTIAL】
- 变更:【修改了哪些文件或模块】
- 验证:【运行的真实命令和结果】
- 阻塞:【如有,写明原因和需要谁决策】
- 决策:【如有,记录本轮确定的关键取舍】
- 下一步:【建议下一个任务 ID 或待确认事项】
- 类型:【阶段切换 / 重大决策 / 事故复盘 / 其他】
- 内容:【发生了什么、为什么】
- 影响:【对后续任务或架构的影响】
```
## 执行记录
## 历史归档
<!-- 新项目开始后,从这里向下追加记录。 -->
<!-- 采用一任务一文件之前的历史流水保留在此;新的执行记录写进各任务文件的 ## 执行记录。 -->