From cf507b711bd3964e61cefa727deb52dc41dc345d Mon Sep 17 00:00:00 2001 From: ila Date: Fri, 7 Aug 2026 16:37:18 +0800 Subject: [PATCH] docs: import wiki at afc651f75a3a --- Tasks.md | 76 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 Tasks.md diff --git a/Tasks.md b/Tasks.md new file mode 100644 index 0000000..e579a23 --- /dev/null +++ b/Tasks.md @@ -0,0 +1,76 @@ + +> 同步来源:[`docs/tasks/README.md`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/docs/tasks/README.md) · commit `afc651f75a3a` + +# 任务文件 + +> 默认一任务一文件:`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` 只记录项目级大事记。