AI 原生开放教材

外观

superpowers-zh（AI 编程超能力 · 中文增强版）技能与配置库·中文原文 ↗原件 ↓仓库 ↗

v1.5.0 (2026-05-21) ​

🆕 Qoder 适配（第 18 款工具，#26、#34） ​

Qoder 是阿里推出的 AI IDE，社区有多个用户提需求要求支持。本版本完成端到端适配：

  • bin/superpowers-zh.js — TARGETS 加 Qoder（dir: .qoder/skills，detect: .qoder），TOOL_ALIASES 加 qoder
  • generateQoderBootstrap() — 生成 .qoder/rules/superpowers-zh.md（trigger: always_on + alwaysApply: true），让"先头脑风暴 / 先 TDD / 先验证"等核心规则每个会话自动加载，不依赖模型对 description 的隐式匹配
  • skills/using-superpowers/references/qoder-tools.md — 新增工具映射 reference（Qoder 大部分工具与 Claude Code 同名，只有 EnterPlanMode/ExitPlanMode → EnterSpecMode/ExitSpecMode 一个差异；附 Quest MCP 工具清单）
  • docs/README.qoder.md — 完整安装/使用/卸载/故障排查指南
  • scripts/audit.sh — TOOLS 数组加 qoder，CI 自动跑 18 款工具的 install/idempotent/uninstall 回归

安装方法：

bash
cd /your/qoder-project
npx superpowers-zh --tool qoder     # 显式
# 或在有 .qoder/ 的项目里：
npx superpowers-zh                  # 自动检测

装完重启 Qoder，输入 / 即可看到 20 个 skill。

⚠️ Qoder Rules schema 来源说明 ​

Qoder Rules 的 frontmatter schema（trigger: always_on / model_decision / manual）官方文档（docs.qoder.com/zh/user-guide/rules）目前未公开。本次实现的 schema 来自 GitHub 上 4 份真实社区样本（python-office、termiClaude、QoderTest、TelegramFileServer）的交叉验证。

如果 Qoder 后续改了 schema，生成的 rule 文件可能需要打开 Qoder Settings → Rules 重新选择"始终生效"类型。

🔧 文案对齐 ​

  • README、CLAUDE.md、package.json description：17 款 → 18 款
  • 3 个 plugin manifest（.claude-plugin/\{plugin,marketplace\}.json、.cursor-plugin/plugin.json）description 同步

设计取舍：为什么用 always_on bootstrap 而非裸 skill ​

社区有用户（@Yanyz-ok）建议"按 AI 编程工具拆分/重写 skill"。我们刻意不走这条路：

  1. skill 是工作方法论，不是工具实现 —— "先写测试再写代码"这个约束在 Claude Code、Qoder、Hermes 上落地工具不同，但方法论不变。重写会让 17 份 SKILL.md 维护负担 ×17 但本质增量 0。
  2. 平台内置工具 vs skill 是嵌套关系，不是替代关系 —— Qoder/Quest 的 search_codebase、update_memory 解决"怎么做"，skill 解决"什么时候做"，模型不会混淆。
  3. 上游 superpowers 明确禁止"无 eval 证据的工具专属重写" —— fork 守同样规矩。

工具映射写在 references/qoder-tools.md + docs/README.qoder.md 里就够了，不需要每个 skill 内部复制一遍。详见 issue #26 完整讨论。

Refs ​

  • closes #26（建议新增 qoder 的支持）
  • closes #34（建议支持 qoder，#26 重复）