mirror of https://github.com/jnMetaCode/superpowers-zh.git synced 2026-09-02 22:54:06 +08:00

Files

AI不止语 af4c03c1e0 feat(kimi): 新增 Kimi Code harness 支持（对齐上游 v6.0.0 集成模型）

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 经过验证的集成方式。

2026-06-20 02:37:31 +08:00

2.9 KiB

Raw Blame History

Superpowers 中文版 · Kimi Code 指南

在 Kimi Code 上使用 superpowers-zh 的完整说明。

安装

superpowers-zh 通过 Kimi Code 的插件清单 .kimi-plugin/plugin.json 集成，直接指向仓库现有的 skills/ 目录——不复制 skill、不建 symlink、不装 hook、无任何运行时依赖。

打开插件管理器：

/plugins

如果 Kimi 插件市场已收录，进入 Marketplace > Superpowers 中文版 安装即可。

也可以直接从本仓库安装：

/plugins install https://github.com/jnMetaCode/superpowers-zh

如需验证尚未发布的改动，显式指定分支：

/plugins install https://github.com/jnMetaCode/superpowers-zh/tree/main

Kimi Code 在新会话才会应用插件变更。安装、更新、启用、禁用或重载插件后，用 /new 开一个新会话。

工作原理

Kimi 插件清单位于 .kimi-plugin/plugin.json，做三件事：

把 Kimi Code 指向仓库现有的 skills/ 目录；
通过 sessionStart.skill 在会话开始时加载 using-superpowers（这是让 skill 在恰当时机自动触发的关键）；
通过 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 的插件管理器：

/plugins

选中 Superpowers 中文版更新，更新后用 /new 开新会话。

排错

插件没加载

跑 /plugins info superpowers-zh 看诊断信息；
确认插件已启用；
安装或更新后用 /new 开新会话。

直接 GitHub 安装装到了旧版本

对于裸仓库 URL，Kimi Code 会装最新的 GitHub release（若存在）。要在下一个 release 前测试未发布的改动，显式指定分支：

/plugins install https://github.com/jnMetaCode/superpowers-zh/tree/main

skill 不触发

用 /plugins info superpowers-zh 确认插件已启用；
用 /new 开新会话；
试验收提示词：我们来做个 react todo list。集成正常的话，会在写任何代码之前先加载 brainstorming。

2.9 KiB Raw Blame History Unescape Escape