superpowers-zh 1.2.1 → 1.5.0

package/RELEASE-NOTES.zh.md

@@ -0,0 +1,236 @@
+# Superpowers-ZH 中文版 Release Notes
+
+> 本文档记录 `jnMetaCode/superpowers-zh` 中文 fork 自身的 release 历史。
+>
+> 上游 `obra/superpowers` 的英文 release notes 见 [`RELEASE-NOTES.md`](./RELEASE-NOTES.md)（原样保留，未翻译）。
+
+---
+
+## v1.5.0 (2026-05-21)
+
+### 🆕 Qoder 适配（第 18 款工具，#26、#34）
+
+Qoder 是阿里推出的 AI IDE，社区有多个用户提需求要求支持。本版本完成端到端适配：
+
+- `bin/superpowers-zh.js` — `TARGETS` 加 Qoder（`dir: .qoder/skills`，`detect: .qoder`），`TOOL_ALIASES` 加 `qoder`
+- `generateQoderBootstrap()` — 生成 `.qoder/rules/superpowers-zh.md`（`trigger: always_on` + `alwaysApply: true`），让"先头脑风暴 / 先 TDD / 先验证"等核心规则每个会话自动加载，**不依赖模型对 description 的隐式匹配**
+- `skills/using-superpowers/references/qoder-tools.md` — 新增工具映射 reference（Qoder 大部分工具与 Claude Code 同名，只有 `EnterPlanMode/ExitPlanMode` → `EnterSpecMode/ExitSpecMode` 一个差异；附 Quest MCP 工具清单）
+- `docs/README.qoder.md` — 完整安装/使用/卸载/故障排查指南
+- `scripts/audit.sh` — `TOOLS` 数组加 qoder，CI 自动跑 18 款工具的 install/idempotent/uninstall 回归
+
+**安装方法：**
+
+```bash
+cd /your/qoder-project
+npx superpowers-zh --tool qoder     # 显式
+# 或在有 .qoder/ 的项目里：
+npx superpowers-zh                  # 自动检测
+```
+
+装完重启 Qoder，输入 `/` 即可看到 20 个 skill。
+
+### ⚠️ Qoder Rules schema 来源说明
+
+Qoder Rules 的 frontmatter schema（`trigger: always_on` / `model_decision` / `manual`）**官方文档（docs.qoder.com/zh/user-guide/rules）目前未公开**。本次实现的 schema 来自 GitHub 上 4 份真实社区样本（`python-office`、`termiClaude`、`QoderTest`、`TelegramFileServer`）的交叉验证。
+
+如果 Qoder 后续改了 schema，生成的 rule 文件可能需要打开 Qoder Settings → Rules 重新选择"始终生效"类型。
+
+### 🔧 文案对齐
+
+- README、CLAUDE.md、package.json description：17 款 → 18 款
+- 3 个 plugin manifest（`.claude-plugin/{plugin,marketplace}.json`、`.cursor-plugin/plugin.json`）description 同步
+
+### 设计取舍：为什么用 always_on bootstrap 而非裸 skill
+
+社区有用户（@Yanyz-ok）建议"按 AI 编程工具拆分/重写 skill"。我们刻意**不走这条路**：
+
+1. **skill 是工作方法论，不是工具实现** —— "先写测试再写代码"这个约束在 Claude Code、Qoder、Hermes 上落地工具不同，但方法论不变。重写会让 17 份 SKILL.md 维护负担 ×17 但本质增量 0。
+2. **平台内置工具 vs skill 是嵌套关系，不是替代关系** —— Qoder/Quest 的 `search_codebase`、`update_memory` 解决"怎么做"，skill 解决"什么时候做"，模型不会混淆。
+3. **上游 superpowers 明确禁止"无 eval 证据的工具专属重写"** —— fork 守同样规矩。
+
+工具映射写在 `references/qoder-tools.md` + `docs/README.qoder.md` 里就够了，不需要每个 skill 内部复制一遍。详见 issue #26 完整讨论。
+
+### Refs
+
+- closes #26（建议新增 qoder 的支持）
+- closes #34（建议支持 qoder，#26 重复）
+
+---
+
+## v1.4.0 (2026-05-12)
+
+本版本核心目标：**修复全量质量审计发现的所有上游漂移 P0 缺陷**。改动全部是"主站有的同步过来"性质，不引入主站没有的新功能。
+
+### 🔴 上游同步：v5.0.6 brainstorm server 拆分（PR #30）
+
+上游 v5.0.6（commit 9e3ed21）把 brainstorm server 的内容目录拆成 `CONTENT_DIR` + `STATE_DIR` peer 结构，但我们的 server 脚本还停在旧 `SCREEN_DIR` 单目录版本，导致 visual brainstorming 教程指向新路径但 server 用旧结构卡死。
+
+- `skills/brainstorming/scripts/server.cjs` — 81 行 cherry-pick 同步
+- `skills/brainstorming/scripts/start-server.sh` — 36 行同步
+- `skills/brainstorming/scripts/stop-server.sh` — 29 行同步
+
+**修复后：所有 visual brainstorming 用户路径解析正常。**
+
+### 🔴 上游同步：v5.1.0 Code Review 整合（PR #30）
+
+上游 v5.1.0 PR #1299 把 reviewer persona + checklist + dispatch 模板整合到单一 `code-reviewer.md` 实现 self-contained，并把 SKILL.md 里的 `superpowers:code-reviewer` 命名子代理引用改成 `general-purpose` Task + 模板路径形式。我们的版本停留在 v5.0.x 拆分式。
+
+- `skills/requesting-code-review/SKILL.md` 改 4 处：3 处 `superpowers:code-reviewer` 引用清零；占位符从 5 个精简到 4 个对齐上游；"执行计划" 集成段从 "每批（3 个任务）后审查" 改为 "每个任务完成后或在自然 checkpoint 审查"（对齐上游 v5.1.0 subagent 节奏调整）
+- `skills/requesting-code-review/code-reviewer.md` 完整重写为 v5.1.0 self-contained 版（H header 6/6 对齐上游）
+
+**修复后：所有走 review 流程的用户得到的指令指向 `general-purpose` Task 而非已废弃的命名子代理。**
+
+### 🔴 上游同步：v5.1.0 worktree 安全修复（PR #28）
+
+上游 v5.1.0 [#991](https://github.com/obra/superpowers/issues/991) 修复了两类 worktree 安全问题：subagent 嵌套创建 + cleanup 误删 harness-managed workspace。
+
+- `skills/using-git-worktrees/SKILL.md` 全面重构：新增 Step 0 检测现有隔离（GIT_DIR/GIT_COMMON + submodule 守卫 + 同意流程）；Step 1 重组为 1a Native Tools + 1b Git Worktree Fallback + 沙盒回退；删除旧"示例工作流"段（含 `/Users/jesse` 硬编码）
+- `skills/finishing-a-development-branch/SKILL.md` 全面重构：新增 Step 2 检测环境（三态表）；旧 Step 2-5 重编号为 3-6；Step 4 新增分离 HEAD 3 选项变体；Step 5 Option 1 重写（MAIN_ROOT cwd safety + merge→verify→cleanup→delete 严格排序）；Step 6 清理范围限定在 `.worktrees/` / `worktrees/` / `~/.config/superpowers/worktrees/`，外部 harness-managed workspace 一律不动
+
+**修复后：subagent 不再嵌套创建 worktree；清理不会误删 harness-managed workspace。**
+
+### 🔴 平台兼容性修复：Windows Cursor hook 回归（PR #30）
+
+`hooks/hooks-cursor.json` 的 command 之前被本地改成直接调 unix shell `./hooks/session-start`，丢失上游的 polyglot wrapper `./hooks/run-hook.cmd session-start`，Windows + Cursor 组合用户 hook 完全不触发。
+
+- 1 行恢复上游 polyglot wrapper
+
+**修复后：Windows Cursor 用户 hook 正常触发。**
+
+### 🆕 防回归基建：CI 自动漂移检测（PR #31）
+
+新增 `scripts/audit.sh` + `.github/workflows/audit.yml`，每次 PR 自动跑 4 类共 90+ 项检查：
+
+1. 静态校验（JSON parse / SKILL.md frontmatter / symlink / hook 可执行性）
+2. Installer 功能（17 款工具装/重装/卸载全跑）
+3. 上游对齐（hooks 4 文件 + brainstorm scripts 3 文件 + 14 翻译 skill 结构层级 + code-reviewer.md self-contained 结构）
+4. 交叉引用（README → docs/ 链接 + skill 间引用 + 装完后 .claude/skills/using-superpowers/SKILL.md 路径解析）
+
+WARN（不阻塞）vs FAIL（阻塞）分级：本次"4 个 P0 漂"事件如果当时有这个 audit 在 CI 跑，PR 阶段就会被拦下。
+
+**未来意义：维护者下次手抖把 `hooks-cursor.json` 改坏 / 上游同步漏一项，CI 立刻拦下。**
+
+### 🔧 工具链小修
+
+- `scripts/sync-plugin-version.js` 加入 `gemini-extension.json`（之前漏掉，导致 gemini extension manifest 卡在 1.1.6 老版本）
+- `package.json` 的 `version` 钩子 git add 列表同步更新
+
+### 安装路径方针澄清
+
+本版本明确：**有官方 plugin marketplace 的工具（Claude Code / Codex CLI / OpenCode / VS Code）首选 marketplace 路径**，npx `superpowers-zh` 主要服务没有 marketplace 的工具（Cursor / Trae / Kiro / Gemini CLI / Hermes / Aider / Antigravity / Windsurf / Qwen / Claw / OpenClaw / DeerFlow 共 13 款）。fork 不再尝试给 marketplace 工具加 npx 路径的"完整支持"——它们走主站路径即可。
+
+### 不在本版本范围
+
+- `executing-plans/SKILL.md` 我们扩写了 105 行中文示例（主动选择，保留——是 fork 的中文优化，非漂移）
+- `using-superpowers/SKILL.md` 的"中国特色技能路由"段（fork 增量，保留）
+- 各 reviewer-prompt.md 翻译差异（结构对齐，纯翻译漂移，无行为 bug）
+- open issues #18/#21/#26/#20（fork 增量需求，按方针延后）
+
+### Refs
+
+- PR #28（worktree 安全修复）
+- PR #30（brainstorm scripts + code-reviewer 整合 + hooks-cursor + SKILL.md 引用）
+- PR #31（audit script + CI workflow）
+- issue #19 跟踪上游 v5.0.6 / v5.1.0 同步 → 关键项目全部覆盖
+
+---
+
+## v1.3.0 (2026-05-10)
+
+### 跟上游对齐 (v5.1.0)
+
+- **同步上游 v5.1.0 的目录变更**：上游主动删除了 `commands/`（3 个 deprecated stub）和 `agents/code-reviewer.md`（已上升进 `requesting-code-review` skill）。中文 fork 跟随删除以与上游意图对齐。详见上游 [#1188](https://github.com/obra/superpowers/pull/1188) 与 PR #1299。
+- **`bin/superpowers-zh.js`** 移除安装时复制 `agents/` 到 `.claude/agents/` 的逻辑，**保留** uninstall 时的清理逻辑（用于已装用户清理残留 `code-reviewer.md`，防止双 source of truth）。
+- **`.github/workflows/ci.yml`** 删除 "Validate agents" 验证段（`agents/` 已删，验证空目录无意义）。
+
+### 补齐上游遗漏的根级文件
+
+- **`CLAUDE.md`** —— 上游 contributor 指南（含 anti-slop-PR 规则）的中文翻译，末尾追加中文 fork 自己的 PR 流程说明。
+- **`AGENTS.md`** —— 软链接 → `CLAUDE.md`（mode 120000，跟上游一致）。Codex CLI 等工具从 `AGENTS.md` 自动加载等同读取 CLAUDE.md。
+  - **Known limitation**：`npm pack` 默认不跟随 symlink，因此 npm publish 出来的 tarball 不包含 AGENTS.md。这不影响实际使用：AGENTS.md 是 Codex CLI 在用户自己项目目录读的文件，不是从 `superpowers-zh` 安装包读的；通过 `git clone` 拿到仓库的贡献者会正确解析 symlink。
+- **`RELEASE-NOTES.md`** —— 上游 release notes 原样保留（英文版，1180 行）。
+- **`RELEASE-NOTES.zh.md`** —— 本文件，中文 fork 自身 release 记录。
+- **`.codex-plugin/plugin.json`** —— Codex CLI plugin manifest（中文版本地化：name/description/displayName 改为中文版，URL 指向 `jnMetaCode/superpowers-zh`）。
+- **`.version-bump.json`** —— 上游版本管理配置文件。
+- **`scripts/bump-version.sh`** —— 上游版本同步脚本（含 `--check` 漂移检测、`--audit` 仓库审计）。中文版 npm version 钩子继续用 `scripts/sync-plugin-version.js`，bump-version.sh 作为补充工具引入。
+- **`assets/app-icon.png`** + **`assets/superpowers-small.svg`** —— Codex marketplace 需要的图标资产。
+- **4 个新增上游测试**：`tests/claude-code/test-requesting-code-review.sh`、`tests/claude-code/test-worktree-native-preference.sh`、`tests/opencode/test-bootstrap-caching.{mjs,sh}`。
+
+### 主动修复上游 v5.1.0 的疏忽
+
+- **`.cursor-plugin/plugin.json`** 删除 dangling 的 `"agents": "./agents/"` 和 `"commands": "./commands/"` 两行。上游 v5.1.0 删了目录但忘了同步清理 manifest（git blame 显示这两行从 2026-02-13 加入后从未更新）。中文 fork 主动修掉（向上游开 issue 是后续动作）。
+
+### 修中文版自己的老漂移（PR #23）
+
+- **`.claude-plugin/marketplace.json`** 的 `plugins[0].version` 卡在 `1.1.8` 的老漂移修复（追上其他 4 个 manifest，1.3.0 release 时统一升到 1.3.0）。原因是中文版简化版 `sync-plugin-version.js` 之前只 match 顶层 `"version":` 字段，跳过嵌套位置；导致 Claude Code marketplace 用户看到的 plugin 版本一直停在 1.1.8，跟 npm 包真实版本不同步。
+- **`scripts/sync-plugin-version.js`** 增强为支持嵌套字段路径（`plugins.0.version`）。`TARGETS` 改为对象数组 `{ path, field }`，对齐上游 `.version-bump.json` 格式。仍使用 regex 替换而非 JSON re-stringify，保留原文件格式（缩进、行内/多行数组等不被破坏）。
+
+### 不引入
+
+- 上游 `scripts/sync-to-codex-plugin.sh`（推 OpenAI Codex marketplace 用，硬编码 `prime-radiant-inc/openai-codex-plugins`，中文版用不上）
+- 配套测试 `tests/codex-plugin-sync/test-sync-to-codex-plugin.sh`
+
+### 不动（中文版叠加层全部保留）
+
+`bin/` + npx 流程、`docs/` 中文工具文档、4 个 `chinese-*` skill、`mcp-builder`、`workflow-runner`、`README.md` 主推 npx 路径、`.codex/INSTALL.md`、`.opencode/INSTALL.md`、`.gemini/`、`scripts/sync-plugin-version.js` —— 这些是符合"保持上游主流程不变 + 中文版叠加新增"原则的中文 fork 沉淀，全部保留。
+
+---
+
+## v1.2.1 (2026-05-05)
+
+### 修复
+
+- **`--uninstall` 数据丢失边界 case** —— 加哨兵注释 + 保守 fallback，杜绝在某些路径上误删用户数据。
+
+---
+
+## v1.2.0 (2026-05-05)
+
+### 新增
+
+- **`--uninstall` 子命令** —— `npx superpowers-zh --uninstall` 一条命令清理已安装的 skills（#17）。
+- **HOME 目录守护** —— uninstall 时强校验工作目录非用户 HOME，杜绝误删全局文件。
+- **计数显示修复** —— 安装后输出实际安装的 skill 数量（之前显示固定值）。
+
+---
+
+## v1.1.9 (2026-04-28)
+
+### 修复
+
+- **Claude Code bootstrap 修复** —— npx 安装到 CC 目标时自动补上 `CLAUDE.md` bootstrap，根治 skill 不触发问题（#14）。
+
+### 变更
+
+- **Node 引擎要求** 提升到 `>=20`（Node 14/16/18 均已 EOL）。
+- **README 重排**：相关项目表挪到显眼位置；姊妹项目区块独立成"相关项目生态"章节，重点推广 orchestrator。
+- **QQ 群** 标识改为 QQ 2群。
+
+---
+
+## v1.1.8 (2026-04-19)
+
+### 新增
+
+- **Claw Code 支持**（第 17 款工具，Rust 版 AI CLI）—— auto-detect `.claw/` 或 `CLAW.md`，支持 `--tool claw/claw-code/clawcode`。
+- **CNB（腾讯云原生构建）平台适配** —— `chinese-git-workflow` skill 新增 CNB 章节，含 `.cnb.yml` CI 示例（#6）。
+
+---
+
+## v1.1.0 – v1.1.7 早期开发（2026-03 ~ 2026-04）
+
+中文 fork 在这一时期完成了主要的多工具适配与中文化基建：
+
+- 第 1 款 → 第 16 款工具陆续上线：Claude Code、Cursor、Codex CLI、Gemini CLI、Trae、VS Code (Copilot)、Antigravity、Hermes Agent、Copilot CLI、Windsurf、Aider、OpenCode、Qwen Code（通义灵码）、Kiro、OpenClaw、DeerFlow 2.0
+- 4 个中国原创 skill 沉淀：`chinese-code-review`、`chinese-commit-conventions`、`chinese-documentation`、`chinese-git-workflow`
+- `mcp-builder`、`workflow-runner` 两个补充 skill
+- npx 一条命令自动检测项目工具并安装
+- 跨平台兼容性修复：Windows `cpSync` 问题、低版本 Node 兼容、Antigravity/Aider/Gemini CLI 自动生成 bootstrap
+
+---
+
+## v1.0.0 (2026-03-09)
+
+- 中文 fork 初始版本，基于上游 `obra/superpowers` v5.0.0 翻译。
+- 完整翻译 14 个上游 skill。
+- 首批支持 Claude Code 一种工具。

package/assets/superpowers-small.svg

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="UTF-8"?><svg id="Calque_1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path d="M394.28,207.8c.81,2.41,1.39,4.78,1.8,7.07,1.61,9.03-.93,17.78-5.99,21.74-22.6,17.7-49.85,29.35-75.34,38.6-.59.22-1.09.28-1.4.34-2.22.47-4.95,1.04-7.25,0-1.46-.66-2.25-1.74-2.66-2.3-1.56-2.1-1.59-4.31-1.56-5.13.1-2.67-.01-4.69,0-4.82.45-3.52.91-10.66,1.41-21.28.6-3.87,2.16-9.63,6.94-13.96,4.01-3.62,8.33-4.6,14.59-5.87,10.76-2.19,37.21-8.22,47.42-16.56,1.63-1.33,2.97-2.65,4.19-3.96,3.72-3.99,6.39-7.92,7.93-10.36,3.22,3.22,7.25,8.48,9.92,16.47Z"/><path d="M428.67,185.28c-2.33,11.99-8.91,22.32-15.88,30.38.27-5.5-.05-12.11-1.86-19.08-5.04-19.36-19.74-34.7-37.78-37.78-32.21-9.74-70.59,3.79-99.08,18.29-3.87,1.95-9.52-2.77-11.84-8.16-3.32-7.71-1.63-6.28,2.61-8.49,38.31-20.03,82.01-39.61,123.91-29.7,8.26,1.95,15.96,5.26,23.48,10.54,11.32,7.96,20.21,24.74,16.44,44Z"/><path d="M117.72,304.2c-.81-2.41-1.39-4.78-1.8-7.07-1.61-9.03.93-17.78,5.99-21.74,22.6-17.7,49.85-29.35,75.34-38.6.59-.22,1.09-.28,1.4-.34,2.22-.47,4.95-1.04,7.25,0,1.46.66,2.25,1.74,2.66,2.3,1.56,2.1,1.59,4.31,1.56,5.13-.1,2.67.01,4.69,0,4.82-.45,3.52-.91,10.66-1.41,21.28-.6,3.87-2.16,9.63-6.94,13.96-4.01,3.62-8.33,4.6-14.59,5.87-10.76,2.19-37.21,8.22-47.42,16.56-1.63,1.33-2.97,2.65-4.19,3.96-3.72,3.99-6.39,7.92-7.93,10.36-3.22-3.22-7.25-8.48-9.92-16.47Z"/><path d="M83.33,326.72c2.33-11.99,8.91-22.32,15.88-30.38-.27,5.5.05,12.11,1.86,19.08,5.04,19.36,19.74,34.7,37.78,37.78,32.21,9.74,70.59-3.79,99.08-18.29,3.87-1.95,9.52,2.77,11.84,8.16,3.32,7.71,1.63,6.28-2.61,8.49-38.31,20.03-82.01,39.61-123.91,29.7-8.26-1.95-15.96-5.26-23.48-10.54-11.32-7.96-20.21-24.74-16.44-44Z"/><ellipse cx="255.16" cy="258.86" rx="28.95" ry="28.76"/></svg>

package/bin/superpowers-zh.js

@@ -39,9 +39,13 @@ function copyDirSync(src, dest) {
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PKG = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf8'));
 const SKILLS_SRC = resolve(__dirname, '..', 'skills');
-const AGENTS_SRC = resolve(__dirname, '..', 'agents');
 const PROJECT_DIR = process.cwd();
 
+// 历史遗留 agent 文件名 — 用于 --uninstall 清理已装用户机器上的残留。
+// 上游 v5.1.0 把 agents/code-reviewer.md 上升进 requesting-code-review skill，
+// agents/ 目录已删，但旧版本装过的用户机器上仍有残留文件需要清理。
+const LEGACY_AGENT_FILENAMES = ['code-reviewer.md'];
+
 const TARGETS = [
   { name: 'Claude Code',   dir: '.claude/skills',           detect: '.claude' },
   { name: 'Cursor',        dir: '.cursor/skills',           detect: ['.cursor', '.cursorrules'] },
@@ -59,6 +63,7 @@ const TARGETS = [
   { name: 'Qwen Code',     dir: '.qwen/skills',             detect: '.qwen' },
   { name: 'Hermes Agent',  dir: '.hermes/skills',            detect: ['.hermes', 'HERMES.md', '.hermes.md'] },
   { name: 'Claw Code',     dir: '.claw/skills',              detect: ['.claw', 'CLAW.md'] },
+  { name: 'Qoder',         dir: '.qoder/skills',             detect: '.qoder' },
 ];
 
 function countDirs(dir) {
@@ -137,6 +142,51 @@ ${skillTable}
   console.log(`  ✅ Trae: bootstrap rule -> ${rulePath}`);
 }
 
+function generateQoderBootstrap(projectDir) {
+  const rulesDir = resolve(projectDir, '.qoder', 'rules');
+  mkdirSync(rulesDir, { recursive: true });
+
+  const skillEntries = scanSkillEntries(SKILLS_SRC);
+  const skillTable = skillEntries.map(s => `| ${s.name} | ${s.desc} |`).join('\n');
+
+  // Qoder rules schema（来源：社区实际样本，docs.qoder.com/zh/user-guide/rules 没公开）
+  // trigger: always_on  → "始终生效"，适用于所有智能会话和内联对话
+  // trigger: model_decision + description: ...  → 模型按描述自主决定
+  // trigger: manual  → 仅 @rule 手动触发
+  const rule = `---
+trigger: always_on
+alwaysApply: true
+---
+
+# Superpowers-ZH 中文增强版
+
+你已加载 superpowers-zh 技能框架（${skillEntries.length} 个 skills）。
+
+## 核心规则
+
+1. **收到任务时，先检查是否有匹配的 skill** — 哪怕只有 1% 的可能性也要检查
+2. **设计先于编码** — 收到功能需求时，先用 brainstorming skill 做需求分析
+3. **测试先于实现** — 写代码前先写测试（TDD）
+4. **验证先于完成** — 声称完成前必须运行验证命令
+
+## 可用 Skills
+
+Skills 位于 \`.qoder/skills/\` 目录，每个 skill 有独立的 \`SKILL.md\` 文件。
+
+| Skill | 触发条件 |
+|-------|---------|
+${skillTable}
+
+## 如何使用
+
+当任务匹配某个 skill 的触发条件时，读取对应的 \`.qoder/skills/<skill-name>/SKILL.md\` 并严格遵循其流程。也可输入 \`/<skill-name>\` 显式调用。
+`;
+
+  const rulePath = resolve(rulesDir, 'superpowers-zh.md');
+  writeFileSync(rulePath, rule, 'utf8');
+  console.log(`  ✅ Qoder: bootstrap rule -> ${rulePath}`);
+}
+
 function generateAntigravityBootstrap(projectDir) {
   const skillEntries = scanSkillEntries(SKILLS_SRC);
   const skillList = skillEntries.map(s => `- **${s.name}**: ${s.desc}`).join('\n');
@@ -381,6 +431,7 @@ const TOOL_ALIASES = {
   'claw':         'Claw Code',
   'claw-code':    'Claw Code',
   'clawcode':     'Claw Code',
+  'qoder':        'Qoder',
 };
 
 function showHelp() {
@@ -433,6 +484,10 @@ function installForTarget(target) {
     generateTraeBootstrapRule(PROJECT_DIR);
   }
 
+  if (target.name === 'Qoder') {
+    generateQoderBootstrap(PROJECT_DIR);
+  }
+
   if (target.name === 'Antigravity') {
     generateAntigravityBootstrap(PROJECT_DIR);
   }
@@ -451,11 +506,6 @@ function installForTarget(target) {
 
   if (target.name === 'Claude Code') {
     generateClaudeCodeBootstrap(PROJECT_DIR);
-    if (existsSync(AGENTS_SRC)) {
-      const agentsDest = resolve(PROJECT_DIR, '.claude', 'agents');
-      mkdirSync(agentsDest, { recursive: true });
-      copyDirSync(AGENTS_SRC, agentsDest);
-    }
   }
 }
 
@@ -470,6 +520,7 @@ function isHomeDir(p) {
 // 卸载支持：完整删除的 bootstrap 文件、需要清理段落的 bootstrap 文件
 const BOOTSTRAP_DELETE = [
   '.trae/rules/superpowers-zh.md',
+  '.qoder/rules/superpowers-zh.md',
   '.antigravity/rules.md',
 ];
 const BOOTSTRAP_CLEAN_SECTION = [
@@ -597,18 +648,18 @@ function uninstall() {
     }
   }
 
-  // 顺带清理 .claude/agents 下我们装过的 agent（agents 源是平铺的文件，例如 code-reviewer.md）
+  // 清理 .claude/agents 下旧版本装过的 legacy agent（v1.2.x 及之前会装 code-reviewer.md，
+  // v1.3.0 起跟随上游 v5.1.0 移除）。即使 agents/ 源目录已删，已装用户跑 --uninstall 仍应能清干净。
   const agentsDest = resolve(PROJECT_DIR, '.claude', 'agents');
-  if (existsSync(AGENTS_SRC) && existsSync(agentsDest)) {
-    const srcAgentNames = new Set(readdirSync(AGENTS_SRC).filter(n => n !== '.DS_Store'));
+  if (existsSync(agentsDest)) {
     let agentsRemoved = 0;
     for (const entry of readdirSync(agentsDest)) {
-      if (srcAgentNames.has(entry)) {
+      if (LEGACY_AGENT_FILENAMES.includes(entry)) {
         rmSync(resolve(agentsDest, entry), { recursive: true, force: true });
         agentsRemoved++;
       }
     }
-    if (agentsRemoved > 0) console.log(`  ✅ Claude Code agents: 移除 ${agentsRemoved} 个 -> ${agentsDest}`);
+    if (agentsRemoved > 0) console.log(`  ✅ Claude Code agents: 移除 ${agentsRemoved} 个旧版残留 -> ${agentsDest}`);
     try {
       const left = readdirSync(agentsDest).filter(n => n !== '.DS_Store');
       if (left.length === 0) rmSync(agentsDest, { recursive: true, force: true });
@@ -709,13 +760,6 @@ function install(forceToolName, force) {
     console.log(`  ✅ 默认安装: ${countDirs(dest)} 个 skills -> ${dest}`);
 
     generateClaudeCodeBootstrap(PROJECT_DIR);
-
-    if (existsSync(AGENTS_SRC)) {
-      const agentsDest = resolve(PROJECT_DIR, '.claude', 'agents');
-      mkdirSync(agentsDest, { recursive: true });
-      copyDirSync(AGENTS_SRC, agentsDest);
-      console.log(`  ✅ 默认安装: agents -> ${agentsDest}`);
-    }
   }
 
   console.log('\n  安装完成！重启你的 AI 编程工具即可生效。\n');

package/docs/README.openclaw.md

@@ -62,11 +62,14 @@ OpenClaw 与 Claude Code 使用相同的工具名称，skills 无需额外适配
 
 ## 使用
 
-安装完成后重启 OpenClaw，所有 skills 会自动生效。你可以：
+安装完成后重启 OpenClaw，所有 skills 会自动生效。AI 会按任务上下文自动调用对应 skill：
 
-- 输入 `/brainstorming` 开始头脑风暴
-- 输入 `/commit` 使用中文提交规范
-- 在任何编码任务中，skills 会被自动调用
+- 新任务 / 新功能 → `brainstorming`（头脑风暴）
+- 写 commit message → `chinese-commit-conventions`（中文 commit 规范）
+- 调试问题 → `systematic-debugging`
+- 完成任务后 → `requesting-code-review`（请求代码审查）
+
+无需手动 slash command 触发 —— AI 通过 skill frontmatter 的 `description` 字段自主选择匹配的 skill。如果想强制触发某个 skill，直接在指令里点名："用 brainstorming 帮我想一下 X 怎么做"。
 
 ## 全局 Skills
 

package/docs/README.qoder.md

@@ -0,0 +1,95 @@
+# Superpowers 中文版 — Qoder 安装指南
+
+在 [Qoder](https://qoder.com)（阿里推出的 AI IDE）中使用 superpowers-zh 的完整指南。
+
+## 自动安装
+
+```bash
+cd /your/project
+npx superpowers-zh
+```
+
+安装脚本会自动检测 `.qoder/` 目录并：
+
+1. 把 20 个 skills 复制到 `.qoder/skills/<name>/SKILL.md`
+2. 生成一个**始终生效**的 bootstrap rule `.qoder/rules/superpowers-zh.md`（`trigger: always_on`），让 Qoder 每个会话都加载核心规则与 skill 索引
+
+如果项目目录里还没有 `.qoder/`，可以显式指定：
+
+```bash
+npx superpowers-zh --tool qoder
+```
+
+## 手动安装
+
+```bash
+git clone https://github.com/jnMetaCode/superpowers-zh.git
+cp -r superpowers-zh/skills /your/project/.qoder/skills
+```
+
+或全局安装（对所有项目生效）：
+
+```bash
+cp -r superpowers-zh/skills ~/.qoder/skills
+```
+
+## Skill 加载优先级
+
+| 位置 | 优先级 | 说明 |
+|------|--------|------|
+| `.qoder/skills/` | 最高 | 项目级，仅当前项目 |
+| `~/.qoder/skills/` | 中 | 用户级，所有项目共享 |
+
+> 同名 skill 项目级覆盖用户级。
+
+## 使用
+
+1. 安装完成后**重启 Qoder**
+2. 在对话框输入 `/` 即可看到已加载的 skills 列表
+3. bootstrap rule（`.qoder/rules/superpowers-zh.md`）会被 Qoder 识别为"始终生效"，每个会话自动加载核心规则
+4. Qoder 还会根据 skill 的 `description` 自动判断何时调用；也可输入 `/<skill-name>` 手动触发
+
+> Qoder Rules schema（`trigger: always_on` / `model_decision` / `manual`）来自社区实际样本，官方文档（docs.qoder.com/zh/user-guide/rules）目前只公开 UI 配置流程未公开 frontmatter schema。如果 Qoder 后续改了 schema，rule 文件可能需要打开 Qoder Settings → Rules 重新选择类型。
+
+## 工具映射说明
+
+skills 中引用的 Claude Code 工具名称（`Read` / `Write` / `Edit` / `Bash` / `Grep` / `Glob` / `WebFetch` / `WebSearch` 等）在 Qoder 中**同名对应**，无需额外映射。
+
+少数差异：
+
+| Claude Code | Qoder 等价 |
+|-------------|-----------|
+| `EnterPlanMode` / `ExitPlanMode` | `EnterSpecMode` / `ExitSpecMode` |
+| `Task`（子 agent） | `Task`（支持 `explore-agent` / `plan-agent` / `qoder-guide` 等 agent 类型）|
+| `TodoWrite` | `TodoWrite` |
+
+> Skill 是工作方法论，不是工具实现 —— 即使工具名略有差异，模型也会自动选用最近似的 Qoder 工具完成。无需为 Qoder 重写 skill。
+
+## 故障排查
+
+### 装好了但 `/` 看不到 skills
+
+1. 确认 `.qoder/skills/<skill-name>/SKILL.md` 文件存在
+2. 确认 `SKILL.md` 文件的 frontmatter 完整（`name` + `description`，`description` 不超过 1024 字符）
+3. **必须重启 Qoder** —— 新装的 skill 不会热加载
+
+### skill 不被自动调用
+
+Qoder 按 description 文本匹配用户意图来决定何时调用 skill。如果某个 skill 自动调用不可靠，可在对话中显式输入 `/<skill-name>` 手动触发。
+
+中国原创的 4 个 `chinese-*` skill 本身就是**手动触发**设计（避免污染上游 skill 的自动调度），需要显式 `/chinese-code-review` / `/chinese-commit-conventions` 等。
+
+## 卸载
+
+```bash
+cd /your/project
+npx superpowers-zh --uninstall
+```
+
+会移除 `.qoder/skills/` 目录下所有 superpowers-zh 装的 skill 文件夹（保留你自己写的）。
+
+## 获取帮助
+
+- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
+- 项目主页：https://github.com/jnMetaCode/superpowers-zh
+- Qoder 官方文档：https://docs.qoder.com/zh/extensions/skills

package/docs/README.trae.md

@@ -56,6 +56,17 @@ cd /your/project
 npx superpowers-zh
 ```
 
+## 卸载 / 误装清理
+
+如果不小心在主目录（`~`）误跑了 `npx superpowers-zh`，会把 skills 和 `.trae/rules/superpowers-zh.md` 写到你的 home。v1.2.1 起会主动拒绝，但老版本可能已经污染过。清理：
+
+```bash
+cd ~                                    # 或具体的项目目录
+npx superpowers-zh@latest --uninstall
+```
+
+会删除 `.trae/skills/` 下装过的 skill、`.trae/rules/superpowers-zh.md`，并清理 `CLAUDE.md` 等文件里的 superpowers-zh 段（保留你自己写的内容）。
+
 ## 获取帮助
 
 - 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "superpowers-zh",
   "description": "AI 编程超能力中文版 — TDD、调试、代码审查等经过实战验证的工作方法论",
-  "version": "1.1.6",
+  "version": "1.5.0",
   "contextFileName": "GEMINI.md"
 }

package/hooks/hooks-cursor.json

@@ -3,7 +3,7 @@
   "hooks": {
     "sessionStart": [
       {
-        "command": "./hooks/session-start"
+        "command": "./hooks/run-hook.cmd session-start"
       }
     ]
   }

package/package.json

@@ -1,27 +1,33 @@
 {
   "name": "superpowers-zh",
-  "version": "1.2.1",
+  "version": "1.5.0",
   "engines": {
     "node": ">=20.0.0"
   },
-  "description": "AI 编程超能力中文增强版 — superpowers（99k+ ⭐）完整汉化 + 6 个中国原创 skills，支持 Claude Code / Copilot CLI / Hermes Agent / Cursor / Claw Code / Windsurf / Kiro / Gemini CLI 等 17 款工具",
+  "description": "AI 编程超能力中文增强版 — superpowers（159k+ ⭐）完整汉化 + 4 个中国原创 skills，支持 Claude Code / Copilot CLI / Hermes Agent / Cursor / Claw Code / Windsurf / Kiro / Gemini CLI / Qoder 等 18 款工具",
   "type": "module",
   "main": ".opencode/plugins/superpowers.js",
   "bin": {
     "superpowers-zh": "bin/superpowers-zh.js"
   },
+  "scripts": {
+    "version": "node scripts/sync-plugin-version.js && git add .claude-plugin/plugin.json .claude-plugin/marketplace.json .cursor-plugin/plugin.json .codex-plugin/plugin.json gemini-extension.json"
+  },
   "files": [
     "bin/",
     "skills/",
-    "agents/",
-    "commands/",
     "hooks/",
+    "assets/",
     ".claude-plugin/",
     ".cursor-plugin/",
     ".codex/INSTALL.md",
+    ".codex-plugin/",
     ".opencode/INSTALL.md",
     ".opencode/plugins/",
+    "CLAUDE.md",
     "GEMINI.md",
+    "RELEASE-NOTES.md",
+    "RELEASE-NOTES.zh.md",
     "gemini-extension.json",
     "docs/",
     "README.md",
@@ -47,6 +53,7 @@
     "hermes",
     "hermes-agent",
     "claw-code",
+    "qoder",
     "ai-coding",
     "skills",
     "chinese",