mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-02 22:54:06 +08:00
af4c03c1e0
issue #37：Kimi Code 已支持 Skills 能力，希望原生支持。上游 obra/superpowers 在 v6.0.0 已用插件清单模型原生集成 Kimi，本提交把同样的集成方式落到本 fork。 Kimi 走插件清单模型（与 CC plugin 同类），直接指向仓库现有 skills/， 不复制 skill、不建 symlink、不装 hook、无运行时依赖，因此无需改 npx 安装器（安装器面向需要复制 skills 的工具）。 - .kimi-plugin/plugin.json：fork 品牌清单，skills 指向 ./skills/， sessionStart.skill = using-superpowers（会话开始自动加载 bootstrap）， skillInstructions 提供 Kimi 工具映射（AskUserQuestion/TodoList/Agent/ Skill/Read/Write/Edit/Bash/Grep/Glob/FetchURL/WebSearch，保留上游权威 英文映射以免破坏真实工具名） - 版本同步：.version-bump.json 与 scripts/sync-plugin-version.js 双向接入 - docs/README.kimi.md：中文安装/工具映射/排错指南；README.md 工具列表加链接 - tests/kimi/：清单结构测试（适配 fork：name=superpowers-zh、校验版本同步条目） 验证：bash tests/kimi/run-tests.sh 通过；manifest 合法 JSON；版本同步双机制 均含 kimi 条目；scripts/audit.sh 静态校验 0 FAIL；README→docs/README.kimi.md 链接可解析。 注：Kimi 实际 skill 自动触发需在 Kimi Code 内验证（与本 fork 其它 harness 同样限制），清单结构已对齐上游 v6.0.0 经过验证的集成方式。
87 lines
2.9 KiB
Markdown
87 lines
2.9 KiB
Markdown
# Superpowers 中文版 · Kimi Code 指南
|
||
|
||
在 [Kimi Code](https://github.com/MoonshotAI/kimi-code) 上使用 superpowers-zh 的完整说明。
|
||
|
||
## 安装
|
||
|
||
superpowers-zh 通过 Kimi Code 的插件清单 `.kimi-plugin/plugin.json` 集成，**直接指向仓库现有的 `skills/` 目录**——不复制 skill、不建 symlink、不装 hook、无任何运行时依赖。
|
||
|
||
打开插件管理器：
|
||
|
||
```text
|
||
/plugins
|
||
```
|
||
|
||
如果 Kimi 插件市场已收录，进入 `Marketplace` > `Superpowers 中文版` 安装即可。
|
||
|
||
也可以直接从本仓库安装：
|
||
|
||
```text
|
||
/plugins install https://github.com/jnMetaCode/superpowers-zh
|
||
```
|
||
|
||
如需验证尚未发布的改动，显式指定分支：
|
||
|
||
```text
|
||
/plugins install https://github.com/jnMetaCode/superpowers-zh/tree/main
|
||
```
|
||
|
||
Kimi Code 在**新会话**才会应用插件变更。安装、更新、启用、禁用或重载插件后，用 `/new` 开一个新会话。
|
||
|
||
## 工作原理
|
||
|
||
Kimi 插件清单位于 `.kimi-plugin/plugin.json`，做三件事：
|
||
|
||
1. 把 Kimi Code 指向仓库现有的 `skills/` 目录；
|
||
2. 通过 `sessionStart.skill` 在会话开始时加载 `using-superpowers`（这是让 skill 在恰当时机自动触发的关键）；
|
||
3. 通过 `skillInstructions` 提供 Kimi 专属的工具映射。
|
||
|
||
## 工具映射
|
||
|
||
skill 内容描述的是「动作」而非写死某个运行时的工具名。在 Kimi Code 上它们对应到：
|
||
|
||
- 「向用户提问」/「问澄清问题」/「给出多选项」→ `AskUserQuestion`
|
||
- 「创建待办」/「在待办清单中标记完成」→ `TodoList`
|
||
- 「分派子智能体」/「Task tool (general-purpose)」→ `Agent`（用 Kimi 的 subagent 类型，如 `coder`/`explore`/`plan`，**不要**传 `general-purpose`）
|
||
- 「调用某个 skill」→ Kimi Code 原生 `Skill` 工具
|
||
- 「读文件」/「写文件」/「改文件」→ `Read` / `Write` / `Edit`
|
||
- 「跑 shell 命令」→ `Bash`
|
||
- 「搜索文件内容」→ `Grep`
|
||
- 「按路径/模式找文件」→ `Glob`
|
||
- 「抓取 URL」→ `FetchURL`
|
||
- 「联网搜索」→ `WebSearch`
|
||
|
||
完整映射写在清单的 `skillInstructions` 字段里，由 Kimi 在运行时读取。
|
||
|
||
## 更新
|
||
|
||
用 Kimi Code 的插件管理器：
|
||
|
||
```text
|
||
/plugins
|
||
```
|
||
|
||
选中 Superpowers 中文版更新，更新后用 `/new` 开新会话。
|
||
|
||
## 排错
|
||
|
||
### 插件没加载
|
||
|
||
1. 跑 `/plugins info superpowers-zh` 看诊断信息；
|
||
2. 确认插件已启用；
|
||
3. 安装或更新后用 `/new` 开新会话。
|
||
|
||
### 直接 GitHub 安装装到了旧版本
|
||
|
||
对于裸仓库 URL，Kimi Code 会装最新的 GitHub release（若存在）。要在下一个 release 前测试未发布的改动，显式指定分支：
|
||
|
||
```text
|
||
/plugins install https://github.com/jnMetaCode/superpowers-zh/tree/main
|
||
```
|
||
|
||
### skill 不触发
|
||
|
||
1. 用 `/plugins info superpowers-zh` 确认插件已启用；
|
||
2. 用 `/new` 开新会话；
|
||
3. 试验收提示词：`我们来做个 react todo list`。集成正常的话，会在写任何代码之前先加载 `brainstorming`。
|