docs: move per-task progress into task files, stop per-task current-state overwrite
Tests / Python 3.11 / Windows (push) Has been cancelled

- AGENTS.md: 收尾只更新对应任务文件(状态 + ## 执行记录),不再逐任务追加
  progress.md / 覆盖 current-state.md(每任务共享写入=多 agent 抢占点)
- docs/tasks/_template.md: 加 ## 执行记录 一节
- docs/tasks/README.md: 完成流程改为执行记录写进任务文件
- progress.md: 冻结为历史归档;新执行记录进任务文件
- docs/current-state.md: 不再逐任务覆盖,状态以 docs/tasks/ frontmatter 为准

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
chengma
2026-07-08 10:19:55 +08:00
co-authored by Claude Opus 4.8
parent 3a552b1880
commit 4acac32b40
5 changed files with 27 additions and 17 deletions
+1 -1
View File
@@ -29,7 +29,7 @@
- 只做当前任务范围内的事;T-504 已接入的多账号并行、dry-run、运行日志属于当前范围,其他 V2 / V3 功能只记录不实现。
- CDP 选择器 / 流程 / 配置 schema 变化,必须同步更新 `docs/04-architecture.md` 与相关任务。
- **新任务一任务一文件写进 `docs/tasks/T-<编号>.md`,不再手改 `docs/06-tasks.md`**(已冻结为 T-000~T-549 历史归档);命名/frontmatter/领取规则见 `docs/tasks/README.md`。为避免多 agent 并发抢改同一文件、ID 撞号。
- 改完后更新对应任务文件状态、追加 `progress.md`、覆盖 `docs/current-state.md`。
- 改完后**只更新对应任务文件**:把状态改 `DONE`、执行记录写进该任务文件的 `## 执行记录` 一节。**不再逐任务追加 `progress.md`、不再逐任务覆盖 `docs/current-state.md`**(这两个是每任务共享写入点,多 agent 并发会互相抢/覆盖)。`progress.md` 冻结为历史归档;`docs/current-state.md` 不再手动逐任务维护,当前状态以 `docs/tasks/` 各任务 frontmatter 为准,后续可由脚本汇总生成。
## 安全红线
+4 -2
View File
@@ -1,7 +1,9 @@
# 当前实现状态
> 本文是可覆盖的当前快照,记录代码与任务看板的现实状态。
> 历史执行流水追加到 [`../progress.md`](../progress.md),不在本文重复完整日志。
> **⚠️ 本文不再逐任务手动覆盖维护**(每任务全量重写是多 agent 并发的重抢占点)。当前任务状态**以 `docs/tasks/` 各任务文件的 frontmatter(status/phase/deps)为准**;本文保留为阶段性快照,后续可由脚本从任务文件汇总生成。约定见 [`tasks/README.md`](tasks/README.md)。
>
> 本文是阶段性快照,记录代码与任务的现实状态。
> 历史执行流水见 [`../progress.md`](../progress.md)(已冻结归档);新任务执行记录在各自任务文件的 `## 执行记录`。
## 当前快照
+2 -1
View File
@@ -42,7 +42,8 @@ created: 2026-07-08
## 状态与领取流程(同 `../06-tasks.md`「使用规则」)
- 状态:`TODO` · `DOING`(同一时间最多 1 个)· `DONE` · `BLOCKED`。
- 一次只领一个 `status: TODO` 且依赖全 `DONE` 的任务,取编号最靠前的;做完自测、改 `status: DONE`、追加 `../../progress.md`、覆盖 `../current-state.md`。
- 一次只领一个 `status: TODO` 且依赖全 `DONE` 的任务,取编号最靠前的;做完自测、改 `status: DONE`。
- **执行记录写进本任务文件的 `## 执行记录` 一节**(改了什么、跑了什么验证、结果、决策)——**不再逐任务追加 `../../progress.md`、不再逐任务覆盖 `../current-state.md`**(那两个是每任务共享写入点,多 agent 会抢/覆盖;`progress.md` 已冻结归档,`current-state.md` 不再手动逐任务维护、当前状态以各任务 frontmatter 为准)。
- **只改自己那个任务文件**;不要编辑别人正在做的任务文件。
## 看板视图
+5
View File
@@ -22,3 +22,8 @@ created: 2026-07-08
## 边界(不改什么)
(明确不碰的模块/流程:DB schema、CDP/Shopee、Excel 等)
## 执行记录
(做完在这里写:改了什么文件、跑了什么验证命令及结果、遇到的阻塞、关键决策。
取代逐任务追加 `progress.md`——执行记录只写进本任务文件,避免多 agent 抢改共享文件。)
+2
View File
@@ -1,5 +1,7 @@
# 执行进度记录
> **⚠️ 本文件已冻结为历史归档,不再逐任务追加。** 新任务的执行记录写进各自的任务文件 `docs/tasks/T-<编号>.md` 的 `## 执行记录` 一节——避免多 agent 并发抢改本共享文件。约定见 [`docs/tasks/README.md`](docs/tasks/README.md)。
>
> 本文件是只追加的历史流水,记录任务执行过程、验证命令、阻塞点和关键决策。
> 当前目录、当前命令、下一个可领取任务等可覆盖快照,写入 [`docs/current-state.md`](docs/current-state.md)。
> 历史条目里的“下一步”只代表当时判断,不作为当前任务领取依据;当前任务必须按 [`docs/06-tasks.md`](docs/06-tasks.md) 的顺序与 [`docs/current-state.md`](docs/current-state.md) 的快照执行。