255 lines
6.3 KiB
Markdown
Executable File
255 lines
6.3 KiB
Markdown
Executable File
# Claude Code Superpowers 研究
|
||
|
||
> AI 编程的方法论框架 —— 让 AI 真正会干活
|
||
>
|
||
> 归档：2026-04-23
|
||
|
||
---
|
||
|
||
## 📊 项目概览
|
||
|
||
| 项目 | Stars | 定位 |
|
||
|------|-------|------|
|
||
| **obra/superpowers** | ⭐ 159k+ | 英文上游（方法论内核） |
|
||
| **jnMetaCode/superpowers-zh** | ⭐ 1,331 | 中文增强版（17 款工具） |
|
||
| **obra/superpowers-marketplace** | ⭐ 876 | 插件市场 |
|
||
| **obra/superpowers-skills** | ⭐ 623 | 社区 Skills |
|
||
|
||
**作者**：Jesse Vincent (Prime Radiant)
|
||
|
||
---
|
||
|
||
## 🎯 核心定位
|
||
|
||
**Superpowers 不是工具，而是一种方法论。**
|
||
|
||
它让 AI 编程工具从"直接写代码"变成"先想清楚再做"：
|
||
|
||
```
|
||
没装：你：加个批量导出 → AI：直接写代码 → 各种返工
|
||
装了：你：加个批量导出 → AI：先问需求 → 设计方案 → 确认 → 再做
|
||
```
|
||
|
||
---
|
||
|
||
## 🔄 核心工作流
|
||
|
||
### 完整开发流程
|
||
|
||
```
|
||
1. 头脑风暴 → 2. 编写计划 → 3. Git Worktree
|
||
↓ ↓ ↓
|
||
4. 子Agent开发 → 5. 代码审查 → 6. 完成分支
|
||
↓ ↓ ↓
|
||
TDD 实现 质量把关 合并/PR
|
||
```
|
||
|
||
### 自动化触发
|
||
|
||
每个 Skill 在特定阶段**自动激活**，不需要手动调用：
|
||
|
||
| 阶段 | 自动触发的 Skill |
|
||
|------|-----------------|
|
||
| 开始编码前 | `brainstorming`（头脑风暴） |
|
||
| 设计确认后 | `writing-plans`（编写计划） |
|
||
| 计划完成后 | `using-git-worktrees` + `subagent-driven-development` |
|
||
| 实现过程中 | `test-driven-development` |
|
||
| 任务间切换 | `requesting-code-review` |
|
||
| 任务完成 | `finishing-a-development-branch` |
|
||
|
||
---
|
||
|
||
## 📦 Skills 详解（14 个核心）
|
||
|
||
### 开发流程类
|
||
|
||
| Skill | 用途 |
|
||
|-------|------|
|
||
| **brainstorming** | 苏格拉底式需求分析，确认后再动手 |
|
||
| **writing-plans** | 把需求拆成 2-5 分钟的小任务 |
|
||
| **executing-plans** | 按计划执行，每步验证 |
|
||
| **subagent-driven-development** | 每个任务一个子 Agent + 两轮审查 |
|
||
| **dispatching-parallel-agents** | 多任务并行 |
|
||
|
||
### 代码质量类
|
||
|
||
| Skill | 用途 |
|
||
|-------|------|
|
||
| **test-driven-development** | 严格 RED-GREEN-REFACTOR |
|
||
| **systematic-debugging** | 四阶段调试：定位→分析→假设→修复 |
|
||
| **requesting-code-review** | 自动代码审查 |
|
||
| **receiving-code-review** | 严谨处理审查反馈 |
|
||
| **verification-before-completion** | 声称完成前必须跑验证 |
|
||
|
||
### Git 工作流类
|
||
|
||
| Skill | 用途 |
|
||
|-------|------|
|
||
| **using-git-worktrees** | 隔离开发 |
|
||
| **finishing-a-development-branch** | 合并/PR/保留/丢弃四选一 |
|
||
|
||
### 元技能类
|
||
|
||
| Skill | 用途 |
|
||
|-------|------|
|
||
| **writing-skills** | 创建新 Skill 的方法论 |
|
||
| **using-superpowers** | 如何调用和优先使用 |
|
||
|
||
---
|
||
|
||
## 🇨🇳 中文增强版（6 个原创）
|
||
|
||
| Skill | 用途 |
|
||
|-------|------|
|
||
| **chinese-code-review** | 适配国内团队文化的代码审查 |
|
||
| **chinese-git-workflow** | Gitee/Coding/极狐 GitLab 支持 |
|
||
| **chinese-documentation** | 中文排版 + 中英混排 + 告别机翻味 |
|
||
| **chinese-commit-conventions** | 国内团队 Commit 规范 |
|
||
| **mcp-builder** | 构建生产级 MCP 工具 |
|
||
| **workflow-runner** | 多角色 YAML 工作流执行器 |
|
||
|
||
---
|
||
|
||
## 🚀 安装方式
|
||
|
||
### Claude Code（官方市场）
|
||
|
||
```bash
|
||
/plugin install superpowers@claude-plugins-official
|
||
```
|
||
|
||
### 第三方市场
|
||
|
||
```bash
|
||
/plugin marketplace add obra/superpowers-marketplace
|
||
/plugin install superpowers@superpowers-marketplace
|
||
```
|
||
|
||
### 中文增强版（一键安装）
|
||
|
||
```bash
|
||
cd /your/project
|
||
npx superpowers-zh
|
||
```
|
||
|
||
自动检测项目中的 AI 工具并安装到正确位置。
|
||
|
||
---
|
||
|
||
## 🤖 支持的工具（17 款）
|
||
|
||
| 工具 | 类型 |
|
||
|------|------|
|
||
| **Claude Code** | CLI |
|
||
| **Cursor** | IDE |
|
||
| **Codex CLI** | CLI |
|
||
| **Hermes Agent** | CLI |
|
||
| **Windsurf** | IDE |
|
||
| **Kiro** | IDE |
|
||
| **Gemini CLI** | CLI |
|
||
| **Aider** | CLI |
|
||
| **Trae** | IDE |
|
||
| **OpenClaw** | CLI |
|
||
| **Qwen Code（通义灵码）** | IDE |
|
||
| **VS Code (Copilot)** | IDE |
|
||
| **DeerFlow 2.0** | Agent 框架 |
|
||
| **OpenCode** | CLI |
|
||
| **Antigravity** | CLI |
|
||
| **Claw Code** | CLI (Rust) |
|
||
| **Copilot CLI** | CLI |
|
||
|
||
---
|
||
|
||
## 💡 核心原则
|
||
|
||
| 原则 | 说明 |
|
||
|------|------|
|
||
| **TDD 优先** | 先写测试，再写代码 |
|
||
| **系统化** | 流程胜于猜测 |
|
||
| **简化复杂度** | 简化是首要目标 |
|
||
| **证据胜于言辞** | 验证后才说成功 |
|
||
|
||
---
|
||
|
||
## 📋 典型使用场景
|
||
|
||
### 场景 1：新功能开发
|
||
|
||
```
|
||
1. brainstorming → 确认需求
|
||
2. writing-plans → 拆分任务
|
||
3. subagent-driven-development → 逐步实现
|
||
4. requesting-code-review → 质量保证
|
||
5. finishing-a-development-branch → 合并
|
||
```
|
||
|
||
### 场景 2：Bug 修复
|
||
|
||
```
|
||
1. systematic-debugging → 定位根因
|
||
2. writing-plans → 制定修复计划
|
||
3. test-driven-development → 先写失败测试
|
||
4. verification-before-completion → 验证修复
|
||
```
|
||
|
||
### 场景 3：大型重构
|
||
|
||
```
|
||
1. using-git-worktrees → 隔离开发
|
||
2. dispatching-parallel-agents → 并行执行
|
||
3. requesting-code-review → 逐步审查
|
||
```
|
||
|
||
---
|
||
|
||
## 🔌 插件市场
|
||
|
||
### 可用插件
|
||
|
||
| 插件 | 用途 |
|
||
|------|------|
|
||
| **superpowers** | 核心 Skills 库（20+ 技能） |
|
||
| **elements-of-style** | 写作指南（Strunk 风格） |
|
||
| **developing-for-claude-code** | 插件开发指南 |
|
||
| **private-journal-mcp** | 私有日记 MCP |
|
||
|
||
### 安装插件市场
|
||
|
||
```bash
|
||
/plugin marketplace add obra/superpowers-marketplace
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 对比其他方案
|
||
|
||
| 方案 | Stars | 类型 | 特点 |
|
||
|------|-------|------|------|
|
||
| **superpowers** | 159k | 方法论 | 系统化工作流 |
|
||
| **claude-code-best-practice** | 47k | 参考文档 | 命令/配置详解 |
|
||
| **ClaudeForge** | 353 | 工具 | CLAUDE.md 自动生成 |
|
||
|
||
---
|
||
|
||
## 🔗 资源
|
||
|
||
| 资源 | 链接 |
|
||
|------|------|
|
||
| 英文版 | https://github.com/obra/superpowers |
|
||
| 中文版 | https://github.com/jnMetaCode/superpowers-zh |
|
||
| 插件市场 | https://github.com/obra/superpowers-marketplace |
|
||
| 博客 | https://blog.fsck.com/2025/10/09/superpowers/ |
|
||
| Discord | https://discord.gg/35wsABTejz |
|
||
|
||
---
|
||
|
||
## AI工程索引
|
||
|
||
相关笔记：
|
||
- [[INDEX_AI工程]] - AI工程知识索引
|
||
- [[ClaudeCode完全研究]] - Claude Code 完整指南
|
||
- [[ClaudeCode使用技巧与最佳实践]] - 使用技巧
|
||
|
||
---
|
||
|
||
*整理：知识库管理员 | 归档：2026-04-23* |