docs: move per-task progress into task files, stop per-task current-state overwrite
Tests / Python 3.11 / Windows (push) Has been cancelled
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:
co-authored by
Claude Opus 4.8
parent
3a552b1880
commit
4acac32b40
@@ -29,7 +29,7 @@
|
|||||||
- 只做当前任务范围内的事;T-504 已接入的多账号并行、dry-run、运行日志属于当前范围,其他 V2 / V3 功能只记录不实现。
|
- 只做当前任务范围内的事;T-504 已接入的多账号并行、dry-run、运行日志属于当前范围,其他 V2 / V3 功能只记录不实现。
|
||||||
- CDP 选择器 / 流程 / 配置 schema 变化,必须同步更新 `docs/04-architecture.md` 与相关任务。
|
- 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 撞号。
|
- **新任务一任务一文件写进 `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 为准,后续可由脚本汇总生成。
|
||||||
|
|
||||||
## 安全红线
|
## 安全红线
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1,9 @@
|
|||||||
# 当前实现状态
|
# 当前实现状态
|
||||||
|
|
||||||
> 本文是可覆盖的当前快照,记录代码与任务看板的现实状态。
|
> **⚠️ 本文不再逐任务手动覆盖维护**(每任务全量重写是多 agent 并发的重抢占点)。当前任务状态**以 `docs/tasks/` 各任务文件的 frontmatter(status/phase/deps)为准**;本文保留为阶段性快照,后续可由脚本从任务文件汇总生成。约定见 [`tasks/README.md`](tasks/README.md)。
|
||||||
> 历史执行流水追加到 [`../progress.md`](../progress.md),不在本文重复完整日志。
|
>
|
||||||
|
> 本文是阶段性快照,记录代码与任务的现实状态。
|
||||||
|
> 历史执行流水见 [`../progress.md`](../progress.md)(已冻结归档);新任务执行记录在各自任务文件的 `## 执行记录`。
|
||||||
|
|
||||||
## 当前快照
|
## 当前快照
|
||||||
|
|
||||||
|
|||||||
@@ -42,7 +42,8 @@ created: 2026-07-08
|
|||||||
## 状态与领取流程(同 `../06-tasks.md`「使用规则」)
|
## 状态与领取流程(同 `../06-tasks.md`「使用规则」)
|
||||||
|
|
||||||
- 状态:`TODO` · `DOING`(同一时间最多 1 个)· `DONE` · `BLOCKED`。
|
- 状态:`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 为准)。
|
||||||
- **只改自己那个任务文件**;不要编辑别人正在做的任务文件。
|
- **只改自己那个任务文件**;不要编辑别人正在做的任务文件。
|
||||||
|
|
||||||
## 看板视图
|
## 看板视图
|
||||||
|
|||||||
@@ -22,3 +22,8 @@ created: 2026-07-08
|
|||||||
## 边界(不改什么)
|
## 边界(不改什么)
|
||||||
|
|
||||||
(明确不碰的模块/流程:DB schema、CDP/Shopee、Excel 等)
|
(明确不碰的模块/流程:DB schema、CDP/Shopee、Excel 等)
|
||||||
|
|
||||||
|
## 执行记录
|
||||||
|
|
||||||
|
(做完在这里写:改了什么文件、跑了什么验证命令及结果、遇到的阻塞、关键决策。
|
||||||
|
取代逐任务追加 `progress.md`——执行记录只写进本任务文件,避免多 agent 抢改共享文件。)
|
||||||
|
|||||||
@@ -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/current-state.md`](docs/current-state.md)。
|
||||||
> 历史条目里的“下一步”只代表当时判断,不作为当前任务领取依据;当前任务必须按 [`docs/06-tasks.md`](docs/06-tasks.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) 的快照执行。
|
||||||
|
|||||||
Reference in New Issue
Block a user