Claude to kimi

Claude Code / Plugin -> Kimi 迁移指南

概述

这个技能用于把 Claude Code 的工作区资源与 Plugin 资源迁移到 Kimi Code CLI。目标不是简单复制文件，而是在尽量保留原始语义、目录边界和复用方式的前提下，改写成 Kimi 官方支持的结构。

优先支持以下来源：

• .claude/
• .claude-plugin/
• .codex-plugin/
• .agents/skills/
• .agents/agents/

优先输出以下目标：

• .agents/skills/<name>/SKILL.md
• .agents/agents/<name>.md
• .kimi-code/skills/<name>/SKILL.md
• .kimi-code/agents/<name>.md
• .kimi-code/mcp.json
• .kimi-code/AGENTS.md
• AGENTS.md
• kimi.plugin.json
• .kimi-plugin/plugin.json
• plugin root 下的 skills/
• plugin root 下的 commands/
• plugin root 下的 hooks/

本技能的边界

• 管：资源盘点、差异分析、结构映射、manifest 生成、协议改写、迁移校验、风险说明
• 不管：业务代码迁移、模型切换、第三方平台账号配置、未公开能力的臆造实现

如果用户混合提出“插件迁移 + 业务功能改造”，先完成 Kimi 迁移设计与落盘，再处理业务改造。

无损迁移的定义

这里的“无损”采用最大保真原则，而不是承诺所有字段都能 1:1 原样落地：

1. 优先保留源能力的用途、触发方式、命名和目录边界。
2. 对 Kimi 已有官方对等能力的资源，尽量保持结构接近。
3. 对不属于同一运行时层级的资源，不编造目标字段，而是落到最近的官方位置。
4. 所有无法自动判定的项，都进入“人工确认”而不是静默改写。

迁移动作分为四类：

• copy：可直接复制或极小改动
• transform：需要改目录、frontmatter、manifest 或配置结构
• rewrite：需要按 Kimi 协议重写，例如 hooks
• manual-review：语义无法自动判断，或 frontmatter / 权限契约需要人工确认

Kimi 目标结构总览

.agents/
├── skills/
│   └── <skill-name>/
│       └── SKILL.md
└── agents/
    └── <agent-name>.md

.kimi-code/
├── skills/
│   └── <skill-name>/
│       └── SKILL.md
├── agents/
│   └── <agent-name>.md
├── mcp.json
└── AGENTS.md

AGENTS.md

plugin-root/
├── kimi.plugin.json
├── skills/
│   └── <skill-name>/
│       └── SKILL.md
├── commands/
│   └── *.md
├── hooks/
│   └── *
└── scripts/
    └── *

配套资源：

• 迁移映射：references/claude-plugin-to-kimi-map.md
• Kimi plugin 制式：references/kimi-plugin-spec.md
• Kimi 工作区制式：references/kimi-workspace-spec.md
• Plugin 模板：templates/kimi.plugin.json
• MCP 模板：templates/mcp.json
• Hooks 模板：templates/config.toml.hooks.example
• 来源盘点脚本：scripts/inventory-kimi-sources.js
• 差异分析脚本：scripts/analyze-kimi-migration-diff.js

先做检测，不要先复制

开始迁移前，先确认当前项目中存在什么来源与什么目标。

必查来源

• .claude/
• .claude-plugin/
• .codex-plugin/
• .agents/skills/
• .agents/agents/

必查目标

• .agents/skills/
• .agents/agents/
• .kimi-code/skills/
• .kimi-code/agents/
• .kimi-code/mcp.json
• .kimi-code/AGENTS.md
• AGENTS.md
• kimi.plugin.json
• .kimi-plugin/plugin.json
• plugin root 下现有 skills/、commands/、hooks/、scripts/

优先使用：

node .\skills\claude-to-kimi\scripts\inventory-kimi-sources.js .

如果无法运行脚本，也必须手工输出以下结论：

