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

Files

AI不止语 725977b422 feat: 加 Qoder 适配（第 18 款工具）— skills + always_on bootstrap rule

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 跑通）

2026-05-21 00:56:18 +08:00

3.5 KiB

Raw Blame History

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 文件夹（保留你自己写的）。

获取帮助

提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
项目主页：https://github.com/jnMetaCode/superpowers-zh
Qoder 官方文档：https://docs.qoder.com/zh/extensions/skills

3.5 KiB Raw Blame History Unescape Escape