任务文件
默认一任务一文件：
docs/tasks/T-<编号>.md。路线图只负责建议拆分，不跟踪状态。
命名和状态
- 文件名：
T-001.md；细分任务可使用T-001a.md。 - 状态：
TODO、DOING、DONE、BLOCKED。 - 路线图已有编号时沿用；新编号不能覆盖已存在文件。
_template.md不是任务。
领取规则
- 每个 agent 同时最多一个
DOING任务。 - 领取编号最小、状态为
TODO、依赖全部DONE的任务。 - 开工前写清
write_paths；和其他活跃任务有路径重叠时不得并行。 - 仓库启用 Git 后记录默认分支头
context_ref和工作分支；未启用时保持null。 - 状态改为
DOING后再修改生产代码。 - 验收全部有证据后改为
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只记录项目级大事记。