如何使用Superpowers MCP强制Claude Code在编码前进行规划

Superpowers是一个强制执行系统化工作流的MCP。我使用它将skillcraft升级到Next.js 16，没有遗漏任何一个文件。

我过去几个月一直在用Claude构建skillcraft.ai。Claude很擅长快速编写代码，但它有一个问题：它经常跳过步骤。

当我让Claude帮助迁移某个大型项目时，它会立即开始建议修改。没有规划阶段。没有"让我先找到所有需要更新的文件"。只是直接进入代码修改并期望获得最好的结果。

这就是你遗漏文件的方式。这就是你发布bug的方式。

Superpowers是一个解决这个问题MCP。它基本上是一个结构化工作流库------测试、调试、规划------Claude Code会自动加载并真正遵循的工作流。

Claude Code中的skill是一个包含指令、脚本和资源的文件夹，Claude在需要时会加载它。这是Anthropic的Agent Skills功能的一部分，该功能可在Claude应用、Claude Code和API中工作。每个skill定义了它何时适用、遵循什么流程以及不能走什么捷径。当你开始一个匹配skill的任务时，Claude会扫描可用的skills，找到匹配项并自动加载它。

我经常使用三个斜杠命令：

命令	它的作用
`/superpowers:brainstorm`	在编码前完善粗略的想法
`/superpowers:write-plan`	创建详细的实施计划
`/superpowers:execute-plan`	以批次方式运行计划并进行审查检查点

我将Superpowers添加到我的CLAUDE.md中，这样它在每次会话时都会自动加载：

python 复制代码

# Project Setup

Use the Superpowers MCP for all development work. Load it at session start.

这对token效率来说意义重大------Claude不再燃烧context试图将所有内容保存在内存中，而是将工作分成5分钟的块并将进度写入markdown文件。你永远不会在会话之间丢失上下文，因为计划就在一个文件中，而不是锁定在三小时前达到token限制的某个对话中。

生成的文件看起来是这样的：

ruby 复制代码

~/.config/superpowers/
└── plans/
    └── nextjs-16-migration/
        ├── PLAN.md                  # Complete migration roadmap
        ├── progress.md              # Current status and completed tasks
        └── verification.md          # Test commands and success criteria

PLAN.md文件包含所有内容：

部分	包含内容
Overview	需要改变什么以及为什么
Phase 1	API路由重构（23个文件）
Phase 2	组件时间敏感性修复
Phase 3	Context provider Suspense边界
Phase 4	启用cacheComponents
Phase 5	测试和验证
Rollback	如果出现故障怎么办

Skillcraft运行在Next.js上，我想启用Next.js 16中的新cacheComponents功能。这个东西会破坏各种模式------访问searchParams的API路由，使用new Date()的组件，没有Suspense边界的context providers。

我运行/superpowers:write-plan并得到了一个500行的计划。不是一些模糊的大纲，而是一个完整的路线图：所有23个需要更改的API路由文件，两个会破坏预渲染的使用new Date()的组件，需要Suspense边界的特定context providers，以及一个带有测试检查点的4天时间线。

该计划包含了每个阶段的验证命令：

bash 复制代码

# Test specific endpoints after API refactoring
curl http://localhost:3000/api/leaderboard
curl http://localhost:3000/api/courses/recent
curl http://localhost:3000/api/topics

它记录了修改前后的模式：

javascript 复制代码

// Before: Incompatible with cacheComponents
export const runtime = 'nodejs'
export const dynamic = 'force-dynamic'

// After: Clean (API routes are dynamic by default)
// Note: With cacheComponents enabled, API routes are dynamic by default

它甚至定义了成功标准（构建成功，CLS保持在0.000，Lighthouse分数≥ 95）和回滚计划。

没有这个计划，我会启用cacheComponents，遇到错误，逐一修复，并肯定会遗漏边缘情况。迁移会需要几天的反应式调试。有了计划，在接触任何代码之前我就有了完整的路线图。

该库包含多个用于测试、调试和开发工作流的skills：

Skill	它强制执行的内容
`test-driven-development`	RED-GREEN-REFACTOR：编写测试，观察失败，编写代码
`systematic-debugging`	4阶段方法：根本原因调查 → 模式分析 → 假设测试 → 实施
`verification-before-completion`	在声称工作完成之前运行验证命令并确认输出

这些skills字面上阻止你跳过步骤。再也没有"我认为它有效"而没有证明的情况。

如果你正在进行迁移并需要找到一个模式的所有实例，Superpowers会找到它们所有。如果你正在调试并即将猜测修复方案，它会阻止你并让你先调查根本原因。如果遗漏一个文件会破坏生产环境，它会在你完成之前让你验证一切。

安装

Superpowers与Claude Code（CLI工具）一起工作。通过插件市场安装：

bash 复制代码

# In Claude Code
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

或者手动将其添加到.claude/plugins.json：

json 复制代码

{
  "plugins": {
    "superpowers": {
      "type": "github",
      "owner": "obra",
      "repo": "superpowers"
    }
  }
}

当Claude Code启动时，你会看到skills加载的确认信息。然后只需使用斜杠命令：在开始复杂功能之前使用/superpowers:brainstorm，对于迁移或多文件重构使用/superpowers:write-plan，使用/superpowers:execute-plan以批次方式运行这些计划。