Update from Sync Service
This commit is contained in:
255
AI工程/ClaudeCodeSuperpowers.md
Executable file
255
AI工程/ClaudeCodeSuperpowers.md
Executable file
@@ -0,0 +1,255 @@
|
||||
# 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*
|
||||
Reference in New Issue
Block a user