diff --git a/docs/00-ai-start-here.md b/docs/00-ai-start-here.md index 79c1a76..0d3bb9b 100644 --- a/docs/00-ai-start-here.md +++ b/docs/00-ai-start-here.md @@ -43,13 +43,13 @@ ## 领取任务规则 -从 [`06-tasks.md`](06-tasks.md) 领取任务时: +从 [`tasks/`](tasks/)(一任务一文件 `docs/tasks/T-<编号>.md`,约定见 [`tasks/README.md`](tasks/README.md))领取任务时;[`06-tasks.md`](06-tasks.md) 已冻结为 T-000~T-549 历史归档、不再新增: -- 只领取第一个状态为 `TODO` 且依赖均为 `DONE` 的任务。 -- 开始前把该任务状态改为 `DOING`。 +- 只领取第一个状态为 `TODO` 且依赖均为 `DONE` 的任务文件。 +- 开始前把该任务文件 frontmatter 的 `status` 改为 `DOING`。 - 本轮只完成这一个任务。 -- 验收通过后把状态改为 `DONE`。 -- 完成后把执行记录追加到 [`../progress.md`](../progress.md),覆盖更新 [`current-state.md`](current-state.md)。 +- 验收通过后把 `status` 改为 `DONE`。 +- **完成后把执行记录写进该任务文件的 `## 执行记录` 一节**;**不再逐任务追加 [`../progress.md`](../progress.md)(已冻结归档)、不再逐任务覆盖 [`current-state.md`](current-state.md)**(那两个是每任务共享写入点,多 agent 并发会抢/覆盖)。 - 做完即停,汇报验证结果,等待下一步指令。 如果代码实际状态和任务看板冲突,先说明冲突,不要擅自跳步。 diff --git a/docs/06-tasks.md b/docs/06-tasks.md index 196315b..ba59c1e 100644 --- a/docs/06-tasks.md +++ b/docs/06-tasks.md @@ -6,14 +6,14 @@ ## 使用规则 +> 下列规则为历史记录。**新任务的领取/完成流程以 [`tasks/README.md`](tasks/README.md) 为准**——一任务一文件、执行记录写进任务文件、不再追加 `progress.md`/覆盖 `current-state.md`。本文件(T-000~T-549)已冻结,仅在订正历史任务状态时才改。 + 1. **一次只做一个任务**:每轮只领取一个 `TODO` 且依赖均 `DONE` 的任务,取最靠前的。 2. **做完即停**:完成、自测通过、改 `DONE` 后汇报。 3. **不跳步**:依赖未完成不开工。 4. **完成定义**:以 [编码规则](05-coding-rules.md) 验证清单为准。 -5. **动手前**读 `00-ai-start-here.md`、`05-coding-rules.md`、`current-state.md`、`04-architecture.md`(尤其第七节已验证事实、第二节流水线)。 -6. **完成后**同步本文状态,追加 [`../progress.md`](../progress.md),覆盖 [`current-state.md`](current-state.md)。 - -`current-state.md` 只记录按以上规则计算出的当前快照;如果它和本文任务顺序/状态冲突,以本文为准并先修正文档。 +5. **动手前**读 `00-ai-start-here.md`、`05-coding-rules.md`、`04-architecture.md`(尤其第七节已验证事实、第二节流水线)。 +6. **完成后**(新流程)把状态改 `DONE`、执行记录写进任务文件的 `## 执行记录`;不再逐任务追加 `progress.md`、覆盖 `current-state.md`。 ## 状态图例