superpowers-zh

mirror of https://github.com/jnMetaCode/superpowers-zh.git synced 2026-09-02 22:54:06 +08:00

Files

AI不止语 d544eb5505 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

2026-08-12 17:08:54 +08:00

brainstorming

refactor(skills): 同步上游 C 块 —— 说服性段落改为 rationalization 表（#19 收尾）

2026-08-08 00:21:39 +08:00

chinese-code-review

fix: add version, license, and metadata.hermes.tags to all 20 skills (#49 )

2026-06-17 06:45:05 +08:00

chinese-commit-conventions

fix: add version, license, and metadata.hermes.tags to all 20 skills (#49 )

2026-06-17 06:45:05 +08:00

chinese-documentation

fix: add version, license, and metadata.hermes.tags to all 20 skills (#49 )