2026年8月27日

子代理驱动开发技能——每个任务使用全新上下文

Datarim 的 subagent-driven-development 技能如何通过为每个任务分派一个隔离的代理来执行实现计划,依次运行规范符合性审查和代码质量审查,并且从不中途停下来询问进度更新。

当代理在单个会话中运行一个漫长的实现计划时,上下文会不断累积。早期任务的细节会与后续任务混杂在一起,代理在第五个任务中的决策会受到第一到第四个任务噪音的影响。subagent-driven-development 技能通过为每个任务分派一个全新的、隔离的代理,并只向它传递恰好所需的上下文——不多不少——来解决这个问题。

该技能适用于以下情况:存在一个现成的实现计划,计划中的任务彼此基本独立,并且运行时支持隔离代理分派。当这些条件满足时,它在质量和速度上都优于内联的单会话执行——质量更高是因为每个代理都从干净状态开始,速度更快是因为控制器不会在任务之间停下来报告进度。

逐任务循环

在分派任何任务之前,控制器会完整读取一次计划文件,提取所有任务及其完整文本和周边上下文,并构建一个工作跟踪器。这种预先提取是有意为之的:实现者代理绝不能自己重新读取计划文件,因为直接提供完整文本更快,并且能避免上下文污染。

每个任务都遵循相同的循环。分派一个实现者代理,并附带任务文本、场景设定上下文以及来自 ./implementer-prompt.md 的提示模板。如果实现者在开始前提出问题——这是正确的行为——控制器会先回答这些问题,然后才允许工作继续。实现者负责实现、测试、自我审查并提交。然后分派一个规范符合性审查者。只有在审查者确认符合规范之后,代码质量审查者才会运行。两项审查都必须通过,任务才能标记为完成。颠倒顺序——在规范符合性之前运行代码质量——在该技能中被明确标记为危险信号。

处理实现者状态

实现者代理会返回四种状态之一。DONE 进入审查。DONE_WITH_CONCERNS 同样进入审查,但控制器会先阅读这些顾虑:关于正确性或范围的顾虑会在审查前处理,而关于文件大小或风格的观察则记录并传递下去。NEEDS_CONTEXT 意味着控制器提供缺失的信息并重新分派同一个代理。BLOCKED 要求控制器评估阻塞因素——如果是上下文问题,提供更多上下文;如果是推理问题,用更强的模型重新分派;如果任务太大,将其拆分;如果计划本身有误,升级给人类。

该技能明确禁止忽略升级请求或在没有任何更改的情况下重试同一个模型。一个报告说自己卡住的实现者说的是实话。

模型选择

该技能规定按角色和任务复杂度来选择模型,而不是在所有地方都默认使用最强的模型。机械性实现任务——具有完整规范、涉及一两个文件的孤立函数——使用最便宜的模型。协调多个文件的集成任务使用标准模型。架构、设计和审查任务使用可用的最强模型。这使得执行完整计划的成本与每个任务实际需要的资源成正比。

计划结束时

在所有任务标记为完成后,一个最终的代码审查者代理会在整个实现分支上运行。这一最终检查能捕捉逐任务审查者在隔离状态下无法看到的跨任务问题——共享接口漂移、错误处理模式不一致,或者范围在多个任务之间蔓延却没有超过任何单个任务的阈值。然后该分支进入 finishing-a-development-branch 技能。

该技能是四个必需的工作流技能之一。它依赖 using-git-worktrees 提供隔离工作区,依赖 writing-plans 提供它所执行的计划,并依赖 requesting-code-review 提供审查者提示模板。当运行时无法生成隔离代理时,回退方案是 executing-plans 技能,它在单线程中内联运行。

阅读Datarim 是什么了解整体流水线背景,或查看stage-snapshot-writer 技能了解检查点如何在该技能所接入的流水线阶段之间持久化。