用途 sdd 即 Subagent Driven Development，通过任务工具协调实现与评审。编排者负责就绪判断、依赖决策和纠错循环；子代理按各自提示词中的分配进行调查、实现和评审。
主要能力 该包只提供以下编排工具：
- TaskCreate 接受 { text }，创建状态为 pending 的任务。
- TaskUpdate 接受 { id, text?, status? }，状态值为 pending、active、completed。
- TaskList 接受 {}，返回当前会话的全部任务。
- TaskGet 接受 { id }，返回当前会话中的一个任务。
- TaskClear 接受 {}，仅当所有任务完成时才清空会话列表，需先归档列表。
- Agent 接受 { tasks: [{ agent, title, task }] }，等待所有被接受的子项结束，再按请求顺序返回每个被接受项的最终结果。单批最多八项。内置 agent 值均为小写：scout、oracle、worker、reviewer。 任务对象只应使用这些工具提供的字段；角色、依赖、范围与证据信息写入任务的 text，不新增任务字段，也不自行发明调度器或结构化依赖 API。
使用方式
- 框定工作：提取目标、验收标准、约束、相关文件、复现步骤、明确排除项和所需验证命令，并冻结规格/计划参考内容（存在时含版本）、纳入的要求与检查、明确规则与排除项、任务拥有的文件范围。冻结基础的任何变更需用户批准。创建任务前调用 TaskList，记录会话是否已有无关任务，不清除这些任务。派发 Worker 前记录仓库变更基线（已跟踪与未跟踪状态及相关差异），以便归属变更；无法区分时记录歧义，不猜测。
- 需要时调查：代码归属、执行流、文档或受影响文件不清晰时使用 Scout 任务（只读提问）；仅当存在重要设计、安全、数据完整性或竞争根因决策未决时使用 Oracle 任务。
- 派发就绪工作：按任务文本与已完成证据重新计算就绪状态，超过八项拆分为多批，每批最多八项；派发前立即标记 active，未发送的工作不得标为 active。每个 Agent 项使用任务角色的小写 agent 值、简洁标题和自包含提示词。批内结果按批次位置映射到任务，不通过独立标识符匹配。格式错误或超限项退回 pending 并记录原因，修正前不得重试未变更项。
- 处理返回结果：对照验收标准与必需检查审查报告；子代理正常退出仅为过程证据，不等于任务成功。评审发现只保留可执行的：基于冻结原始需求、适用显式仓库规则或可证明回归，并给出位置、触发、证据和依据；拒绝新需求、重构提案、推测性加固和实施偏好。要求一份完整的初始评审报告覆盖全部同意归属的 worker 变更集和每条验收标准/检查。每个被接受发现分配稳定 ID 并在任务文本台账中保留状态与证据。验证评审仅在单一纠错批次之后进行，须引用初始评审报告、被接受 ID 的状态与证据、纠正前快照和仅纠正的归属增量，不得重复全量初始评审。对后续验证评审发现按来源分类：纠正导致的回归仅在既有一次自动纠正批次限额内可处理；初始评审遗漏的缺陷需说明并升级，不自动新增纠错任务；偏好或新需求视为非发现且不阻塞。
- 完成与纠错：仅当过滤后评估支持通过、所有适用检查通过、无阻塞项/被接受发现/范围问题/缺失证据时，才标记任务完成。对失败 Reviewer，退回 pending 并创建对应纠正 Worker 或重置未派发的纠正 Worker，将原需求、范围、验收标准、验证命令、先前报告与证据、过滤后可执行发现、失败检查、阻塞项、触发路径和纠正写入其文本与提示词。每个原 Worker 分配仅允许一次自动纠正批次，派发前在任务文本中记录该额度已消耗；新任务 ID 或恢复编排不重置额度，之后出现失败需升级用户。
- 报告：回复前调用 TaskList 使状态与实际一致，未完成工作保持 pending 并附证据。评审门通过且本轮所有任务完成后，在 docs/context-engineering/<subject>/ 下保存 tasks.md（记录每个任务标识、角色、最终状态、分配、结果、验证结果与评审结论；追加时保留旧内容），读取确认后，仅当会话列表只含本轮任务时调用 TaskClear 并确认 TaskList 为空。
关键约束 任务文本和代理提示词中保留原始需求；每个 Agent 项给出自包含标题和任务提示词；Worker 用于实现、Reviewer 用于独立验证，二者必需；独立工作并行，共享写作用域或可变验证的任务串行化；除非用户明确要求，不提交、推送、创建分支或开 PR；保留无关的用户变更；不得把未完成工作当作已完成归档或清除。
适用场景 适合需要多子代理协作的复杂开发任务：按任务追踪实现与评审、并行派发独立工作、独立复核变更、以证据驱动完成判断。
限制 仅提供上述六个编排工具，agent 值限定为 scout、oracle、worker、reviewer；单批最多八项；每个 Worker 只有一次自动纠正批次；定价、平台支持等信息暂未提供。