工具配置指南
🚧 文档编写中...
本章节将介绍如何配置 AI 编程工具。
VSCode + Claude Code
安装步骤
- 安装 VSCode
- 安装 Claude Code 插件
- 配置 cc-switch（可选）
Opencode 桌面端
安装步骤
- 下载 Opencode
- 配置模型
Opencode + Superpowers 配置指南
Superpowers 是一个 AI 编程代理的技能框架和软件开发方法论，为 Opencode 提供结构化的开发工作流。
什么是 Superpowers
Superpowers 是一套完整的软件开发工作流，包含可组合的 "skills"（技能），让 AI 编程代理能够：
- 设计先行：编码前通过对话提炼需求，生成设计方案
- 测试驱动：严格执行 RED-GREEN-REFACTOR 测试循环
- 系统调试：4 阶段根因分析流程
- 代码审查：自动化审查和质量把关
- 并行开发：支持并行子代理工作流
安装 Superpowers
在 Opencode 中执行以下命令：
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
详细文档参考：docs/README.opencode.md
核心工作流
Superpowers 会自动触发以下工作流程：
1. brainstorming（头脑风暴）
在编码前激活，通过提问提炼需求，探索替代方案，分块展示设计方案供验证，最终保存设计文档。
使用示例：
"帮我设计一个用户注册功能"
2. using-git-worktrees（Git 工作区隔离）
设计方案通过后，在新分支上创建隔离工作区，运行项目初始化，验证干净的测试基线。
3. writing-plans（编写实施计划）
将设计方案拆分为 2-5 分钟的小任务，每个任务包含确切的文件路径、完整代码和验证步骤。
4. subagent-driven-development（子代理驱动开发）
为每个任务派遣新的子代理，进行两阶段审查（规范符合性 + 代码质量）。
5. test-driven-development（测试驱动开发）
强制 RED-GREEN-REFACTOR 循环：
- RED：编写失败的测试
- GREEN：编写最简代码让测试通过
- REFACTOR：重构代码
- 删除测试前编写的代码
6. requesting-code-review（请求代码审查）
任务间自动审查，按严重程度报告问题，关键问题会阻断进度。
7. finishing-a-development-branch（完成开发分支）
任务完成后验证测试，提供多种选项（合并/PR/保留/丢弃），清理工作区。
技能库一览
| 类别 | 技能名 | 功能说明 |
|---|---|---|
| 测试 | test-driven-development | RED-GREEN-REFACTOR 循环 |
| 调试 | systematic-debugging | 4 阶段根因分析 |
| verification-before-completion | 修复验证 | |
| 协作 | 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 | 快速迭代与两阶段审查 | |
| 元技能 | writing-skills | 创建新技能 |
| using-superpowers | 技能系统介绍 |
使用建议
- 自然触发：技能会自动检测相关场景，你只需描述需求，代理会自动调用合适的技能
- 信任流程：Superpowers 强调 "证据胜过声明"，确保每一步都有验证
- 迭代优化：每个技能都支持循环改进，直到满足要求
- YAGNI 原则：移除不必要的功能，专注于当下需求
验证安装
开始新会话并询问会触发技能的内容（如 "帮我规划这个功能" 或 "调试这个问题"），代理应自动调用相关的 superpowers 技能。
更新 Superpowers
/plugin update superpowers
返回：上一页 | [下一页：Prompt 技巧](./prompt-basics
返回：上一页 | 下一页：Prompt 技巧