用途:把模糊想法、功能请求或“我想做 X”转化为明确的 spec,输出到 docs/features/YYYYMMDD-<name>/01-spec.md 并需用户批准,完成后调用 define-workflow-spec。需求已清晰或仅属打字错误、单行修复等琐碎变更时不适用。
主要能力:5W1H 结构化澄清,逐一提问,覆盖问题/背景、目标用户、成功标准、产物类型(artifact_type,默认 software)、约束、上下文;提问前先用 Glob/Grep/Read 扫描项目上下文。External Scan 判断是否检索外部世界,输出分层为 Fact / Pattern / Inference / Unknown / Adopt / Reject,搜索内容不直接变需求,超过 30 天标记 [可能过时]。Scout Army 按产物类型分派 refine-ceo-scout、refine-eng-scout、refine-design-scout、refine-content-scout,反馈分 Blocking / Important / Suggestion。Pressure Test 提出 2-3 种方案,检验用户价值、可行性与差异化,并明示隐藏假设。
流程:Phase 1 理解与探索,含上下文探索、Scope 检查、Goal Review(10-12 accepted;7-9 needs-refinement;0-6 blocked)、5W1H 澄清、External Scan、Scout Army;Phase 2 方案与收敛;Phase 3 产出 one-pager spec,其中“不做清单”是重要部分。验证失败时按方向被拒、无法收敛、假设被推翻、发现已有方案、范围暴增等情况回到相应阶段或调整。
限制:前置加载 CANON.md,辅助参考 refine-artifacts.md;External Scan 由 subagent 执行时须 read-only,返回不超过 1200 字,禁止原始搜索结果与长引用;未被选中的 scout 不产出占位反馈;用户批准前不得写代码或调用实现技能。具体模板与评分表见 refine-artifacts.md。