Skip to content

feat(kimi): 新增 Kimi Code harness 支持(关 #37,对齐上游 v6.0.0)#59

Merged
jnMetaCode merged 1 commit into
mainfrom
sync/v6-kimi-harness
Jun 19, 2026
Merged

feat(kimi): 新增 Kimi Code harness 支持(关 #37,对齐上游 v6.0.0)#59
jnMetaCode merged 1 commit into
mainfrom
sync/v6-kimi-harness

Conversation

@jnMetaCode

Copy link
Copy Markdown
Owner

你要解决什么问题?

issue #37:Kimi Code(国内主流编程 agent 之一)已支持 Skills 能力,但 superpowers-zh 此前没有原生集成,Kimi 用户无法像 Claude Code / Cursor 等那样开箱使用。上游 obra/superpowers 已在 v6.0.0 用插件清单模型原生支持 Kimi Code,本 fork 落后于此。

这个 PR 做了什么改变?

为 Kimi Code 新增插件清单 .kimi-plugin/plugin.json(指向现有 skills/sessionStart 自动加载 using-superpowersskillInstructions 提供 Kimi 工具映射),接入版本同步,并补中文安装文档与清单结构测试。

这个改变适合放在核心库中吗?

适合——这是为新 harness(Kimi Code)添加支持,正是 CLAUDE.md 中明确允许进入 core 的类别("新 harness 支持")。不引入运行时依赖。

你考虑了哪些替代方案?

  • 改 npx 安装器加 --tool kimi:放弃。Kimi 走插件清单模型(与 Claude Code plugin 同类),通过 /plugins install <repo> 直接读取仓库 skills/不需要复制 skill。fork 的安装器是面向"需要把 skills 复制进工具目录"的 harness,对 Kimi 不适用——加进去反而是错误抽象。这也与上游 v6.0.0 的集成方式一致。
  • 重写一套 Kimi 专属工具映射(中文):放弃。skillInstructions 引用的是 Kimi 真实工具名(AskUserQuestion/Agent/Grep 等,本就是英文),保留上游经过验证的权威英文映射可避免破坏工具名解析。

这个 PR 是否包含多个不相关的改变?

否。全部围绕"新增 Kimi Code 支持"这一件事:清单 + 版本同步接入(清单要随版本号同步)+ 文档(README 链接 + 安装指南)+ 测试。彼此直接依赖。

已有的 PR

测试环境

工具(如 Claude Code、Cursor) 工具版本 模型 模型版本/ID
Claude Code 本会话 Opus 4.8 claude-opus-4-8

说明:Kimi Code 内的 skill 实际自动触发未在本 PR 中验证——本会话无 Kimi Code 环境。清单结构严格对齐上游 v6.0.0 已验证的集成方式,且通过下列结构测试。这与本 fork 其它 harness 适配的验证边界一致。

评估

新 harness 的清单/文档/测试(非 skill 行为塑造内容),用结构测试 + 静态审计验证:

  • bash tests/kimi/run-tests.sh 通过(校验 name=superpowers-zhskills=./skills/sessionStart.skill=using-superpowersskillInstructions 含全部 12 个工具映射 token、版本同步条目存在、无 Kimi 不支持的字段)
  • .kimi-plugin/plugin.json 为合法 JSON
  • 版本同步双机制.version-bump.json + scripts/sync-plugin-version.js)均含 .kimi-plugin/plugin.json 条目
  • scripts/audit.sh 静态校验 0 FAILREADME.mddocs/README.kimi.md 链接可解析

严格性

  • 非 skill 行为措辞改动(新 harness 清单/文档/测试);用结构测试 + 审计验证(见上)
  • 清单结构经测试验证,覆盖必需字段与"不应出现的字段"两类断言
  • 未触碰任何精心调优的行为内容(红旗表、合理化列表、"人类搭档"用语)

人工审核

  • 提交前已有人工审核过完整的 diff

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

Copy link
Copy Markdown
Owner Author

ℹ️ 关于 CI:「全量审计」红是继承自 main 的既有问题,与本 PR 无关

合并顺序建议:先合 #58(让 main 转绿),本 PR 与 #57 基于更新后的 main 即转绿;或三个都合入后 main 即全绿。

@jnMetaCode jnMetaCode merged commit 483621d into main Jun 19, 2026
1 of 2 checks passed
@jnMetaCode jnMetaCode mentioned this pull request Jun 19, 2026
jnMetaCode added a commit that referenced this pull request Jun 20, 2026
对齐上游 v6.0.0 实质变更 + 新增 Kimi/Pi 两款 harness 支持:
- Kimi Code 支持(#59,关 #37)
- Pi (oh-my-pi) 支持(#60,关 #44)
- brainstorm 可视化伴侣安全模型(#58,每会话密钥 + 安全头)
- worktree 移除旧全局目录(#57)+ hooks/session-start v6(#58)
- opencode 测试修复(#72)

版本号同步:package.json + 5 个 plugin 清单 + marketplace + gemini-extension。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant