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 跑通）
96 lines
3.5 KiB
Markdown
96 lines
3.5 KiB
Markdown
# Superpowers 中文版 — Qoder 安装指南
|
||
|
||
在 [Qoder](https://qoder.com)（阿里推出的 AI IDE）中使用 superpowers-zh 的完整指南。
|
||
|
||
## 自动安装
|
||
|
||
```bash
|
||
cd /your/project
|
||
npx superpowers-zh
|
||
```
|
||
|
||
安装脚本会自动检测 `.qoder/` 目录并：
|
||
|
||
1. 把 20 个 skills 复制到 `.qoder/skills/<name>/SKILL.md`
|
||
2. 生成一个**始终生效**的 bootstrap rule `.qoder/rules/superpowers-zh.md`（`trigger: always_on`），让 Qoder 每个会话都加载核心规则与 skill 索引
|
||
|
||
如果项目目录里还没有 `.qoder/`，可以显式指定：
|
||
|
||
```bash
|
||
npx superpowers-zh --tool qoder
|
||
```
|
||
|
||
## 手动安装
|
||
|
||
```bash
|
||
git clone https://github.com/jnMetaCode/superpowers-zh.git
|
||
cp -r superpowers-zh/skills /your/project/.qoder/skills
|
||
```
|
||
|
||
或全局安装（对所有项目生效）：
|
||
|
||
```bash
|
||
cp -r superpowers-zh/skills ~/.qoder/skills
|
||
```
|
||
|
||
## Skill 加载优先级
|
||
|
||
| 位置 | 优先级 | 说明 |
|
||
|------|--------|------|
|
||
| `.qoder/skills/` | 最高 | 项目级，仅当前项目 |
|
||
| `~/.qoder/skills/` | 中 | 用户级，所有项目共享 |
|
||
|
||
> 同名 skill 项目级覆盖用户级。
|
||
|
||
## 使用
|
||
|
||
1. 安装完成后**重启 Qoder**
|
||
2. 在对话框输入 `/` 即可看到已加载的 skills 列表
|
||
3. bootstrap rule（`.qoder/rules/superpowers-zh.md`）会被 Qoder 识别为"始终生效"，每个会话自动加载核心规则
|
||
4. 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
|
||
|
||
1. 确认 `.qoder/skills/<skill-name>/SKILL.md` 文件存在
|
||
2. 确认 `SKILL.md` 文件的 frontmatter 完整（`name` + `description`，`description` 不超过 1024 字符）
|
||
3. **必须重启 Qoder** —— 新装的 skill 不会热加载
|
||
|
||
### skill 不被自动调用
|
||
|
||
Qoder 按 description 文本匹配用户意图来决定何时调用 skill。如果某个 skill 自动调用不可靠，可在对话中显式输入 `/<skill-name>` 手动触发。
|
||
|
||
中国原创的 4 个 `chinese-*` skill 本身就是**手动触发**设计（避免污染上游 skill 的自动调度），需要显式 `/chinese-code-review` / `/chinese-commit-conventions` 等。
|
||
|
||
## 卸载
|
||
|
||
```bash
|
||
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
|