Menü
用于：用户明确要求按 OpenSpec / OPSX 分析需求、写 spec、做详细设计、写方案或方案文档、制定计划；或新功能、功能变更、流程变更、接口变更、数据模型变更、状态流转、角色流程、模块边界调整会改变对外行为；或同一请求包含设计与实现混合意图。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
| name | superpowers-openspec |
| description | 用于：用户明确要求按 OpenSpec / OPSX 分析需求、写 spec、做详细设计、写方案或方案文档、制定计划；或新功能、功能变更、流程变更、接口变更、数据模型变更、状态流转、角色流程、模块边界调整会改变对外行为；或同一请求包含设计与实现混合意图。 |
面向 OpenSpec 的方案、规范与计划工作流 skill。
职责：帮助用户把方案、规范和计划的阶段边界说清楚。需要业务评审或完整方案沉淀时，先写 docs/solutions/*.md，由用户确认后，再将已确认内容落到官方 OpenSpec / OPSX 工作流。
先判断当前阶段，再只推进下一步；不要把方案确认、OpenSpec 生成和实现落地混在一次响应里完成。
| 用户场景 | 当前阶段 | 下一步只做 | 暂不做 |
|---|---|---|---|
| 用户要求先写方案、方案文档、详细设计文档、业务评审材料，或要求确认后再生成 OpenSpec | 方案确认前 | 先写方案文档：创建或更新 docs/solutions/<主题>.md | 不创建 openspec/changes/，不写 OpenSpec artifact，不进入实现 |
| 用户明确要求不要方案文档，直接按 OpenSpec 走，且输入边界清楚 | OpenSpec 准备 | 直接进入 OpenSpec：选择唯一 /opsx:* 入口，并说明要生成或更新的 artifact | 不同时给多个命令，不跳到实现 |
用户已确认 docs/solutions/<主题>.md，并要求转成 OpenSpec | OpenSpec 转换 | 已确认方案转 OpenSpec：先输出方案提取摘要，再创建或更新 proposal.md、spec.md、design.md、tasks.md | 未确认事项未清空前，不直接生成完整 tasks.md |
| OpenSpec 规范已经完成，用户要求开发落地 | 实现准备 | 已完成规范进入实现：交给实现入口或 /opsx:apply 承接 | 不在本 skill 内继续写实现代码 |
按用户请求的动作决定本轮产出：
响应时必须明确：当前阶段是什么；本轮已完成或将执行什么；下一步只做什么。
以下内容以上游 OpenSpec / OPSX 为准，不由本 skill 重定义：
openspec/specs/ 与 openspec/changes/openspec init、openspec update 与 /opsx:*proposal.md、spec.md、design.md、tasks.md满足任一即触发：
不触发：
混合意图优先级：先判断是否涉及新功能、规则、接口、数据结构、状态或角色变化；如果是，优先进入 superpowers-openspec。帮我设计并实现短信发送功能、先沟通需求，再把功能做出来 都是带实现诉求的规范阶段入口。
核心边界：方案文档确认前不进 OpenSpec，规范完成前不进实现。
docs/solutions/*.md 是进入 OpenSpec 前的业务方案确认层；它不替代官方 artifact，但在用户需要完整方案、业务评审或先确认文档时，优先级高于 /opsx:propose、/opsx:ff 和其他 /opsx:*。docs/solutions/<主题>.md；用户确认前，不应创建或更新 OpenSpec change，不进入 /opsx:*。docs/solutions/references/<主题>-OpenSpec-拆分设计.md。proposal.md 必须靠前包含"来源方案文档"章节；多方案来源时全部列出，不新增 sources.md 或 source-docs.md。tasks.md，等待用户明确确认。references/planning-workflow.md，方案转 OpenSpec 流程见 references/solution-to-openspec-workflow.md。给出唯一推荐入口；完整映射见 references/intent-to-openspec-mapping.md。
| 场景 | 推荐入口 | 重点产物 |
|---|---|---|
| 直接按 OpenSpec 推进，输入完整 | /opsx:propose | proposal + spec + design + tasks |
| 输入零散或关键边界不清 | /opsx:explore | 先收敛假设、范围、待确认问题 |
| 已有方案但未确认 | 先 docs/solutions/*.md | 确认后再进 /opsx:* |
| 用户要求一次全出 | /opsx:ff | 全部 OpenSpec 产物 |
| 用户要求分步补齐 | /opsx:new + /opsx:continue | 逐步补齐 |
| 规范已完成，准备实现 | /opsx:apply | 进入实现入口 |
| 变更完成 | /opsx:archive | 归档 |
| 验证或同步 | /opsx:verify / /opsx:sync（profile 支持时） | 一致性检查或同步回主规范 |
docs/solutions/*.md、proposal.md、spec.md、design.md、tasks.md 的文档内容本身也必须使用中文。只有当用户明确要求其他语言时，才可以切换。design.md 的组成部分，不是独立强制文件；不要在明明需要图示时只给纯文字总结。/opsx:explore 收敛，或 /opsx:new + /opsx:continue 分步补齐。详细模板、示例和检查项见 references/spec-template.md、references/spec-checklist.md、references/output-example.md。
| 错误 | 正确做法 |
|---|---|
| 把 Mermaid 文件列为独立强制产物 | 图示放在 design.md 内 |
跳过 docs/solutions/*.md 直接生成 OpenSpec change | 先写方案文档，确认后再进 OpenSpec |
用户要业务评审材料时直接 /opsx:propose | 先生成可完整评审的 docs/solutions/<主题>.md |
| 未决项明显时仍给完整 tasks | 先 /opsx:explore 收敛 |
同时推荐多个 /opsx:* 不做取舍 | 给出唯一推荐命令 |
| 用"系统 / 数据 / 状态 / 事实"做主语描述行为 | 改写为 WHO + TRIGGER + OUTCOME |
| 用技术术语替代业务解释 | 先写业务人员能看懂的场景和系统处理，再补技术支撑；技术词本身可以保留 |
默认新增 unique_key / request_key / idempotency 字段 | 先判断业务字段或字段组合能否表达唯一性；不能覆盖请求级去重时再新增请求唯一键并说明原因 |
本 skill 完成以下事项后即停止：
source-notes.md / transcript.md停止后由 OpenSpec / OPSX 承接。各参考文件已在对应章节内引用，使用顺序见 references/skill-usage-sequence.md。