在 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 qodergit clone https://github.com/jnMetaCode/superpowers-zh.git
cp -r superpowers-zh/skills /your/project/.qoder/skills或全局安装(对所有项目生效):
cp -r superpowers-zh/skills ~/.qoder/skills| 位置 | 优先级 | 说明 |
|---|---|---|
.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。
- 确认
.qoder/skills/<skill-name>/SKILL.md文件存在 - 确认
SKILL.md文件的 frontmatter 完整(name+description,description不超过 1024 字符) - 必须重启 Qoder —— 新装的 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 文件夹(保留你自己写的)。