开发者 Agent —— 不走捷径的 TDD
Datarim 的开发者 Agent 如何以测试驱动的纪律实现功能、遵循项目自身的模式,并在交接前验证其工作。
AI 辅助编码中最常见的失败模式并非逻辑错误——而是正确的逻辑却忽略了代码库其余部分早已确立的约定。开发者 Agent 正是为避免这一点而构建:它在写下第一行代码之前先阅读项目的模式,并在编写代码之前先编写将要检验这些代码的测试。
该 Agent 负责 Datarim 任务的实现阶段。它的职责不是探索或审查——而是构建:正确地、一致地构建,并以人类工程师能认出这是他们自己代码库的方式构建。
它的职责
开发者遵循测试驱动循环。先编写测试,测试失败(红),然后实现使其通过(绿),接着快速重构清理刚刚添加的内容。这一节奏能在契约违规还很廉价时及早发现它们。
在编写任何内容之前,该 Agent 会阅读项目的活动上下文、任务定义,以及描述代码库结构的系统模式文件。风格漂移——使用与项目其余部分不同的命名约定、不同的错误处理模式、不同的抽象层——被视为缺陷,而非风格偏好。
对于 HTTP 集成,该 Agent 应用特定默认值:熔断器将 4xx 错误排除在失败计数之外(408 和 429 除外,它们确实表示下游压力),恢复事件会接入项目的事件中心,而非被静默丢弃。
一个具体示例
某任务新增一个调用外部支付 API 的端点。开发者首先编写一个测试,断言外部调用成功时该端点返回正确的结构,再编写第二个测试,断言调用超时时返回结构化错误。只有在这之后才进行实现。测试通过后,设计一致性检查会验证熔断器的恢复事件确实已接入——不仅是熔断器类存在,而是事件确实触发并到达事件中心。
它所在的位置
开发者运行于 /dr-do,即实现阶段。它将工作交接给 QA 层——在那里,测试者 Agent 运行完整测试套件,审查者依据完成定义进行验证。当在 BLOCKED QA 判定或 NON-COMPLIANT 合规判定后重新进入时,开发者执行单迭代批量修复:它接收完整的 Consolidated Remediation Batch([QA-BATCH-1..N] / [COMP-BATCH-1..M]),一次性修复 100% 的条目,并在返回验证之前本地重新运行每一个失败的关卡/测试。对于较简单的任务,路径直接进入归档;对于 L3-L4 复杂度,则经过完整的 QA 与合规循环。
在 开发者参考卡 上查看完整的 Agent 名册,或阅读 Datarim 是什么 以了解更宏观的图景。