chill/chill_notes

Fork 0

Files

FNS Service 8ab238e74d Update from Sync Service

2026-04-21 10:51:32 +08:00

6.7 KiB

Executable File

Raw Blame History

title, tags, created, source, stars, forks, language, author

title

Superpowers 技能框架

一个面向 AI 编码智能体的完整软件开发方法论

GitHub: 161.7k ⭐ | MIT 许可证

核心定义

Superpowers 是由 Jesse Vincent（obra）开发的一套面向 AI 编码智能体的技能框架与软件开发方法论。

核心理念：不试图让 AI"理解"最佳实践，而是构建一个"不遵守规范就无法推进"的系统。

核心理念

与 Harness Engineering 的关系

Superpowers 是 Harness Engineering 的具体实现之一，专注于编码智能体场景。

维度	Superpowers	Harness Engineering
核心等式	技能驱动工作流	Agent = Model + Harness
触发机制	技能在任意响应前自动检查	五大子系统
验证方式	RED-GREEN-REFACTOR	verification-before-completion
状态管理	brainstorming文档 + plan文件	State子系统

核心特点

1. 技能驱动的全流程工作流

阶段	技能	说明
需求探索	brainstorming	苏格拉底式提问，输出设计文档
工作区隔离	using-git-worktrees	独立Git worktree上开始工作
任务拆解	writing-plans	2-5分钟细粒度任务，带文件路径和验证步骤
执行	subagent-driven-development / executing-plans	子智能体并发执行，两阶段审查
测试	test-driven-development	严格RED-GREEN-REFACTOR循环
审查	requesting-code-review	按严重程度上报问题
收尾	finishing-a-development-branch	验证测试，决策合并/PR/丢弃

2. 强制合规，而非依赖理解

技能检查置于**"任何响应或动作之前"**，从结构上杜绝跳过。

3. 心理说服原则的应用

基于沃顿商学院与恰尔蒂尼团队合作的论文《Call Me a Jerk: Persuading AI》：

权威（Authority） — 技能定义为强制工作流而非建议
承诺（Commitment） — 使用技能前要求智能体公开声明
社会认同（Social Proof） — 营造"不怕调用错技能"的文化

4. 技能的TDD开发

技能本身也通过TDD方式创建：

RED — 设计压测场景，让子智能体执行 → 暴露技能失效
GREEN — 强化技能指令，重测通过
REFACTOR — 优化技能表达

5. 多平台支持

Claude Code（官方市场）
OpenAI Codex CLI/App
GitHub Copilot CLI
Cursor
Gemini CLI
OpenCode

内置技能库

Testing

test-driven-development — RED-GREEN-REFACTOR循环

Debugging

systematic-debugging — 4阶段根因分析
verification-before-completion — 确保真正修复

Collaboration

brainstorming — 苏格拉底式设计优化
writing-plans — 详细实现计划
executing-plans — 带检查点的批量执行
dispatching-parallel-agents — 并发子智能体工作流
requesting-code-review — 审查前检查清单
receiving-code-review — 响应反馈
using-git-worktrees — 并行开发分支
finishing-a-development-branch — 合并/PR决策工作流
subagent-driven-development — 两阶段审查快速迭代

安装方式

# Claude Code 官方市场
/plugin install superpowers@claude-plugins-official

# Claude Code Superpowers市场
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

# Cursor
/add-plugin superpowers

# OpenAI Codex CLI
/plugins → 搜索superpowers → 安装

# GitHub Copilot CLI
copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace

# Gemini CLI
gemini extensions install https://github.com/obra/superpowers

优势

优势	说明
自动化最佳实践	开发者无需反复提醒，框架自动触发TDD、代码审查等规范
长时间自主运行	子智能体驱动开发使智能体能在数小时不偏离计划自主工作
并行开发能力	Git worktree + 并发子智能体可同时推进多个独立任务
有据可查的质量保障	verification-before-completion要求以证据代替断言
可扩展的技能生态	技能以Markdown文件（SKILL.md）形式存在
学术背书的心理机制	说服原则对LLM的有效性已有统计显著性的学术验证
开源免费	MIT许可证

劣势

劣势	说明
学习曲线	需要理解完整工作流，初学者上手成本较高
流程开销	brainstorming和planning对小型改动可能过重
依赖智能体平台	技能效果高度依赖底层编码智能体
提示词复杂度高	内嵌心理说服机制的提示词难以手动维护
子智能体成本	Subagent-Driven Development会频繁启动新实例，API成本较高
贡献限制	不接受新技能的社区贡献，修改必须兼容全部支持的平台

适用场景

场景	说明
中大型功能开发	需求不完全清晰、任务较多时，brainstorming + writing-plans能有效防止方向跑偏
追求工程纪律的团队	强制执行TDD、代码审查等规范
长时间自主编程任务	需要智能体在无监督下稳定工作数小时
多任务并行开发	多个独立子任务可并行推进
AI开发方法论研究	对"如何让AI遵守软件工程规范"感兴趣的研究者
自定义技能开发	团队已有内部规范，可通过writing-skills创建专属技能

不适合场景：快速原型验证、一次性脚本或极简改动、对API token成本极度敏感的项目

核心启示

强制合规 > 依赖理解 — 不让AI"理解"TDD，而是构建无法跳过的系统
技能触发在工作流之前 — 任何响应前检查技能，从结构上杜绝跳过
验证即完成 — 以证据（测试通过）代替断言（"我认为完成了"）
TDD for Skills — 技能本身也需要通过压测场景来验证有效性
子智能体 + 两阶段审查 — 实现长时间自主工作的关键

参考资源

GitHub: https://github.com/obra/superpowers
官方博客: https://blog.fsck.com/2025/10/09/superpowers/
Discord社区: https://discord.gg/35wsABTejz
Claude插件市场: https://claude.com/plugins/superpowers

6.7 KiB Executable File Raw Blame History Unescape Escape