From 6e362f1dc40095cd37a9ccf97b4fd1814a042658 Mon Sep 17 00:00:00 2001 From: FNS Service Date: Thu, 23 Apr 2026 21:43:03 +0800 Subject: [PATCH] Update from Sync Service --- AI工程/ClaudeCodeSuperpowers.md | 255 ++++++++++++++++++++++++++++++++ 1 file changed, 255 insertions(+) create mode 100755 AI工程/ClaudeCodeSuperpowers.md diff --git a/AI工程/ClaudeCodeSuperpowers.md b/AI工程/ClaudeCodeSuperpowers.md new file mode 100755 index 0000000..fdccbda --- /dev/null +++ b/AI工程/ClaudeCodeSuperpowers.md @@ -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* \ No newline at end of file