diff --git a/参考资料/Superpowers技能框架/INDEX_参考资料.md b/参考资料/Superpowers技能框架/INDEX_参考资料.md new file mode 100755 index 0000000..485ded6 --- /dev/null +++ b/参考资料/Superpowers技能框架/INDEX_参考资料.md @@ -0,0 +1,121 @@ +--- +title: 参考资料 - Superpowers 技能框架 +tags: + - 参考资料 + - AI Agent + - 技能框架 + - 软件开发方法论 +created: 2026-04-21 +updated: 2026-04-21 +--- + +# Superpowers 技能框架 参考资料 + +> 整理自 GitHub 仓库及官方博客 +> +> 作者:Jesse Vincent (obra) +> +> 整理日期:2026-04-21 + +--- + +## 原始文档 + +| 文件 | 说明 | +|------|------| +| [[什么是Superpowers技能框架_1.pdf]] | 完整介绍文档 | + +--- + +## 核心定义 + +**Superpowers** 是一套面向 AI 编码智能体(Coding Agent)的技能框架与软件开发方法论。通过可组合的技能(Skills)和初始化指令,将最佳实践强制嵌入 AI 智能体的工作流程。 + +**核心理念**:不依赖 AI 的"理解",而是从结构上强制合规 + +--- + +## 全流程工作流 + +| 阶段 | 技能 | 说明 | +|------|------|------| +| 需求探索 | 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/丢弃 | + +--- + +## 心理说服原则应用 + +基于沃顿商学院与 Robert Cialdini 团队合作的论文《Call Me a Jerk: Persuading AI》: + +| 原则 | 应用方式 | +|------|----------| +| 权威 (Authority) | 技能定义为强制工作流而非建议 | +| 承诺 (Commitment) | 使用技能前必须公开声明 | +| 社会认同 (Social Proof) | 营造"不怕调用的错技能"的文化 | + +--- + +## 优势 + +- ✅ 自动化最佳实践,降低认知负担 +- ✅ 长时间自主运行(子智能体驱动开发) +- ✅ 并行开发能力(Git worktree + 并发子智能体) +- ✅ 有据可查的质量保障(verification-before-completion) +- ✅ 可扩展的技能生态(SKILL.md 格式) +- ✅ 学术背书的心理机制 +- ✅ MIT 许可证,开源免费(GitHub 26.3k stars) + +## 劣势 + +- ⚠️ 学习曲线较陡 +- ⚠️ 对小型改动流程开销大 +- ⚠️ 高度依赖智能体平台 +- ⚠️ 提示词复杂度高 +- ⚠️ 子智能体 API 成本较高 +- ⚠️ 不接受新技能社区贡献 + +--- + +## 适用场景 + +| 场景 | 说明 | +|------|------| +| 中大型功能开发 | 需求不完全清晰时,brainstorming + writing-plans 防方向跑偏 | +| 追求工程纪律的团队 | 强制执行 TDD、代码审查等规范 | +| 长时间自主编程任务 | 子智能体驱动维持方向一致性 | +| 多任务并行开发 | Git worktree + 并发子智能体大幅缩短交付周期 | +| AI 开发方法论研究 | 作为参考实现 | + +**不适合**:快速原型验证、一次性脚本、极简改动、对 API token 成本极度敏感的项目 + +--- + +## 参考资源 + +| 资源 | 链接 | +|------|------| +| 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 | + +--- + +## 与其他方法的关系 + +| 方法 | 与 Superpowers 的关系 | +|------|------------------------| +| TDD | 核心实践,强制执行 | +| Harness Engineering | 互补:Harness 关注环境,Superpowers 关注流程 | +| SDD | 互补:SDD 关注规格,Superpowers 关注执行 | +| 子智能体驱动 | Superpowers 的执行机制 | + +--- + +*整理:知识库管理员 | 归档:2026-04-21* \ No newline at end of file