如果你在使用 SuperPowers 时输入 /brainstorm、/write-plan 或 /execute-plan 命令，现在会发现它们已被彻底移除。你必须改用对应的技能：brainstorming、writing-plans、executing-plans 或更优的 subagent-driven-development。本文将根据官方发布说明和当前技能文件，为你提供清晰的迁移路径和操作指南。

SuperPowers slash commands 已弃用：brainstorm、write-plan、execute-plan 应改用哪些技能 #

如果你是 SuperPowers 的老用户，习惯了通过 /brainstorm、/write-plan 和 /execute-plan 这些斜杠命令来启动开发流程，那么在更新到 v5.1.0 或更高版本后，你会发现这些命令已经失效。这不是一个暂时的错误，而是 SuperPowers 工作流向技能（Skills）驱动全面过渡的最终步骤。

弃用背景与官方证据 #

从 v5.0.0 开始，这三个斜杠命令进入弃用状态，并只显示指向新技能的提示。而到了 v5.1.0，它们已被正式移除。

官方证据来自 RELEASE-NOTES.md 的 v5.1.0 版本：

Legacy slash commands removed — /brainstorm, /execute-plan, and /write-plan are gone. They were deprecated stubs that did nothing but tell the user to invoke the corresponding skill. Invoke superpowers:brainstorming, superpowers:executing-plans, and superpowers:writing-plans directly instead. (#1188)

这与 README.md 中描述的 “The Basic Workflow” 完全一致。该部分明确了当前工作流的核心技能，旧命令正是被这些技能所取代：

• 旧 /brainstorm 命令 → 对应工作流第1步 brainstorming 技能。
• 旧 /write-plan 命令 → 对应工作流第3步 writing-plans 技能。
• 旧 /execute-plan 命令 → 对应工作流第4步 subagent-driven-development（推荐）或 executing-plans 技能。

迁移指南：从旧命令到新技能 #

迁移的核心是改变你与 AI 代理交互的“口令”。你需要用描述意图的自然语言或明确的技能调用，来替代输入斜杠命令。

1. /brainstorm → brainstorming 技能 #

旧操作：/brainstorm 我需要一个用户认证模块 新操作：你应该说：“请使用 brainstorming 技能来帮我设计一个用户认证模块”，或者更自然地：“在开始写代码前，我们需要先设计这个功能。请进行头脑风暴。”

技能核心：brainstorming 技能是一个强制性的设计门禁。它会引导代理通过结构化对话澄清需求、探索方案、呈现分块设计，并最终产出一份设计文档。代理在获得你对设计的批准前，不能开始任何编码工作。关于该技能的详细流程和可视化伴侣，可以参考 brainstorming 技能详解。

迁移验证：成功迁移后，代理将进入 brainstorming 技能的流程，会先检查项目上下文，然后开始提问，而不是显示命令无效的错误。

2. /write-plan → writing-plans 技能 #

旧操作：/write-plan 新操作：在通过 brainstorming 技能完成设计并获得批准后，代理会自动提示进入下一步。你也可以明确指示：“设计已经批准，请使用 writing-plans 技能生成详细的实施计划。”

技能核心：writing-plans 技能会基于已批准的设计文档，生成一份极其详细、可执行的实施计划。计划以细粒度任务（每个任务大约2-5分钟）的形式组织，包含确切的文件路径、完整的代码片段、测试命令和提交步骤。计划文档中严禁出现“TBD”或模糊描述。关于该技能如何写出可执行的计划，请参见 writing-plans 技能详解。

迁移验证：代理会创建一个 Markdown 格式的计划文件，并在计划开头明确提示需要使用 subagent-driven-development 或 executing-plans 技能来执行。

3. /execute-plan → executing-plans 或 subagent-driven-development 技能 #

旧操作：/execute-plan 新操作：在 writing-plans 技能完成后，它会询问你选择哪种执行方式。你应该根据平台能力做出选择：

• 首选（推荐）：“使用子代理驱动的方式执行这个计划。”（这将调用 subagent-driven-development 技能）
• 备选：“在当前会话中内联执行这个计划。”（这将调用 executing-plans 技能）

技能核心区别：

• subagent-driven-development：这是推荐的执行方式，但需要平台（如 Claude Code、OpenAI Codex）支持子代理。它会为计划中的每个任务派发一个全新的子代理去执行，并实施两阶段审查（规范符合性审查和代码质量审查），质量更高。详情可阅读 subagent-driven-development 详解。
• executing-plans：适用于没有子代理支持的平台（如 Gemini CLI、GitHub Copilot CLI 的早期版本）。它在当前会话中按批次执行任务，并在关键点设置检查点供你审查。它会在启动时提示：“Superpowers works much better with access to subagents.” 了解两者的区别与选择，请参考 executing-plans 与 subagent-driven-development 怎么选。

迁移验证：选择执行技能后，代理会明确宣布它正在使用哪个技能，并严格按照计划任务列表开始执行，而不是像旧命令那样可能直接开始混乱的编码。

迁移后的完整工作流 #

弃用斜杠命令后，一个典型的 SuperPowers 工作流如下，所有步骤均由技能自动驱动或由你触发：

1. 需求设计：你提出一个想法，代理自动或由你指令触发 brainstorming 技能，完成设计并请你批准。
2. 工作区隔离：设计批准后，using-git-worktrees 技能自动创建一个隔离的 Git 工作区。
3. 制定计划：在隔离的工作区中，writing-plans 技能生成详细的实施计划。
4. 执行实现：你选择执行方式（推荐 subagent-driven-development），代理开始按计划执行。
5. 质量门禁：执行过程中，test-driven-development（TDD）技能强制测试先行；遇到问题时，systematic-debugging 技能指导系统化调试；完成前，verification-before-completion 技能要求提供新鲜证据。
6. 收尾审查：任务完成后，requesting-code-review 和 finishing-a-development-branch 技能指导进行代码审查和分支收尾。

这个流程确保了 AI 编码代理在写代码前先澄清、先设计、先计划，从而提升代码质量和开发效率。

FAQ #

Q: 为什么 SuperPowers 要彻底移除这些斜杠命令，而不是继续保留？ A: 为了统一和强化工作流。斜杠命令只是一个简单的触发器，而对应的技能（Skills）包含完整的流程、检查清单和强制门禁（Hard-Gate），能确保代理严格遵循设计-计划-执行的最佳实践，避免代理跳过关键步骤直接写代码。移除旧命令消除了歧义。

Q: 我如何知道我的平台是否支持 subagent-driven-development？ A: 通常，如果平台支持“派遣子代理”、“创建新代理”或类似功能（如 Claude Code 的 Agent 工具，Codex 的 spawn_agent），它就支持。executing-plans 技能在开头就会提示：“Superpowers works much better with access to subagents.”。如果不确定，可以在执行计划时选择内联执行，代理会回退到 executing-plans 技能。

Q: 如果我在使用旧版本的 SuperPowers（v5.1.0之前），还能用这些命令吗？ A: 可以，但强烈建议你升级。在 v5.0.x 版本中，这些命令仍然存在，但只会显示弃用提示，指引你使用新技能。从 v5.0.0 开始，使用新技能才是获得完整、强化工作流的最佳实践。