【转载】我如何用Superpowers MCP强制Claude Code在编码前进行规划

转载

作者：Trevor I. Lasn

发布时间：2025年11月4日

阅读时间：5分钟

---

概述

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

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

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

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

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

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

命令	功能
/superpowers:brainstorm	在编码前完善粗略想法
/superpowers:write-plan	创建详细的实施计划
/superpowers:execute-plan	批量运行计划，包含检查点

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

# 项目设置

使用Superpowers MCP进行所有开发工作。在会话开始时加载它。

这对token效率来说是巨大的提升——与其让Claude消耗上下文试图在内存中保持所有内容，它将工作分割成5分钟的块，并将进度写入markdown文件。你永远不会在会话之间丢失上下文，因为计划就在文件中，而不是锁在三个小时前达到token限制的对话中。

生成的文件结构

生成的文件结构如下：

~/.config/superpowers/
└── plans/
    └── nextjs-16-migration/
        ├── PLAN.md                  # 完整迁移路线图
        ├── progress.md              # 当前状态和已完成任务
        └── verification.md          # 测试命令和成功标准

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

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

实际应用案例

Skillcraft运行在Next.js上，我想启用Next.js 16中的新 cacheComponents 功能。这个东西到处破坏模式——访问 searchParams 的API路由，使用 new Date() 的组件，没有Suspense边界的上下文提供者。

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

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

# API重构后测试特定端点
curl http://localhost:3000/api/leaderboard
curl http://localhost:3000/api/courses/recent
curl http://localhost:3000/api/topics

它记录了之前/之后的模式：

// 之前：与cacheComponents不兼容
export const runtime = 'nodejs'
export const dynamic = 'force-dynamic'

// 之后：干净（API路由默认是动态的）
// 注意：启用cacheComponents后，API路由默认是动态的

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

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

技能库

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

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

这些技能真的会阻止你跳过步骤。不再有"我认为它有效"而没有证据。

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

安装

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

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

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

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

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

---