• 发现了哪些来源目录
• 发现了哪些 Kimi 目标目录
• 每类资源的数量
• 哪些资源可直接迁移
• 哪些资源需要协议改写
• 哪些资源需要人工确认

目标分流策略

1. 默认迁移到 shared 目录

满足以下任一情况时，优先迁移到 .agents/*：

• 目标是跨项目共享，而不是只服务当前仓库
• 资源本质是可复用 Skill 或可委派 Agent
• 用户希望优先采用通用目录，而不是 Kimi 专属项目目录

2. 迁移到 .kimi-code/*

满足以下任一情况时，优先迁移到项目级目录：

• 目标是让当前仓库直接生效
• 资源本质是项目内工作流或项目约束
• 需要保留项目私有 Skill、Agent 或 MCP，而不是分发插件

3. 迁移到 kimi.plugin.json

满足以下任一情况时，优先整理为 Kimi plugin：

• 需要跨项目共享并通过 /plugins install 安装
• 来源本身就是 .claude-plugin 或 .codex-plugin
• 希望统一携带 skills、commands、hooks、mcpServers

4. 双轨输出

以下情况建议 shared / workspace / plugin 同时考虑：

• 项目内要立即落地，同时要沉淀成团队插件
• 需要把项目约束写入 AGENTS.md，但通用 Skill、Agent 或命令继续共享
• 来源 plugin 同时含项目特定配置与可复用资产

资源映射总规则

详细矩阵见 references/claude-plugin-to-kimi-map.md。这里给执行级规则。

1. Skills

• Claude Skill 与 Kimi Skill 的目录形态高度兼容
• 默认工作区目标：.agents/skills/<name>/SKILL.md
• 条件性项目目标：.kimi-code/skills/<name>/SKILL.md
• Plugin 目标：plugin root 下 skills/，由 kimi.plugin.json -> skills 声明

2. Commands

• Claude 命令类 markdown 资源优先迁移到 plugin commands/
• Kimi plugin 命令自动带 plugin 命名空间，最终形如 /plugin-id:command-name
• 若来源是项目内部操作说明而不是分发型命令，更适合改写为 Skill

3. Hooks

• Kimi hooks 不能照搬 Claude 的配置结构
• 用户级常规 hooks 位于 ~/.kimi-code/config.toml 的 [[hooks]]
• Plugin 级 hooks 通过 kimi.plugin.json -> hooks 声明
• hook 逻辑仍可复用，但事件名、stdin 输入和阻断方式必须按 Kimi 协议重写

4. MCP

• 项目级目标：.kimi-code/mcp.json
• Plugin 级目标：kimi.plugin.json -> mcpServers
• mcpServers 是 Kimi 的标准字段；支持 stdio、HTTP、SSE 三种接入方式

5. Agents

• Kimi 官方支持自定义 Agent 文件
• 默认共享目标：.agents/agents/<name>.md
• 条件性项目目标：.kimi-code/agents/<name>.md
• agents 不是 kimi.plugin.json 的 manifest 字段
• AGENTS.md 只承载长期规则、术语映射、工作方式约束，不作为 Agent 文件的默认替代

高自动化执行流程

阶段 1：扫描来源与目标

输出至少包含：

• 来源目录
• 目标目录
• manifest 存在情况
• 同名资源
• 风险资源

阶段 2：建立迁移清单

按以下资源分类：

• skills
• commands
• hooks
• mcp
• agents
• templates
• scripts
• instructions

每项标记动作：

• copy
• transform
• rewrite
• manual-review

阶段 3：先做差异分析

优先使用：

node .\skills\claude-to-kimi\scripts\analyze-kimi-migration-diff.js .

如果同名目标已存在，按以下规则处理：

• 完全一致：跳过
• 仅源端更新：可迁移
• 两端都改过：停止覆盖并输出冲突说明
• 协议敏感资源：转为 rewrite

阶段 4：按类型迁移

推荐顺序：

1. skills
2. agents
3. commands
4. mcp
5. hooks
6. AGENTS.md / instructions

阶段 5：生成清单与模板

至少输出：

• kimi.plugin.json 或 .kimi-plugin/plugin.json
• .kimi-code/mcp.json
• 需要时补充 AGENTS.md
• 迁移报告

阶段 6：校验结果

至少检查：

• SKILL.md frontmatter 是否完整
• Agent 文件 frontmatter 是否完整
• plugin manifest 是否位于官方支持的位置
• commands 路径是否位于 plugin root 内
• mcpServers 结构是否合法
• hooks 是否仍引用了 Claude 专属字段
• agents 是否被错误写进 plugin manifest

Hook 迁移注意事项

Kimi hooks 的核心规则：

• 通过标准输入接收事件 JSON
• 退出码 0 放行，2 阻断，其他非零值默认 fail-open
• UserPromptSubmit、PreToolUse、Stop 属于可阻断事件
• SubagentStart、SubagentStop、Notification 等是观察型事件
• Plugin hooks 只在插件启用期间生效

迁移要求：

• 不直接复制 Claude 的 hook 配置文件
• 保留脚本业务逻辑，但重写入参、返回值和事件名
• 如需阻断，优先使用 Kimi 官方支持的退出码或 stdout JSON 结构

MCP 迁移注意事项

• Kimi 项目级文件为 .kimi-code/mcp.json
• 顶层字段是 mcpServers
• stdio server 可用 command + args
• HTTP / SSE server 用 url
• 敏感信息改为占位符，提醒用户后补

Agents 迁移注意事项

不要把 Claude agents 机械映射到 Kimi plugin manifest。

当来源是 Agent 文件时，优先判断它能否直接落到：

• .agents/agents/<name>.md
• .kimi-code/agents/<name>.md

需要人工确认的典型场景：

• name、description 或 frontmatter 缺失
• tools、disallowedTools、subagents 语义无法稳定映射
• 需要 override: true 才能覆盖内置 Agent
• 内容实质上更像 AGENTS.md 指令或 Skill，而不是 Agent 定义

失败策略

1. 发现同名资源冲突

输出冲突矩阵：

• 源路径
• 目标路径
• 差异类型
• 推荐保留方案

2. Agent 文件缺少稳定落点

必须说明：

• 建议落到 .agents/agents 还是 .kimi-code/agents
• 是否需要拆成 Agent 文件、Skill 或 AGENTS.md
• 哪些 frontmatter 或工具权限需要用户确认

3. hooks 依赖 Claude 专属协议

保留脚本逻辑，但不要编造 Kimi 未公开字段。优先输出最小可运行版本与风险说明。

4. 来源 plugin 含未支持字段

如 tools、apps、inject、configFile 等，标记为 diagnostics 风险，不直接迁入 Kimi runtime 字段。

产出要求

执行本技能时，最终结果至少包括：

1. 来源与目标扫描结果
2. 资源映射表
3. 迁移分流方案
4. 已迁移项
5. 需协议改写项
6. 需人工确认项
7. 后续建议

快速检查清单

• 已扫描 .claude、.claude-plugin、.codex-plugin、.agents/skills、.agents/agents
• 已扫描 .agents/skills、.agents/agents、.kimi-code、AGENTS.md、kimi.plugin.json
• 每类资源都已标记为 copy、transform、rewrite 或 manual-review
• hooks 已改为 Kimi 协议
• MCP 已改为 Kimi 的 mcpServers
• agents 没有被误判为 Kimi plugin manifest 字段
• 已输出冲突与风险说明

触发示例

• “把这个 .claude-plugin 无损迁移到 Kimi”
• “帮我把 Claude Code Plugin 改成 kimi.plugin.json”
• “扫描 .claude-plugin 和现有 .agents / .kimi-code，先做差异分析再迁移”
• “这些 Claude agents 在 Kimi 里该落到 .agents/agents 还是 .kimi-code/agents”
• “帮我把 Claude 的 hooks 和 mcp 配置改写成 Kimi 官方格式”