/dr-do
基于 TDD 的实现,包含缺口发现,以及对 QA/合规发现项的单轮批量修复
概述
/dr-do 是执行阶段。开发者智能体解析目标任务,从 tasks.md 获取实现计划,并严格按 TDD 构建:先写测试,观察其失败,再写代码,观察其通过。每个方法保持在 50 行以内,每个作用域保持在 7-9 个对象以内。当智能体遇到未知项(导入失败、意外的 API 行为)时,缺口发现(步骤 7.5)会自动启动一个研究者智能体进行调查,而不会中断实现流程。当在 BLOCKED 的 /dr-qa 或 NON-COMPLIANT 的 /dr-compliance 判定后重新进入时,步骤 3b(单轮批量修复)会接收完整的 Consolidated Remediation Batch([QA-BATCH-1..N] / [COMP-BATCH-1..M]),修复 100% 的已报告项,并在返回验证前本地重新运行所有失败的关卡/测试,一次通过。
用法
/dr-do
功能说明
- 任务解析 — 应用任务解析规则确定要实现的任务(来自参数,或在多个任务活跃时进行消歧)。
- 加载质量规则 — 读取
ai-quality.md并应用 TDD、桩代码、认知负荷限制和代码简洁性规则。 - 读取计划 — 从
datarim/tasks.md加载已解析任务的实现计划。 - 预检(仅 L3-L4)— 验证计划文档完整、所需设计文档存在、依赖可用,并且项目在当前状态下可构建。
- TDD 循环 — 对每个计划变更:编写失败测试,实现最小代码使其通过,必要时重构。一次一个桩或方法,每步后对变更文件运行项目 linter。
- 遵循模式 — 遵循
datarim/history/patterns.md和datarim/style-guide.md,与现有代码保持一致。 - 缺口发现(步骤 7.5) — 当遇到未知项(导入失败、意外的 API 行为、文档不匹配)时,启动研究者智能体调查具体缺口。发现结果追加到
datarim/insights/INSIGHTS-{task-id}.md。根本性缺口(技术选型错误、需求不可行)会停止实现并建议返回/dr-prd。 - 更新任务笔记 — 在
datarim/tasks/{TASK-ID}-task-description.md§ 实现笔记中记录实现日志。已废弃的progress.md不再写入。
评审反馈处理
当自动代码评审或人工评审返回发现项时,每个发现项都会被分类并处理:
- 严重 / 阻塞 — 在当前 MR 中合并前修复。不可协商。
- 成本低且严格更优的警告 / 建议(1-5 行,无新抽象,无范围变更)— 在当前 MR 中内联修复。例如:收紧字符串匹配、移除阻塞的
alert()、修正拼写错误、添加空值保护。 - 需要设计或跨文件的警告 / 建议 — 推迟到新的待办事项,并附具体触发条件(例如“部署后 14 天”或“当出现第二个消费者时”)。
- 拒绝 — 仅在有技术依据时,理由记录在 MR 讨论串中。
每个发现项的处理结果(修复 / 推迟 / 拒绝)都会记录在 MR 讨论串中,以便评审者看到其反馈已被处理。
参数
无。作用于当前活跃任务(通过任务解析确定)。
输出
项目中的代码变更。更新:datarim/tasks/{TASK-ID}-task-description.md(实现笔记)以及状态变更时 datarim/tasks.md 中任务的一行摘要。可能更新:datarim/backlog.md(推迟的评审发现项)。
质量规则
- 每个方法最多 50 行
- 同时作用域内最多 7-9 个对象
- 测试先于代码(TDD)
- 一次一个桩/方法
- 无回归 — 验证现有测试仍然通过
过渡检查点
继续之前:
- 所有计划变更已实现
- 测试已编写并通过
- 任务描述已更新实现笔记
- 每个验收标准都带有种子证据,由规范图关卡在
/dr-qa前检查 - 未引入已知回归
示例会话
> /dr-do
任务解析:<TASK-ID>(级别 3)
预检...
计划文档:OK
设计文档:OK(creative-<TASK-ID>-architecture.md)
依赖:OK(express、jsonwebtoken、bcrypt)
项目构建:OK
步骤 1/8:认证中间件
编写测试:auth.middleware.test.ts
测试失败(预期)
实现:auth.middleware.ts
测试通过
步骤 2/8:用户模型
编写测试:user.model.test.ts
...
进度:8/8 步骤完成
全部 14 个测试通过
已更新 datarim/tasks/<TASK-ID>-task-description.md(实现笔记)
下一步:/dr-qa(L3 任务)
相关命令
- /dr-plan — 上一阶段:规划
- /dr-design — 上一阶段:设计(L3-4)
- /dr-qa — L3-4 的下一阶段
- /dr-archive — L1-2 的下一阶段(反思作为步骤 0.5 运行)
报告结果
在面向人员的更新或结果之前,应用人类结果报告。说明用户可见的结果、原始条件、检查与证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持精确的协议和技术记录完整。如需在不继续工作的情况下再次解释,请使用 /dr-explain。