多个 agent 并发时抢改单一看板/进度文件会导致读到旧版本、ID 撞号、合并冲突。 新增 docs/tasks/(README 约定 + _template):一任务一文件、frontmatter、防撞号、 执行记录写进任务文件、不逐任务改共享收尾文件。method-map 增对应失败模式行; 06-tasks/00-ai-start-here 加多 agent 分支;README/docs/README 登记;tasks.md 记 H-407。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
4.2 KiB
4.2 KiB
任务看板(Tasks)
把 MVP 拆成小步、可独立交付的任务,让 AI 一步一步开发,避免一次生成整个项目。
使用规则
- 一次只做一个任务:每轮只领取一个状态为
TODO、且依赖均已DONE的任务,取最靠前的那个。 - 做完即停:完成该任务、自测通过、把状态改成
DONE后,停下来汇报。 - 不跳步:依赖未完成的任务不能开工。
- 完成定义:以 编码规则 的验证清单为准。
- passing 需证据:标记
DONE前,必须在../progress.md记录跑过的验证命令和结果作为证据;只有"代码已写"而没有可运行证据,不得标DONE。验收要点要写成可执行、可观察的步骤,不写"应该能用"这类无法验证的描述。 - 动手前先读
00-ai-start-here.md、05-coding-rules.md和current-state.md。 - 完成后把任务状态同步到本文,把执行记录追加到
../progress.md,覆盖更新current-state.md,并过一遍clean-state-checklist.md。
多 agent / 并发协作:当多个 agent(或人 + agent)并发在同一仓库工作时,单文件看板会被抢改(读到旧版本、ID 撞号、合并冲突)。此时改用 一任务一文件
tasks/README.md(docs/tasks/T-<编号>.md):新任务只进docs/tasks/、执行记录写进各自任务文件的## 执行记录、不再逐任务追加progress.md/覆盖current-state.md;本单文件看板转为历史归档。单 agent / 小项目继续用本文即可。
如新项目希望任务看板放在根目录,可把本文复制或改名为根目录 tasks.md,并同步更新 README.md、docs/README.md、00-ai-start-here.md 和 current-state.md 的链接。
状态图例
TODO 待开始 · DOING 进行中(同一时间最多 1 个)· DONE 已完成并验收 · BLOCKED 受阻(注明原因)
Phase 0 · 地基
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|---|---|---|---|---|
| T-001 | 初始化项目骨架 | - | 依赖安装成功;本地能启动;首页 / 入口可访问;用真实可运行命令替换 00-ai-start-here.md、03-tech-stack.md、05-coding-rules.md、current-state.md 中的占位验证命令 |
TODO |
| T-002 | 建立基础目录和配置 | T-001 | 目录结构符合 04-architecture.md;配置不含密钥 |
TODO |
| T-003 | 加入最小测试 / 构建检查 | T-001 | 测试命令和构建命令可运行 | TODO |
Phase 1 · 最高风险验证
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|---|---|---|---|---|
| T-101 | 验证最高风险功能原型 | T-001 | 用最小输入跑通核心难点,结论写入文档 | TODO |
| T-102 | 把原型接入正式结构 | T-101 | 代码进入约定模块,测试覆盖关键路径 | TODO |
Phase 2 · 核心用户流程
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|---|---|---|---|---|
| T-201 | 实现核心页面 / 入口 | T-102 | 用户能进入主流程第一步 | TODO |
| T-202 | 实现核心动作 | T-201 | 用户能完成 MVP 最关键动作 | TODO |
| T-203 | 实现结果展示 / 状态反馈 | T-202 | 用户能看到保存、提交或处理结果 | TODO |
Phase 3 · 数据与账号
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|---|---|---|---|---|
| T-301 | 建立数据模型 / 迁移 | T-202 | 表结构符合 04-architecture.md |
TODO |
| T-302 | 实现鉴权 / 权限边界 | T-301 | 未授权访问被拒绝;授权后可访问 | TODO |
| T-303 | 实现数据持久化 | T-302 | 刷新 / 重进后数据仍在 | TODO |
Phase 4 · 收尾与发布
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|---|---|---|---|---|
| T-401 | 完整验收 MVP | T-303 | 02-requirements.md 的 P0 验收全部通过 |
TODO |
| T-402 | 部署 / 打包 / 运行文档 | T-401 | 新环境可按文档运行 | TODO |
里程碑
- M1:最小可运行地基完成。
- M2:最高风险功能已验证。
- M3:MVP 核心闭环完成。
- M4:可交付 / 可部署。
待办池(Backlog)
- 【V2 功能 1】
- 【V2 功能 2】
- 【优化项】