diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 59e4660..ad382ee 100644
--- 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",
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index c1b26e4..a50f128 100644
--- 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"
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index 0daf6d2..082c620 100644
--- 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",
diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
index 709f4ba..e575739 100644
--- 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"
diff --git a/RELEASE-NOTES.zh.md b/RELEASE-NOTES.zh.md
index fb9689d..b78664e 100644
--- 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 缺陷**。改动全部是"主站有的同步过来"性质，不引入主站没有的新功能。
diff --git a/gemini-extension.json b/gemini-extension.json
index dd98b2b..67e6d33 100644
--- 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"
 }
diff --git a/package.json b/package.json
index dcae01f..b7d7944 100644
--- 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"
   },
diff --git a/skills/using-superpowers/SKILL.md b/skills/using-superpowers/SKILL.md
index 65ed418..d452621 100644
--- 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 自动获得工具映射。
 
 # 使用技能
 
diff --git a/skills/using-superpowers/references/qoder-tools.md b/skills/using-superpowers/references/qoder-tools.md
new file mode 100644
index 0000000..eaa9af5
--- /dev/null
+++ 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>` 手动触发。