fix(refs): qoder-tools.md 的 subagent 表有错且未标适用范围(#119)

## 起因

#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
This commit is contained in:
AI不止语
2026-08-12 17:08:54 +08:00
parent 0ffaf5bced
commit d544eb5505

View File

@@ -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 原生)