mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-02 22:54:06 +08:00
6cb1cd89bc
两款都是 VS Code 扩展，加载的是「rules」而非懒加载的 skills —— rules 会 并入每一轮 system prompt。所以照搬「把 20 个 SKILL.md 复制进规则目录」会 让每轮对话背着几万字常驻开销（Cline 官方也提示规则超约 300 行后遵守度下降）。 改用仓库既有的 Trae 模式：规则目录里只放一份小索引（核心规则 + 20 个 skill 的名称/触发条件表），skills 本体放各自的 skills/ 目录由 agent 按需读取。 Cline（#112） - skills -> .cline/skills/，索引 -> .clinerules/superpowers-zh.md - 不写 YAML frontmatter：Cline 目前只支持 paths 一个条件字段， 无 frontmatter 即始终生效，正是所需 - 索引保持在 .clinerules/ 根层单文件 —— 子目录是否递归扫描官方未说明 Kilo Code（#88） - skills -> .kilocode/skills/，索引 -> .kilocode/rules/superpowers-zh.md - 走 .kilocode/rules/ 而非 v7 推荐的 .kilo/rules/ + kilo.jsonc：后者需要把 路径登记进用户的 kilo.jsonc，那是带注释的 JSONC，安装器安全合并容易改坏 用户配置。官方明确 .kilocode/rules/ 向后兼容且零配置生效，故选它。 docs 里写了想迁到 v7 方式该改哪一行，以及万一没生效怎么反馈。 接入点（全部为新增，未改动任何既有工具的条目） - TARGETS 加 2 条，检测标记 .clinerules / [.kilocode,.kilo,kilo.jsonc] 均唯一 - installForTarget 分发、TOOL_ALIASES（cline/kilocode/kilo/kilo-code） - BOOTSTRAP_DELETE 加两份索引路径，--uninstall 能清干净 - --global 明确拒绝并指向 docs：Cline 全局 rules 路径随 OS 变 （~/Documents/Cline/Rules，Linux/WSL 还有 ~/Cline/Rules 回退）， Kilo 全局需改 kilo.jsonc，都不是通用 --global 能可靠命中的 - audit.sh TOOLS 数组加 cline kilocode，纳入 install/幂等/卸载回归 - 新增 docs/README.cline.md、docs/README.kilocode.md - 计数 20 -> 22：简繁 README、package.json、CLAUDE.md、3 份 plugin manifest （RELEASE-NOTES 里的历史计数是过往版本记录，不动） 实测 - 两款均通过 装 / 二次装幂等 / 卸载无残留 - 检测隔离：.clinerules 只触发 Cline、.kilocode|.kilo|kilo.jsonc 只触发 Kilo Code；.claude/.cursor/.trae/.qoder/.codebuddy 检测结果与改动前一致； .claude + .clinerules 共存时两款并行安装正常 - audit.sh: 130 pass / 0 fail（2 项 warn 为既有上游漂移，见 #19） 路径依据：docs.cline.bot/customization/cline-rules、kilo.ai/docs/customize/custom-rules 两款合并为一个提交：共用同一套「rules 型工具」机制与同一批计数改动， 拆开会产生 21 款的中间状态，audit 无法在中间提交上自洽通过。
87 lines
3.2 KiB
Markdown
87 lines
3.2 KiB
Markdown
# Superpowers 中文版 — Kilo Code 安装指南
|
||
|
||
在 [Kilo Code](https://kilo.ai)（VS Code AI 编程扩展 / CLI）中使用 superpowers-zh 的完整指南。
|
||
|
||
## 快速安装
|
||
|
||
```bash
|
||
cd /your/project
|
||
npx superpowers-zh --tool kilocode
|
||
```
|
||
|
||
自动检测：项目里存在 `.kilocode/`、`.kilo/` 或 `kilo.jsonc` 任一时会自动装 Kilo Code。
|
||
|
||
装完会得到：
|
||
|
||
```
|
||
.kilocode/skills/ # 20 个 skill 本体，按需读取
|
||
.kilocode/rules/
|
||
└── superpowers-zh.md # 一份小索引，自动生效
|
||
```
|
||
|
||
## 工作原理
|
||
|
||
Kilo Code 加载的是 **Rules**（规则会并入 system prompt），不是懒加载的 skills。所以和 Cline 同理：**不能把 20 个 SKILL.md 直接塞进 rules 目录**，否则每轮对话都背着巨大的常驻开销。
|
||
|
||
superpowers-zh 的做法：
|
||
|
||
| 放哪 | 内容 | 何时进 prompt |
|
||
|------|------|--------------|
|
||
| `.kilocode/rules/superpowers-zh.md` | 核心规则 + 20 个 skill 的索引表 | 常驻（很小） |
|
||
| `.kilocode/skills/<name>/SKILL.md` | skill 完整流程正文 | 仅当任务匹配、Kilo 主动读取时 |
|
||
|
||
## 为什么用 `.kilocode/rules/` 而不是新版的 `kilo.jsonc`
|
||
|
||
Kilo Code 从 Roo 衍生的 v5 迁到了基于 OpenCode 的 v7，配置方式变了：
|
||
|
||
| | 旧（v5 及兼容路径） | 新（v7 推荐） |
|
||
|---|---|---|
|
||
| 规则目录 | `.kilocode/rules/` | `.kilo/rules/` |
|
||
| 是否需要登记 | **不需要，自动生效** | **需要**，要把路径写进 `kilo.jsonc` 的 `instructions` 数组 |
|
||
|
||
我们选 `.kilocode/rules/`，原因是**不改你的 `kilo.jsonc`**：
|
||
|
||
1. 官方明确 `.kilocode/rules/` 向后兼容，无需任何配置即生效；
|
||
2. `kilo.jsonc` 是带注释的 JSONC，安装脚本要安全合并它很容易把你的配置改坏；
|
||
3. 那是你的配置文件，装个 skills 框架不该动它。
|
||
|
||
### 如果你想迁到 v7 的方式
|
||
|
||
手动加一行即可（把现有规则文件挪到 `.kilo/rules/` 并登记）：
|
||
|
||
```jsonc
|
||
{
|
||
"instructions": [".kilo/rules/superpowers-zh.md"]
|
||
}
|
||
```
|
||
|
||
改完 `kilo.jsonc` 后**新开一个会话**才会生效。
|
||
|
||
> ⚠️ 需要说明的是：`.kilocode/rules/` 的兼容性来自官方文档中「现有规则会继续工作」的表述。若你在 v7 上装完发现索引 rule 没被加载，按上面的方式迁到 `.kilo/rules/` + `kilo.jsonc`，并欢迎来 issue 里反馈，我们会据此调整默认路径。
|
||
|
||
## 手动安装
|
||
|
||
```bash
|
||
git clone https://github.com/jnMetaCode/superpowers-zh.git
|
||
mkdir -p /your/project/.kilocode/skills /your/project/.kilocode/rules
|
||
cp -r superpowers-zh/skills/* /your/project/.kilocode/skills/
|
||
```
|
||
|
||
索引 rule 建议交给 `npx` 生成 —— 它是按 skills 的 frontmatter 自动拼的，手写容易漏。
|
||
|
||
## 关于全局安装
|
||
|
||
`--global` 对 Kilo Code **不支持**：它的全局规则同样要走 `kilo.jsonc` 登记，没有「复制到某个用户级目录就生效」的通用路径。请用项目级安装。
|
||
|
||
## 更新 / 卸载
|
||
|
||
```bash
|
||
npx superpowers-zh --tool kilocode # 更新（覆盖式，幂等）
|
||
npx superpowers-zh --uninstall # 卸载，同时清掉 .kilocode/rules/superpowers-zh.md
|
||
```
|
||
|
||
## 获取帮助
|
||
|
||
- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
|
||
- Kilo Code 自定义规则文档：https://kilo.ai/docs/customize/custom-rules
|