Update from Sync Service
This commit is contained in:
FNS Service
200
实践积累/Superpowers技能框架.md
Executable file
200
实践积累/Superpowers技能框架.md
Executable file
@@ -0,0 +1,200 @@
|
||||
---
|
||||
title: Superpowers 技能框架
|
||||
tags:
|
||||
- AI-Agent
|
||||
- TDD
|
||||
- Coding-Agent
|
||||
- Software-Development
|
||||
- 开源
|
||||
created: 2026-04-21
|
||||
source: https://github.com/obra/superpowers
|
||||
stars: 161680
|
||||
forks: 14117
|
||||
language: Shell
|
||||
author: Jesse Vincent (obra)
|
||||
---
|
||||
|
||||
# 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** — 两阶段审查快速迭代
|
||||
|
||||
### Meta
|
||||
- **writing-skills** — 创建新技能的最佳实践
|
||||
- **using-superpowers** — 技能系统介绍
|
||||
|
||||
---
|
||||
|
||||
## 安装方式
|
||||
|
||||
```bash
|
||||
# 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成本极度敏感的项目
|
||||
|
||||
---
|
||||
|
||||
## 核心启示
|
||||
|
||||
1. **强制合规 > 依赖理解** — 不让AI"理解"TDD，而是构建无法跳过的系统
|
||||
2. **技能触发在工作流之前** — 任何响应前检查技能，从结构上杜绝跳过
|
||||
3. **验证即完成** — 以证据（测试通过）代替断言（"我认为完成了"）
|
||||
4. **TDD for Skills** — 技能本身也需要通过压测场景来验证有效性
|
||||
5. **子智能体 + 两阶段审查** — 实现长时间自主工作的关键
|
||||
|
||||
---
|
||||
|
||||
## 参考资源
|
||||
|
||||
- **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
|
||||
|
||||
Reference in New Issue
Block a user