2026-07-13 09:34:48 +08:00
|
|
|
# 执行进度记录（可选 · 历史归档）
|
2026-06-24 17:07:53 +08:00
|
|
|
|
2026-07-13 09:34:48 +08:00
|
|
|
> **默认模式下本文件是可选工件**：执行记录写进各任务文件（`docs/tasks/T-<编号>.md`）的 `## 执行记录`，本文件不逐任务追加，约定见 [`docs/tasks/README.md`](docs/tasks/README.md)。
|
|
|
|
|
> 保留本文件的两个用途：① 归档采用一任务一文件之前的历史流水；② 可选记录跨任务的项目级大事记（阶段切换、重大决策、事故复盘）。
|
2026-06-24 17:07:53 +08:00
|
|
|
|
|
|
|
|
## 职责边界
|
|
|
|
|
|
2026-07-13 09:34:48 +08:00
|
|
|
- `docs/tasks/T-<编号>.md`：任务规格、状态（frontmatter）和执行记录，任务级事实以此为准。
|
|
|
|
|
- `docs/06-tasks.md`：只读路线图（阶段划分、里程碑、待办池）。
|
|
|
|
|
- `docs/current-state.md`：当前快照，可覆盖更新仓库现实、可运行命令和 blocker。
|
|
|
|
|
- `progress.md`（本文）：可选历史归档 / 项目级大事记，不维护任务状态，不逐任务追加。
|
2026-06-24 17:07:53 +08:00
|
|
|
|
|
|
|
|
不要在本文重复维护当前目录结构、当前运行命令或下一个任务；这些信息以 `docs/current-state.md` 为准。
|
|
|
|
|
|
2026-07-13 09:34:48 +08:00
|
|
|
## 记录格式（如启用大事记）
|
2026-06-24 17:07:53 +08:00
|
|
|
|
2026-07-13 09:34:48 +08:00
|
|
|
记录项目级大事记时，在文件末尾追加：
|
2026-06-24 17:07:53 +08:00
|
|
|
|
|
|
|
|
```markdown
|
2026-07-13 09:34:48 +08:00
|
|
|
## 【YYYY-MM-DD】【事件 / 决策标题】
|
2026-06-24 17:07:53 +08:00
|
|
|
|
2026-07-13 09:34:48 +08:00
|
|
|
- 类型：【阶段切换 / 重大决策 / 事故复盘 / 其他】
|
|
|
|
|
- 内容：【发生了什么、为什么】
|
|
|
|
|
- 影响：【对后续任务或架构的影响】
|
2026-06-24 17:07:53 +08:00
|
|
|
```
|
|
|
|
|
|
2026-07-13 09:34:48 +08:00
|
|
|
## 历史归档
|
2026-06-24 17:07:53 +08:00
|
|
|
|
2026-07-13 09:34:48 +08:00
|
|
|
<!-- 采用一任务一文件之前的历史流水保留在此；新的执行记录写进各任务文件的 ## 执行记录。 -->
|
