/dr-do 命令 — 测试先行的实现
了解 /dr-do 如何遵循严格的 TDD 循环、处理实现过程中的发现、在每次提交前强制执行网络暴露门禁,并让任务描述文件与实际构建内容保持同步。
规划在实现开始时结束。/dr-do 命令是 Datarim 的开发者代理将计划、设计文档和操作员简报转化为可运行代码的地方。核心纪律是测试驱动开发:先编写测试,测试失败,再编写代码使其通过,然后重复这一循环。
在编写任何一行代码之前,该命令会为 Level 3 和 Level 4 任务运行预检。这会验证实现计划是否存在、所需的设计文档是否就位、依赖项是否可用,以及项目在当前状态下能否干净地构建。在损坏的基础上开始实现会成倍增加后续每一步的成本。
它的作用
该命令核心的 TDD 循环在方法或桩级别运作。每个单元在任何实现代码之前都会先编写测试。测试失败——确认它确实在测试某些东西——然后编写实现以达到通过。无论变更大小,这一模式都适用,因为它是以最低成本捕获最多缺陷的模式。
在实现过程中,该命令可能会遇到缺口:无法解析的导入、行为与文档不符的 API、依赖项中缺失的功能。当出现缺口时,缺口发现协议会启动一个研究员代理,查找具体问题并将发现追加到该任务的洞察文件中。如果缺口是根本性的——错误的栈选择或不可能的需求——实现会停止,并建议使用 /dr-prd 修订需求。否则,实现会在更新后的上下文中继续。
在每次涉及网络配置的提交之前——例如 Docker Compose 端口映射、Redis 或 PostgreSQL 配置,或 systemd socket 文件——网络暴露门禁都会运行。它检查新的监听器是否绑定到回环或 Tailscale 地址,而不是公共接口。该门禁是故障关闭的:缺失或格式错误的配置被视为违规,而不是通过。
一个具体示例
一个实现处理发票生成的后台任务的任务遵循以下流程。预检确认队列库已安装且数据库可访问。第一个测试验证在队列中创建的任务会以 status: pending 出现在数据库中——测试失败,表尚不存在。编写迁移,测试通过。第二个测试验证 worker 会拾取该任务并更新其状态——测试失败,worker 未实现。编写 worker,测试通过。出现一个缺口:用于投递的电子邮件客户端 API 与文档所示不同。研究员代理确认当前 SDK 版本并更新洞察文件。实现使用修正后的 API 调用继续。该提交不涉及任何网络配置,因此跳过暴露门禁。
它在流水线中的位置
该命令在 /dr-plan 和 /dr-design(如适用)之后运行。当转换检查点中的所有检查都通过时——实现完成、测试通过、无已知回归、任务描述已更新——流水线会将 Level 3 和 Level 4 任务路由到 /dr-qa,或将较简单的任务直接路由到归档。
任务描述文件在整个实现过程中都会更新。进度说明、编码过程中做出的设计决策,以及任何发现的缺口都会记录在那里。描述文件是 /dr-qa 理解所构建内容的方式,而无需重新阅读整个 git 历史。而当 /dr-qa(带有 BLOCKED)或 /dr-compliance(带有 NON-COMPLIANT)将任务路由回 /dr-do 时,步骤 3b(单次迭代批量修复) 会摄取完整的带编号 Consolidated Remediation Batch([QA-BATCH-1..N] / [COMP-BATCH-1..M]),修复 100% 的已报告项,并在单次返工迭代中本地重新验证每个失败的检查/测试。
查看 Datarim 是什么 了解完整流水线全貌,或继续阅读 /dr-qa 命令,它根据上游产生的每个工件验证实现。