mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-03 07:23:56 +08:00
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 跑通）
Superpowers 中文版 — Windsurf 安装指南
在 Windsurf 中使用 superpowers-zh 的完整指南。
自动安装
cd /your/project
npx superpowers-zh
安装脚本会自动检测 .windsurf/ 目录并将 skills 复制到 .windsurf/skills/ 目录。
手动安装
git clone https://github.com/jnMetaCode/superpowers-zh.git
cp -r superpowers-zh/skills /your/project/.windsurf/skills
或全局安装：
cp -r superpowers-zh/skills ~/.windsurf/skills
Skill 加载优先级
| 位置 | 优先级 | 说明 |
|---|---|---|
.windsurf/skills/ |
最高 | 项目级，仅当前项目 |
~/.windsurf/skills/ |
中 | 用户级，所有项目共享 |
使用
安装完成后重启 Windsurf，skills 会自动生效。
也可以在 .windsurfrules 文件中引用 skills 目录：
请参考 .windsurf/skills/ 目录中的 SKILL.md 文件作为工作方法论。
故障排查
Skills 未生效
- 确认
.windsurf/skills/目录存在且包含 skill 文件夹 - 每个 skill 需要包含有效 YAML frontmatter 的
SKILL.md文件 - 重启 Windsurf