用途:为新功能做发现、调研与架构设计,产出一份持续更新的 spec.md,覆盖现状、要构建的内容及其契合方式,需人工批准后再进入规划。
主要能力:按五步推进。一是定位,静默阅读 AGENTS.md、README、架构文档,扫描 docs/specs/ 中既有规格与近期工作;二是发现,在需求不清时逐个提问(问题、用户、当前做法、成功标准、集成对象、约束),需求已明确则跳过;三是调研,深入阅读相关代码实现、边界情况、错误处理、数据流与测试,把发现写入 spec.md;四是设计,经批准后用 Skill 工具调用 oracle-architect 做组件设计、领域建模与分层边界,spec.md 包含问题、范围、用户故事、约束、上下文、架构、API 设计、数据模型、权衡与开放问题;五是批注,人工可直接在 spec.md 上批注,需逐条处理并更新,可能重复 1-6 次。
使用方式:产物路径为 docs/specs/YYYY-MM-DD-<feature-name>/spec.md,需求内联其中,无需单独的 requirements.json。每步结束需停下等待人工确认或审阅;批准后交接给 spec-plan,若规划暴露设计缺陷则回到调研。
限制:未获明确批准不得开始规划,也不得编写代码。资料未提供安装命令、收费、平台与效果等信息。