725977b422
closes #26, closes #34 ## 改动 - bin/superpowers-zh.js: TARGETS 加 Qoder (`.qoder/skills`, detect `.qoder`)， TOOL_ALIASES 加 `qoder`，新增 `generateQoderBootstrap()` 生成 `.qoder/rules/superpowers-zh.md`（`trigger: always_on` + `alwaysApply: true`） - scripts/audit.sh: TOOLS 加 qoder，17→18 - 3 个 plugin manifest（.claude-plugin/{plugin,marketplace}.json、.cursor-plugin/plugin.json） description 同步到 18 款 - README、CLAUDE.md、package.json 文案对齐 18 - docs/README.qoder.md: 新增完整安装/使用/卸载指南，附 schema 说明 ## 设计要点 Qoder Rules 的 frontmatter schema（`trigger: always_on` / `model_decision` / `manual`）官方 docs.qoder.com/zh/user-guide/rules 未公开，来自 GitHub 上 4 份真实社区样本（python-office、termiClaude、QoderTest、TelegramFileServer） 的交叉验证。 按 Trae 模式生成 always_on bootstrap 而非 Cursor/Windsurf 的"裸 skill"模式， 是为了确保核心规则（先 brainstorming / 先 TDD / 先验证）在每个会话都自动加载， 不依赖模型对 description 文本的隐式匹配。 ## 验证 - 端到端：--tool qoder 装、自动检测、二次幂等、卸载（20 skills + 1 bootstrap 全部清掉，0 残留） - bootstrap 文件 skill 列表（20）与实际 skills/ 目录数（20）一致 - 全量 audit: 96 PASS / 0 FAIL（18 款工具完整 install + 幂等 + uninstall 跑通）
3.5 KiB
Superpowers 中文版 — Qoder 安装指南
在 Qoder（阿里推出的 AI IDE）中使用 superpowers-zh 的完整指南。
自动安装
cd /your/project
npx superpowers-zh
安装脚本会自动检测 .qoder/ 目录并：
- 把 20 个 skills 复制到
.qoder/skills/<name>/SKILL.md - 生成一个始终生效的 bootstrap rule
.qoder/rules/superpowers-zh.md（trigger: always_on），让 Qoder 每个会话都加载核心规则与 skill 索引
如果项目目录里还没有 .qoder/，可以显式指定：
npx superpowers-zh --tool qoder
手动安装
git clone https://github.com/jnMetaCode/superpowers-zh.git
cp -r superpowers-zh/skills /your/project/.qoder/skills
或全局安装（对所有项目生效）：
cp -r superpowers-zh/skills ~/.qoder/skills
Skill 加载优先级
| 位置 | 优先级 | 说明 |
|---|---|---|
.qoder/skills/ |
最高 | 项目级，仅当前项目 |
~/.qoder/skills/ |
中 | 用户级，所有项目共享 |
同名 skill 项目级覆盖用户级。
使用
- 安装完成后重启 Qoder
- 在对话框输入
/即可看到已加载的 skills 列表 - bootstrap rule（
.qoder/rules/superpowers-zh.md）会被 Qoder 识别为"始终生效"，每个会话自动加载核心规则 - Qoder 还会根据 skill 的
description自动判断何时调用；也可输入/<skill-name>手动触发
Qoder Rules schema（
trigger: always_on/model_decision/manual）来自社区实际样本，官方文档（docs.qoder.com/zh/user-guide/rules）目前只公开 UI 配置流程未公开 frontmatter schema。如果 Qoder 后续改了 schema，rule 文件可能需要打开 Qoder Settings → Rules 重新选择类型。
工具映射说明
skills 中引用的 Claude Code 工具名称（Read / Write / Edit / Bash / Grep / Glob / WebFetch / WebSearch 等）在 Qoder 中同名对应，无需额外映射。
少数差异：
| Claude Code | Qoder 等价 |
|---|---|
EnterPlanMode / ExitPlanMode |
EnterSpecMode / ExitSpecMode |
Task（子 agent） |
Task（支持 explore-agent / plan-agent / qoder-guide 等 agent 类型） |
TodoWrite |
TodoWrite |
Skill 是工作方法论，不是工具实现 —— 即使工具名略有差异，模型也会自动选用最近似的 Qoder 工具完成。无需为 Qoder 重写 skill。
故障排查
装好了但 / 看不到 skills
- 确认
.qoder/skills/<skill-name>/SKILL.md文件存在 - 确认
SKILL.md文件的 frontmatter 完整（name+description，description不超过 1024 字符） - 必须重启 Qoder —— 新装的 skill 不会热加载
skill 不被自动调用
Qoder 按 description 文本匹配用户意图来决定何时调用 skill。如果某个 skill 自动调用不可靠，可在对话中显式输入 /<skill-name> 手动触发。
中国原创的 4 个 chinese-* skill 本身就是手动触发设计（避免污染上游 skill 的自动调度），需要显式 /chinese-code-review / /chinese-commit-conventions 等。
卸载
cd /your/project
npx superpowers-zh --uninstall
会移除 .qoder/skills/ 目录下所有 superpowers-zh 装的 skill 文件夹（保留你自己写的）。