用途:这是 OpenSpec 规范(spec)阶段的强制技能,在 /opsx-new 或 /opsx-continue 等触发时激活,目标是在设计前提升规范质量,或在已有设计时让需求与设计边界对齐。规范必须与已批准的 proposal 及已有 design 保持一致。
主要能力:按四阶段流程工作——Phase 0 解析 schema 与模板(运行 openspec instructions specs --change <name> --json,读取 openspec/.plus/config.yaml 的 settings.questionMode);Phase 1 交互式分析,含项目上下文、需求提取、完整性、歧义、边界用例、干系人视角与 Gherkin 场景;Phase 2 漂移检查;Phase 3 写入与自审。核心原则:描述“做什么”而非“怎么做”,每条需求可验证,暴露缺失需求,遵循 YAGNI,尊重项目规范文件(AGENTS.md、CLAUDE.md、GEMINI.md 等)。
使用方式:规范阶段默认不读源码;确需读代码时必须通过 explore 子代理,且只获取可观察行为。Phase 1 用 question 工具逐条提问(batch 模式可合并),每个问题附推荐答案;未完成 Phase 1、未通过写前对齐门、未运行自审子代理前,禁止写任何 spec 文件。写入时严格使用 Phase 0 的模板结构与 outputPath,场景须用大写 GIVEN/WHEN/THEN,AND/BUT 仅在自然时使用。
限制:该技能为刚性流程,跳过或合并阶段、在根上下文读代码、自行略过审查子代理均属违规;发现 proposal 或 design 不完整、矛盾时须停止并上报,不得用规范选择掩盖。审查子代理为单次派发,修复后不得重复派发。具体平台派发方式与配置细节以资料为准,其余未提供。