x-dev — 统一执行
输入与边界
目标目录必须有 README.md 和 dev-checklist.md。README 的 risk:、验收 Scenario 与技术设计定义实现边界；dev-checklist 定义顺序与状态；dev-report 记录改动及 verify 证据。x-dev 消费 task，不创建需求包。
执行
- 阅读 README 的核心目标、涉及模块、架构拆分策略、技术设计、验收与自动化测试责任；模块段含 spec 引用时跟读对应模块文档。
- 运行
python3 tools/xdev.py status <task-dir> --json与graph <task-dir> --json。同优先级、无依赖、无同文件写冲突的 ready task 可并行；有依赖的 task 按拓扑序推进。 - 将当前 checklist 项更新为进行中，实现时保持 README 定义的公开契约、失败路径与范围。
- 每个
验证: autoScenario 在dev-report.md写一个 auto fencedverify块，用scenario:精确回指；补齐单元、契约和边界测试。manual Scenario 写步骤块。 - 实现完成后更新 checklist 为待测试，运行全部 verify 块声明的命令；通过后更新为测试通过。
- 运行
python3 tools/xdev.py verify <task-dir> --json：exit 2 修正 dev-report 格式；exit 1 将 fail 与 uncovered 一次交给 x-fix；exit 0 继续 risk 路由。 - Q0/Q1 输出完成回执及定级依据；Q2 调 x-qa-gate RC；Q3 调 x-qa-gate R1→R2→R3。Gate ② 全部通过后把 checklist 标为
[x] ✅。
状态与记录
状态顺序为 [ ] ⏳ → [ ] ▶️ → [ ] 🟡 → [x] 🟢 → [x] ✅；Gate ② 负责最终 ✅。reports/ 位于 task 根目录下，verify 或 qa-gate fail 依既有共享 fix-counter 交给 x-fix 批量修复。
完成回执
报告当前 task、完成项、修改文件、verify 结果、risk 路由、Gate ② 结果、manual 待验收项和遗留阻塞。连续模式在一个 task Gate 完成后按 graph 读取下一批 ready 项。