用途:接手 brainstorm-beagle 产出的规格,关闭其剩余缺口,包括显式的 Open Questions 以及自审漏掉的潜在问题,产出可直接进入规划阶段的规格。不写代码、不搭脚手架、不做架构设计、不创建实施计划,只编辑规格文档;回答开放问题指给出 WHAT/WHY 及理由,而非 HOW。
主要能力:定位规格文件(用户给路径,或列出 docs/specs/ 最近修改的 3–5 个文件询问);提取缺口——显式缺口为 Open Questions 下每条要点,潜在缺口包括占位符(TBD、TODO)、含糊需求(fast、simple)、缺少理由的约束、矛盾、不可测试的成功标准、实现泄漏、无消费者的对外接口、未审视的上下游数据管道组合;先展示合并后的缺口清单供用户增删或推迟;每个缺口一个研究任务,按代码库模式、外部/API、设计权衡、范围/政策分类;有子代理则并行分发,否则按最省成本顺序串行;逐条提出建议(推荐答案、1–2 个被拒替代方案、证据 file:line 或 URL);就地重写规格,把决策迁移到 Key Decisions、Requirements、Constraints、Reference Points 等对应章节;随后按 ../brainstorm-beagle/references/spec-reviewer.md 自审并就地修复;最后询问是否提交,未获同意不提交。
限制:打开下一个缺口的提案前必须先有当前缺口的结果;不得静默丢弃开放问题,只能解决、迁移或标注 deferred 及理由;每条提案必须有证据;需用户输入的预算类问题应直接询问;无 Web 访问时外部类研究受限。