chore: release v1.5.0 — Qoder 适配 + qoder-tools.md ref

- package.json + 5 个 plugin manifest: 1.4.0 → 1.5.0 - RELEASE-NOTES.zh.md: 新增 v1.5.0 段，描述 Qoder 适配、Rules schema 来源说明、设计取舍 - skills/using-superpowers/references/qoder-tools.md: 新增工具映射 ref （Qoder 大部分工具同名 CC，仅 EnterPlanMode → EnterSpecMode 差异；附 Task agent 类型表 + Quest MCP 工具清单） - skills/using-superpowers/SKILL.md 第 42 行: 平台适配段加 Qoder ref 引用发版前验证： - 6 处版本号全部 1.5.0 - 18 款工具 install + 二次幂等 + uninstall 全跑通 - bootstrap 工具（Qoder + Trae）rule 文件内容正确写入与卸载清理 - audit 96 PASS / 0 FAIL - npm pack --dry-run 确认 docs/README.qoder.md + qoder-tools.md 入包
2026-09-03 07:23:56 +08:00 · 2026-05-21 05:56:56 +08:00
parent 725977b422
commit 3202b18e43
9 changed files with 101 additions and 7 deletions
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -9,7 +9,7 @@
    {
      "name": "superpowers-zh",
      "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 18 款工具",
-      "version": "1.4.0",
+      "version": "1.5.0",
      "source": "./",
      "author": {
        "name": "jnMetaCode",
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
  "name": "superpowers-zh",
  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 18 款工具",
-  "version": "1.4.0",
+  "version": "1.5.0",
  "author": {
    "name": "jnMetaCode",
    "url": "https://github.com/jnMetaCode"
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
  "name": "superpowers-zh",
-  "version": "1.4.0",
+  "version": "1.5.0",
  "description": "AI 编程超能力中文增强版：头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流，附 4 个中文 skills 沉淀。",
  "author": {
    "name": "jnMetaCode",
--- a/.cursor-plugin/plugin.json
+++ b/.cursor-plugin/plugin.json
@@ -2,7 +2,7 @@
  "name": "superpowers-zh",
  "displayName": "Superpowers 中文版",
  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 18 款工具",
-  "version": "1.4.0",
+  "version": "1.5.0",
  "author": {
    "name": "jnMetaCode",
    "url": "https://github.com/jnMetaCode"
--- a/RELEASE-NOTES.zh.md
+++ b/RELEASE-NOTES.zh.md
@@ -6,6 +6,57 @@

 ---

+## 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 缺陷**。改动全部是"主站有的同步过来"性质，不引入主站没有的新功能。
--- a/gemini-extension.json
+++ b/gemini-extension.json
@@ -1,6 +1,6 @@
 {
  "name": "superpowers-zh",
  "description": "AI 编程超能力中文版 — TDD、调试、代码审查等经过实战验证的工作方法论",
-  "version": "1.4.0",
+  "version": "1.5.0",
  "contextFileName": "GEMINI.md"
 }
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "superpowers-zh",
-  "version": "1.4.0",
+  "version": "1.5.0",
  "engines": {
    "node": ">=20.0.0"
  },
--- a/skills/using-superpowers/SKILL.md
+++ b/skills/using-superpowers/SKILL.md
@@ -39,7 +39,7 @@ Superpowers 技能覆盖默认系统提示行为，但**用户指令始终具有

 ## 平台适配

-技能使用 Claude Code 的工具名称。非 CC 平台：查看 `references/copilot-tools.md`（Copilot CLI）、`references/hermes-tools.md`（Hermes Agent）、`references/codex-tools.md`（Codex）了解工具对应关系。Gemini CLI 用户通过 GEMINI.md 自动获得工具映射。
+技能使用 Claude Code 的工具名称。非 CC 平台：查看 `references/copilot-tools.md`（Copilot CLI）、`references/hermes-tools.md`（Hermes Agent）、`references/codex-tools.md`（Codex）、`references/qoder-tools.md`（Qoder）了解工具对应关系。Gemini CLI 用户通过 GEMINI.md 自动获得工具映射。

 # 使用技能

--- a/skills/using-superpowers/references/qoder-tools.md
+++ b/skills/using-superpowers/references/qoder-tools.md
@@ -0,0 +1,43 @@
+# Qoder 工具映射
+
+Skills 使用 Claude Code 的工具名称。Qoder（阿里 AI IDE）大部分工具与 Claude Code **同名**，只有少数差异：
+
+| Skill 中的引用 | Qoder 等价工具 |
+|---------------|---------------|
+| `Read` / `Write` / `Edit` | 同名（`Read` / `Write` / `Edit`） |
+| `Bash` | 同名 |
+| `Grep` / `Glob` | 同名 |
+| `Task`（派遣子 agent） | 同名（`Task`） |
+| `WebFetch` / `WebSearch` | 同名 |
+| `AskUserQuestion` | 同名 |
+| `Skill` | 同名 |
+| `TodoWrite` | 同名 |
+| `EnterPlanMode` / `ExitPlanMode` | **`EnterSpecMode` / `ExitSpecMode`**（Qoder 把"计划模式"称为"Spec 模式"）|
+
+## Task 子 Agent 类型
+
+| Claude Code Agent | Qoder 等价 |
+|------------------|-----------|
+| `general-purpose` | `general-purpose` |
+| `Explore` | `explore-agent` |
+| `Plan` | `plan-agent` |
+| `claude-code-guide` | `qoder-guide` |
+
+Qoder 额外有 `browser-agent`、`code-reviewer`、`design-agent` 等专用 agent，依任务匹配选用。
+
+## Quest MCP 工具（Qoder 原生）
+
+Qoder 内置 Quest 系统提供以下工具，Claude Code 没有等价物，可在 skill 流程中直接调用：
+
+| 工具 | 用途 |
+|------|------|
+| `mcp__quest__search_codebase` | 语义化代码搜索（按意图找代码） |
+| `mcp__quest__search_symbol` | 按符号名搜索代码及关系 |
+| `mcp__quest__get_problems` | 获取文件编译/语法错误 |
+| `mcp__quest__run_preview` | 启动本地 Web 服务器预览 |
+| `mcp__quest__search_memory` / `update_memory` | 跨会话记忆管理 |
+| `mcp__quest__fetch_rules` | 查询规则文件 |
+
+## 加载方式
+
+Qoder 在每个会话自动加载 `.qoder/rules/superpowers-zh.md`（`trigger: always_on`），里面包含 skill 索引。`.qoder/skills/<name>/SKILL.md` 由模型按 description 自主调用，也可输入 `/<skill-name>` 手动触发。