chill/chill_notes

Fork 0

Files

FNS Service 6e362f1dc4 Update from Sync Service

2026-04-23 21:43:03 +08:00

6.3 KiB

Executable File

Raw Blame History

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（官方市场）

/plugin install superpowers@claude-plugins-official

第三方市场

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

中文增强版（一键安装）

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

安装插件市场

/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

6.3 KiB Executable File Raw Blame History Unescape Escape