Menu
复杂后端：跨模块、架构变更或边界模糊，先探索再进入 OpenSpec。 仅当用户显式输入 /wf-complex 时使用；不要因“复杂需求、复杂后端、架构变更、跨模块”等自然语言自动触发。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
Debug/重构/单测：问题已知，无需新 spec，直接进入排查或实现。 仅当用户显式输入 /wf-debug 时使用；不要因“debug、修 bug、重构、补单测、测试”等自然语言自动触发。
工作流档位安装/切换/升级。AI 分析项目信号推荐档位，支持全新安装、档位切换和版本升级。 3 种模式：INSTALL（全新安装）/ SWITCH（切换档位）/ UPGRADE（升级模板版本）。 仅当用户显式输入 /wf-install 时使用；不要因“安装工作流、切换档位、install workflow”等自然语言自动触发。
产品/架构方案：还不确定是否值得做，先评估价值、范围和可行性。 仅当用户显式输入 /wf-plan 时使用；不要因“产品方案、架构方案、方案讨论、值不值得做”等自然语言自动触发。
小需求：功能点清晰、改动范围明确，走 OpenSpec 完整通道。 仅当用户显式输入 /wf-small 时使用；不要因“小需求、明确需求、新增字段、加指标”等自然语言自动触发。
卸载当前项目的工作流（OpenSpec 受控文件），保留全局 /wf-install 与你的 openspec 内容。 只操作当前项目目录，绝不触碰 $HOME。 仅当用户显式输入 /wf-uninstall 时使用；不要因“卸载、移除工作流、uninstall”等自然语言自动触发。
快速通道：文案、样式、明确 bug，跳过 gate，直接生成 proposal + tasks。 适用于 ≤3 文件、无架构/安全影响、意图无歧义的小改动。 仅当用户显式输入 /wf-quick 时使用；不要因"快速通道、快速修复、quick fix、小改动"等自然语言自动触发。
| name | wf-complex |
| description | 复杂后端：跨模块、架构变更或边界模糊，先探索再进入 OpenSpec。 仅当用户显式输入 /wf-complex 时使用；不要因“复杂需求、复杂后端、架构变更、跨模块”等自然语言自动触发。 |
复杂变更通道。
状态行规则：在本工作流执行期间，每次回复开头输出一行：
> wf-complex · <change-name> · 步骤 N/14
change-name 在步骤 4（openspec propose）确定后填入，此前用 … 占位；N 为当前正在执行的步骤编号。
切换与退出规则：
/wf-finish 显式关闭；调用其他 /wf-* 命令时自动切换（当前工作流视为结束，更新 .wf-active）适用于跨模块、架构变更、业务边界不清晰或实现风险较高的任务。
必须在对应阶段开始前加载指定 skill 的 SKILL.md。不得只按方法论摘要执行，也不得把“调用 skill”理解为普通文字说明。
required_skills:
exploration:
- superpowers:brainstorming
task_decomposition:
- superpowers:writing-plans
final_verification:
- superpowers:verification-before-completion
required_workflows:
proposal:
- openspec-propose
implementation:
- openspec-apply-change
archive:
- openspec-archive-change
design 阶段的工程/UI/安全关卡是结构化自检 + 用户确认（定义见 openspec/config.yaml 的 rules.design），
不是外部审查命令。实现完成后的代码审查：Codex App 无原生 /code-review 等价物时，用结构化自检清单，
并明确说明这是自检而非外部工具审查；subagent-driven-development 已内置逐任务审查和收尾全分支审查时，
此步是补充一遍，不是唯一依据。
若宿主环境没有对应 skill，必须明确说明降级；不得声称已加载或已审查。
可选编排（临场优化，非正式契约）：阶段多、风险高时，可酌情把探索/设计/实现/审查交给专职子 agent（探索→调研、设计→架构、实现→
superpowers:subagent-driven-development、审查→审查 agent、无依赖任务→superpowers:dispatching-parallel-agents）；不必要或不可用则主线程顺序执行。子 agent 内部过程不落盘，关键产出须写回 OpenSpec 工件以保持可追踪。
request_user_input 或当前宿主暴露的等价工具）。开始执行时必须先展示或内部完成以下自检，并在首条进展中说明已加载的依赖：
wf-complexbrainstorming、writing-plans、verification-before-completionopenspec-propose、openspec-apply-change、openspec-archive-changeOpenSpec 命令兜底：下文的 /openspec-propose、/openspec-apply-change、/openspec-archive-change（含 explore）均为 OpenSpec skill 名。若调用返回 Unknown skill，立即改用等价的 /opsx:propose、/opsx:apply、/opsx:archive（explore→/opsx:explore）继续，不得中断流程或声称失败。
执行以下步骤：
.wf-active（确保 git-ignored）：
echo '{"workflow":"wf-complex","change":"pending","started":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}' > .wf-active
grep -q "\.wf-active" .gitignore 2>/dev/null || echo ".wf-active" >> .gitignore
superpowers:brainstorming，探索需求、边界、风险和替代方案。risk_triggers 判断本次变更命中的风险类型，展示探索结论、风险和推荐路径，使用 UI 交互询问用户是否确认进入 OpenSpec 提案。/openspec-propose（含工程自检关卡，并按风险触发 UI/安全自检关卡；关卡结论须经用户显式确认）；不得手写替代 proposal 流程。superpowers:writing-plans 细化任务分解，确保 tasks.md 颗粒度合理、顺序清晰。/openspec-apply-change 实现；不得绕过该 workflow 直接实现。tasks.md 拆出多个相对独立的实现任务时，可加载 superpowers:subagent-driven-development 在当前会话内按独立任务推进。subagent-driven-development 已内置的逐任务审查和全分支审查视为已覆盖，此步是补充一遍）；收到审查反馈后加载 superpowers:receiving-code-review，先技术核实再落实，不盲目照办；若审查发现问题，先修复再进入验收。superpowers:verification-before-completion 验收，并在结果中说明已验证项。tasks.md 勾选状态；若存在无法确认完成的任务，先告知用户并保留未勾选状态。/openspec-archive-change；用户明确说「跳过归档」时保留 active change 不归档。
若有未完成任务：使用 UI 交互询问用户是否归档，用户确认后再执行 /openspec-archive-change。
归档时保留 /openspec-archive-change 的选择、未完成任务和 delta spec 同步确认逻辑。.wf-active：rm -f .wf-active完成前必须输出执行审计：
wf-complex：已执行propose、apply、archive 的执行状态