From d544eb5505026e0c1f01b8feef7ed4ab4c0623ac Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?AI=E4=B8=8D=E6=AD=A2=E8=AF=AD?= <12096460+jnMetaCode@users.noreply.github.com> Date: Wed, 12 Aug 2026 17:08:54 +0800 Subject: [PATCH] =?UTF-8?q?fix(refs):=20qoder-tools.md=20=E7=9A=84=20subag?= =?UTF-8?q?ent=20=E8=A1=A8=E6=9C=89=E9=94=99=E4=B8=94=E6=9C=AA=E6=A0=87?= =?UTF-8?q?=E9=80=82=E7=94=A8=E8=8C=83=E5=9B=B4=EF=BC=88#119=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## 起因 #119 报告：Qoder IDE 里跑 subagent-driven-development，Qoder 说它只有 CodeReview subagent、没有 general-purpose。查我们自己的 qoder-tools.md， 第 21 行白纸黑字写着 general-purpose 存在。 查 3202b18（该文件的引入 commit）—— **没有引用任何来源**，那张 agent 类型表 是我们自己写的。这跟 #45 的 Hermes 是同一类问题：断言了一个没核实过的能力。 ## 逐条核对官方文档后的结果 对照 docs.qoder.com/zh/cli/subagent，表里 4 行错了 2 行： | 原写法 | 文档实际 | |-----------------------------|--------------------| | Explore -> explore-agent | Explore（同名） | | Plan -> plan-agent | Plan（同名） | | general-purpose | ✅ 确实存在 | | claude-code-guide -> qoder-guide | ✅ 确实存在 | 另外「Qoder 额外有 browser-agent、code-reviewer、design-agent」这句：文档里 **没有内置的 code-reviewer**（出现的 api-reviewer 是用户自建 subagent 的示例）， 另两个也查无实据。已删掉，改为指向 requesting-code-review 的模板。 ## 最关键的一处：表根本没标适用范围 官方 subagent 文档只覆盖 **Qoder CLI**，没有说这套内置集合同样适用于 **Qoder IDE**。而我们的表不带任何产品面标注，IDE 用户读它就当成了权威。 #119 报的正是 IDE 上的情况。 已加：适用范围标注（Qoder CLI）、来源链接、核对日期，以及一节说明 IDE 与 CLI 的差异 —— 并明确告诉用户 IDE 上「找不到 general-purpose」是预期内差异、 不是装错了，Qoder 的自动降级本身是合理适配。 ## 范围 qoder-tools.md 是 fork 自有文件（上游没有），零上游偏离。 文件上半部分的工具名对照表（Read/Write/Bash/EnterSpecMode 等）同样没有出处， 本次未动 —— 没有证据就不改，已在 issue 里说明这是已知的遗留风险。 audit.sh 166 pass / 0 warn / 0 fail --- .../references/qoder-tools.md | 23 +++++++++++++------ 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/skills/using-superpowers/references/qoder-tools.md b/skills/using-superpowers/references/qoder-tools.md index eaa9af5..8d96eb9 100644 --- a/skills/using-superpowers/references/qoder-tools.md +++ b/skills/using-superpowers/references/qoder-tools.md @@ -16,14 +16,23 @@ Skills 使用 Claude Code 的工具名称。Qoder（阿里 AI IDE）大部分工 ## Task 子 Agent 类型 -| Claude Code Agent | Qoder 等价 | -|------------------|-----------| -| `general-purpose` | `general-purpose` | -| `Explore` | `explore-agent` | -| `Plan` | `plan-agent` | -| `claude-code-guide` | `qoder-guide` | +> **适用范围：Qoder CLI。** 下表逐条核对自 [Qoder 官方文档 · 子代理](https://docs.qoder.com/zh/cli/subagent)（核对于 2026-08）。 +> **Qoder IDE 的内置 subagent 集合与此不同，我们尚未核实** —— 见下方「IDE 与 CLI 的差异」。 -Qoder 额外有 `browser-agent`、`code-reviewer`、`design-agent` 等专用 agent，依任务匹配选用。 +| Claude Code Agent | Qoder CLI 等价 | 说明 | +|------------------|---------------|------| +| `general-purpose` | `general-purpose` | 通用研究型，适合复杂搜索、多文件分析、调用链追踪、多步骤任务 | +| `Explore` | `Explore` | 同名。只读代码探索 | +| `Plan` | `Plan` | 同名。只读设计与规划 | +| `claude-code-guide` | `qoder-guide` | 非 SDK 模式下可用 | + +文档另列出 `statusline-setup`（TUI 模式）。**没有内置的 `code-reviewer`** —— 文档里出现的 `api-reviewer` 是用户自建 subagent 的示例，不是内置项。需要专职审查者时，用 `general-purpose` 配 `superpowers:requesting-code-review` 的 `code-reviewer.md` 模板。 + +### IDE 与 CLI 的差异 + +[#119](https://github.com/jnMetaCode/superpowers-zh/issues/119) 报告：在 **Qoder IDE** 里跑 `subagent-driven-development` 时，Qoder 说它只提供 `CodeReview` subagent、**没有** `general-purpose`，于是自行降级为「控制者直接实现 + CodeReview agent 做审查」。 + +官方 subagent 文档只覆盖 CLI，没有说这套内置集合同样适用于 IDE。**所以上表在 Qoder IDE 上不保证成立。** 如果你在 IDE 里遇到「找不到 general-purpose」，那是预期内的差异，不是 superpowers-zh 装错了 —— Qoder 的自动降级本身是合理适配。 ## Quest MCP 工具（Qoder 原生）