74 lines
2.2 KiB
Markdown
74 lines
2.2 KiB
Markdown
|
# 任务文件
|
||
|
|
|
||
|
|
> 默认一任务一文件：`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` 并写清所需外部输入。
|
||
|
|
|
||
|
|
## 任务文件结构
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
---
|
||
|
|
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` 只记录项目级大事记。
|