docs(ai): 拆分 Superpowers 模块并添加重定向

src/ai/superpowers/opencode-superpowers-overview.md

@@ -0,0 +1,210 @@
+---
+title: OpenCode Superpowers：框架总览与上手路线
+icon: mdi:rocket-launch-outline
+date: 2026-03-16
+category:
+  - AI
+  - 开发工具
+tag:
+  - OpenCode
+  - Superpowers
+  - Skills
+  - 工作流
+redirectFrom:
+  - /ai/opencode-superpowers-overview.html
+  - /ai/opencode-superpowers-overview
+---
+
+# OpenCode Superpowers：框架总览与上手路线
+
+Superpowers 不是“又一套提示词”，而是一套给编码代理用的开发方法：
+强制先澄清、先写计划、再执行、最后验证。
+
+这篇以 OpenCode 为主视角，把上游仓库 `obra/superpowers` 的核心要点整理成一篇
+可直接照着用的速查。
+
+<!-- more -->
+
+---
+
+## 一、它是什么（1 屏）
+
+一句话：Superpowers = skills 库 + 强制工作流 + 初始指令注入，让代理按流程做事。
+
+它主要解决三类问题：
+
+1. 还没想清楚就开写：越写越偏，返工成本高。
+2. 任务太大没拆分：改动越滚越大，diff 失控。
+3. 没验证就宣布完成：靠感觉收工，最后还是你来擦屁股。
+
+上游仓库：`https://github.com/obra/superpowers`
+
+---
+
+## 二、上游 Basic Workflow（按上游 7 步列出）
+
+下面这一段的“步骤名称与顺序”对齐上游 README 的 `The Basic Workflow`。
+我在每一步后面加一行白话解释，方便快速理解。
+
+1. **brainstorming** - Activates before writing code. Refines rough ideas through questions, explores alternatives, presents design in sections for validation. Saves design document.
+   白话：先问清楚需求边界，给方案对比，并写成可复用的设计稿，避免直接开写。
+
+2. **using-git-worktrees** - Activates after design approval. Creates isolated workspace on new branch, runs project setup, verifies clean test baseline.
+   白话：把任务隔离到独立分支/工作区，避免污染主分支，也方便并行做多个任务。
+
+3. **writing-plans** - Activates with approved design. Breaks work into bite-sized tasks (2-5 minutes each). Every task has exact file paths, complete code, verification steps.
+   白话：把“要做什么”拆成清单：改哪些文件、每一步怎么验收，尽量 2-5 分钟一个小步。
+
+4. **subagent-driven-development** or **executing-plans** - Activates with plan. Dispatches fresh subagent per task with two-stage review (spec compliance, then code quality), or executes in batches with human checkpoints.
+   白话：按计划执行。能并行就并行（子代理），不行就分批执行并留检查点。
+
+5. **test-driven-development** - Activates during implementation. Enforces RED-GREEN-REFACTOR: write failing test, watch it fail, write minimal code, watch it pass, commit. Deletes code written before tests.
+   白话：先让测试失败，再写最小实现让它通过；不写测试的代码宁可删掉重来。
+
+6. **requesting-code-review** - Activates between tasks. Reviews against plan, reports issues by severity. Critical issues block progress.
+   白话：每个阶段都做一次对计划的审查，避免悄悄偏离。
+
+7. **finishing-a-development-branch** - Activates when tasks complete. Verifies tests, presents options (merge/PR/keep/discard), cleans up worktree.
+   白话：收尾：验证、决定合并方式、清理分支/工作区。
+
+来源（上游 README）：
+`https://github.com/obra/superpowers/blob/363923f74aa9cd7b470c0aaa73dee629a8bfdc90/README.md#L101`
+
+常用配套（不在上面 7 步编号里，但非常高频）：
+
+- `systematic-debugging`：遇到错误/异常时，用系统化方式定位根因。
+- `verification-before-completion`：在你说“完成了”之前，用证据证明它真的完成了。
+
+---
+
+## 三、技能选择速查（我实际怎么选）
+
+我自己选 skill 很简单：先选模式，再推进。
+
+- 不确定需求边界、方案不明确：先用 `brainstorming`。
+- 目标明确但步骤多：用 `writing-plans` 把执行清单写出来。
+- 执行过程中卡住（构建失败/行为异常）：切到 `systematic-debugging`。
+- 准备说“好了”：用 `verification-before-completion` 跑验证再收工。
+
+关于加载 skill 的名字：以你当前环境输出为准。
+如果你的环境里显示 `superpowers/<name>`，就带前缀加载；否则加载裸名。
+
+本博客里我已经把 OpenCode 的安装与“场景化步骤卡片”写成两篇：
+
+- 安装/验证/排障：`opencode-superpowers.md`
+- 编码 + 写博客的步骤卡片：`opencode-skills-playbook.md`
+
+---
+
+## 四、安装与验证速查（OpenCode 为主 + 其他平台）
+
+### 4.1 安装（每个平台 1 个命令块）
+
+Claude Code：
+
+```text
+/plugin install superpowers@claude-plugins-official
+/plugin marketplace add obra/superpowers-marketplace
+/plugin install superpowers@superpowers-marketplace
+```
+
+来源：
+`https://github.com/obra/superpowers/blob/363923f74aa9cd7b470c0aaa73dee629a8bfdc90/README.md#L31`
+
+Cursor：
+
+```text
+/add-plugin superpowers
+```
+
+来源：
+`https://github.com/obra/superpowers/blob/363923f74aa9cd7b470c0aaa73dee629a8bfdc90/README.md#L55`
+
+Codex：
+
+```text
+Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
+```
+
+来源：
+`https://github.com/obra/superpowers/blob/363923f74aa9cd7b470c0aaa73dee629a8bfdc90/README.md#L65`
+
+OpenCode：
+
+```text
+Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
+```
+
+来源：
+`https://github.com/obra/superpowers/blob/363923f74aa9cd7b470c0aaa73dee629a8bfdc90/README.md#L75`
+
+如果你要按“手动 clone + symlink”方式装（含 Windows 权限坑），直接看：`opencode-superpowers.md`。
+
+Gemini CLI：
+
+```bash
+gemini extensions install https://github.com/obra/superpowers
+```
+
+来源：
+`https://github.com/obra/superpowers/blob/363923f74aa9cd7b470c0aaa73dee629a8bfdc90/README.md#L85`
+
+### 4.2 验证（1 个命令块，两行）
+
+```text
+帮我做一个需求拆解，但先选择并加载一个合适的 superpowers skill 再继续。
+预期：它会先进入某个 skill 的流程（提澄清问题/给计划/要求验证），而不是直接开写。
+```
+
+参考来源（上游 Verify Installation 段落）：
+`https://github.com/obra/superpowers/blob/363923f74aa9cd7b470c0aaa73dee629a8bfdc90/README.md#L97`
+
+---
+
+## 五、更新与排障（按平台）
+
+### 5.1 更新（3 个命令块）
+
+Claude Code：
+
+```text
+/plugin update superpowers
+```
+
+来源：
+`https://github.com/obra/superpowers/blob/363923f74aa9cd7b470c0aaa73dee629a8bfdc90/README.md#L165`
+
+OpenCode：
+
+```bash
+cd ~/.config/opencode/superpowers
+git pull
+```
+
+来源（上游 OpenCode 文档 Updating 段落）：
+`https://github.com/obra/superpowers/blob/363923f74aa9cd7b470c0aaa73dee629a8bfdc90/docs/README.opencode.md#L193`
+
+更新后要彻底退出并重启 OpenCode（把正在运行的 opencode 进程关掉，再重新启动）。
+
+Gemini CLI：
+
+```bash
+gemini extensions update superpowers
+```
+
+来源：
+`https://github.com/obra/superpowers/blob/363923f74aa9cd7b470c0aaa73dee629a8bfdc90/README.md#L91`
+
+Cursor：通常按 Cursor 的插件更新机制自动更新；不确定时可以按“安装命令”重装一次，然后按第 4 节的验证方式确认技能会触发。
+
+Codex：通常重新执行一次上游 Codex 安装指令即可视为更新，然后按第 4 节的验证方式确认技能会触发。
+
+### 5.2 OpenCode 常见排障入口
+
+如果你是 OpenCode 用户，遇到下面这类问题：
+
+- 插件似乎没加载
+- skills 找不到
+- Windows symlink/junction 权限报错
+
+建议直接看我这篇的“验证与排障”段落：`opencode-superpowers.md`。