Menu
复杂后端：跨模块、架构变更或边界模糊，先探索再进入 OpenSpec。 仅当用户显式输入 /wf-complex 时使用；不要因“复杂需求、复杂后端、架构变更、跨模块”等自然语言自动触发。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
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 的执行状态