cmroubao/docs/tasks/README.md

任务文件

默认一任务一文件：docs/tasks/T-<编号>.md。路线图只负责建议拆分，不跟踪状态。

命名和状态

• 文件名：T-001.md；细分任务可使用 T-001a.md。
• 状态：TODO、DOING、DONE、BLOCKED。
• 路线图已有编号时沿用；新编号不能覆盖已存在文件。
• _template.md 不是任务。

领取规则

1. 每个 agent 同时最多一个 DOING 任务。
2. 领取编号最小、状态为 TODO、依赖全部 DONE 的任务。
3. 开工前写清 write_paths；和其他活跃任务有路径重叠时不得并行。
4. 仓库启用 Git 后记录默认分支头 context_ref 和工作分支；未启用时保持 null。
5. 状态改为 DOING 后再修改生产代码。
6. 验收全部有证据后改为 DONE；无法继续时标 BLOCKED 并写清所需外部输入。

任务文件结构

---
id: T-101
title: 一句话任务名
phase: 1
deps: [T-001]
status: TODO
created: 2026-07-25
context_ref: null
work_branch: null
write_paths:
  - docs/tasks/T-101.md
  - android-buyer/path/**
---

正文必须包含：

• 问题/背景
• 关联需求与交互
• 方案
• 验收要点
• 边界
• 执行记录

验证证据

执行记录至少写：

• 修改的文件。
• 实际运行的完整命令。
• 结果是成功、失败还是未运行。
• Android smoke 的设备、Android、App 和拼多多版本。
• 未验证范围和 blocker。
• 涉及自动化时的安全停止证据。

“代码写完”“看起来可以”不能作为 DONE 证据。

UI 和高风险任务

• P0 UI 首次实现前应有 docs/design/ 原型并对齐 US/IX。
• 拼多多真实自动化任务必须在受控测试账号和设备进行。
• 验证码、风控、支付或未知页面只验证“能够识别并停止”，不验证绕过。
• 任何扩大候选数量、提交订单或支付的任务，必须先更新需求并完成单独评审。

共享文档

• 单任务执行记录只改自己的任务文件。
• 启动命令、目录或 blocker 变化时可以同步 current-state.md。
• 需求、架构或 API 事实变化时，任务 write_paths 必须提前列出对应文档。
• progress.md 只记录项目级大事记。