命令 Pipeline

/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

功能说明

  1. 任务解析 — 应用任务解析规则确定要实现的任务(来自参数,或在多个任务活跃时进行消歧)。
  2. 加载质量规则 — 读取 ai-quality.md 并应用 TDD、桩代码、认知负荷限制和代码简洁性规则。
  3. 读取计划 — 从 datarim/tasks.md 加载已解析任务的实现计划。
  4. 预检(仅 L3-L4)— 验证计划文档完整、所需设计文档存在、依赖可用,并且项目在当前状态下可构建。
  5. TDD 循环 — 对每个计划变更:编写失败测试,实现最小代码使其通过,必要时重构。一次一个桩或方法,每步后对变更文件运行项目 linter。
  6. 遵循模式 — 遵循 datarim/history/patterns.md 和 datarim/style-guide.md,与现有代码保持一致。
  7. 缺口发现(步骤 7.5) — 当遇到未知项(导入失败、意外的 API 行为、文档不匹配)时,启动研究者智能体调查具体缺口。发现结果追加到 datarim/insights/INSIGHTS-{task-id}.md。根本性缺口(技术选型错误、需求不可行)会停止实现并建议返回 /dr-prd。
  8. 更新任务笔记 — 在 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。