概述

Superpowers 是 Claude Code 的技能（Skill）插件系统，通过 superpowers@claude-plugins-official 插件安装。它提供了一套结构化的工作流技能，覆盖软件开发完整生命周期。

优先级模型

用户指令（最高）→ Superpowers 技能 → 默认系统行为（最低）

技能是工作流引导而非硬性约束。CLAUDE.md / AGENTS.md 中的用户指令始终优先。

技能体系总览

工作流技能（内置插件）

阶段 技能名 用途
规划 brainstorming 创意工作前的需求探索与设计
规划 writing-plans 将需求写成实施计划
隔离 using-git-worktrees 创建隔离的 git worktree
实施 executing-plans 按计划逐步执行
实施 test-driven-development TDD 红-绿-重构循环
实施 subagent-driven-development 子代理并行执行计划任务
并行 dispatching-parallel-agents 并行派发多个独立任务
审查 requesting-code-review 完成工作后请求代码审查
审查 receiving-code-review 处理代码审查反馈
收尾 verification-before-completion 声称完成前运行验证命令
收尾 finishing-a-development-branch 开发完成后的分支处理
调试 systematic-debugging 系统化 Bug 调试流程
工具 writing-skills 创建/编辑技能

工作流模式

新功能开发（标准流程）

brainstorming → writing-plans → using-git-worktrees → test-driven-development → requesting-code-review → verification-before-completion → finishing-a-development-branch

Bug 修复

systematic-debugging → using-git-worktrees → test-driven-development → verification-before-completion → finishing-a-development-branch

关键原则

  1. 技能优先检查：开始任何操作前，即使只有 1% 可能性也先检查是否有适用技能
  2. 用户指令最高优先：CLAUDE.md 的项目指令和用户直接请求优先于技能内置规则
  3. 流程技能先于实施技能：先用 brainstorming/writing-plans 确定怎么做，再实施
  4. 不要跳过验证：声称”完成/修好/通过”前必须运行验证命令
  5. 计划写到磁盘：复杂任务（3+ 步骤）使用 planning-with-files 创建持久化文件
  6. 原子提交：feature 分支 → 一个提交一件事 → 推送 → PR

如何使用技能

方式一：直接调用

输入斜杠命令：

1
2
3
/embedded-code-check
/brainstorming
/verification-before-completion

方式二：自动判断

Claude 根据关键词自动匹配技能。例如”这段代码风格不规范”可能触发 embedded-code-check。

方式三：查找和安装新技能

1
2
npx skills find <关键词>    # 搜索
npx skills add <包名> -g -y # 安装

在 skills.sh 浏览热门技能。

已安装插件

插件 来源 说明
superpowers@claude-plugins-official 官方 工作流技能集
planning-with-files 社区 Manus 风格文件化规划
code-review 官方 PR 代码审查
code-simplifier 官方 代码简化与重构
ui-ux-pro-max 社区 UI/UX 设计系统
example-skills 官方 Anthropic 示例技能
clangd-lsp 官方 C/C++ LSP 支持

常见问题

技能和 CLAUDE.md 冲突怎么办？

CLAUDE.md 指令优先级最高。技能提供工作流框架，用户指示明确时遵循用户。

如何创建自定义技能？

使用 writing-skills 技能引导创建，或 npx skills init <技能名> 快速初始化。

技能文件在哪里？

  • 插件技能：Claude Code 插件系统管理
  • 本地技能：~/.claude/skills/<技能名>/SKILL.md