内容
# 克米 — 多智能体工作流：克米 K2.5 用于克劳德代码（v2.0）
[]()
[]()
[]()
> **克米** = **C**laude + **Ki**mi。 一个委托框架，将克劳德代码转变为架构师/大脑，将克米 K2.5 转变为实施者/执行者。
## 概述
将 **克米 K2.5** 集成为主动式研发子代理，用于克劳德代码。 **克劳德是大脑** （架构师、协调员、审查员），**克米是执行者** （开发者、实施者、调试员）。克劳德设计并委托，克米实施并执行。
克米通过三种方式与克劳德代码连接：
- **基于角色的包装脚本** ，委托给克米，并具有七种专门的代理角色（或通用模板）。
- **MCP 桥** ，通过 JSON-RPC 将克米暴露为可调用的工具（`kimi_analyze` 、 `kimi_audit` 、 `kimi_trace` 、 `kimi_verify` ）。
- **Git 钩子** ，在 `pre-commit` 、 `post-checkout` 和 `pre-push` 时自动委托编码任务。
## 新增功能 v2.0
- **MCP 服务器** ：将克米暴露为外部 AI 系统的可调用工具
- **Git 钩子** ：在提交/推送/切换时自动委托编码任务
- **模型选择** ：根据任务类型智能选择 K2 与 K2.5
- **成本估算** ：在委托前预览 token 成本
- **斜杠命令** ：新增 `/kimi-mcp` 和 `/kimi-hooks` 命令
**劳动分工：**
| 克劳德（大脑） | 克米（执行者） |
|----------------|--------------|
| 设计和计划 | 实现功能 |
| 审查和批准 | 调试和修复错误 |
| 协调工作 | 重构代码 |
| 做出决定 | 运行测试 |
**关键优势：**
- 将实施工作委托给克米，同时专注于架构
- 7 种专门的代理角色：4 种行动角色（完全工具访问）+ 3 种分析角色（只读）
- 常见工作流的模板化提示
- 用于变更后验证的 Git diff 注入
- **v2.0：** 用于外部 AI 集成的 MCP 桥
- **v2.0：** 用于自动化委托的 Git 钩子
- **v2.0：** 智能模型选择（K2 与 K2.5）
## 快速开始
### 1. 安装
```bash
# 克隆并安装
git clone https://github.com/9thLevelSoftware/Climi.git
cd Climi
# 标准安装（v1.0 功能）
./install.sh
# 完整的 v2.0 安装（带有 MCP + 钩子）
./install.sh --with-hooks
```
### 2. 配置 MCP（可选）
```bash
# 设置 MCP 以集成克劳德代码
kimi-mcp-setup install
```
### 3. 使用
```bash
# 基本用法
./skills/kimi.agent.wrapper.sh -r reviewer "审查此代码库"
# 带有思考模式
./skills/kimi.agent.wrapper.sh -r reviewer --thinking "解释架构"
# 克劳德代码中的斜杠命令
/kimi-analyze src/ "身份验证如何实现？"
/kimi-mcp start
/kimi-hooks install
```
## 安装
### 依赖项
| 依赖项 | 是否需要 | 安装 |
|------------|----------|--------------|
| **克米 CLI** | 是 (>=1.7.0) | `uv tool install kimi-cli` 或 `pip install kimi-cli` |
| **Bash** | 是 | macOS/Linux：内置，Windows：Git Bash |
| **jq** | 是（v2.0） | `brew install jq` 或 `apt-get install jq` |
| **Git** | 可选 | 用于 `--diff` 功能 |
| **Python** | 是 (>=3.12) | 克米 CLI 需要 |
**注意：** jq 是 v2.0 中 MCP 服务器和钩子功能所需的。
### 安装选项
```bash
# 交互式安装（提示目标）
./install.sh
# 全局安装（所有项目，~/.claude/）
./install.sh --global
# 本地安装（仅当前目录）
./install.sh --local
# 完整的 v2.0 安装（带有 MCP + 钩子）
./install.sh --with-hooks
# 干燥运行（预览将安装的内容）
./install.sh --dry-run
# 自定义目标
./install.sh --target /path/to/target
```
### Windows 用户
使用 PowerShell 包装器以获得原生 PowerShell 支持：
```powershell
# 从 PowerShell
.\kimi.ps1 -r reviewer "审查此代码"
# 或直接使用 Git Bash
bash skills/kimi.agent.wrapper.sh -r reviewer "审查此代码"
```
PowerShell 包装器（`kimi.ps1`）自动查找 Git Bash、WSL 或 MSYS2 以执行 bash 包装器。
### PATH 配置
确保 `~/.local/bin` 在您的 PATH 中，用于 v2.0 命令：
```bash
# 添加到 ~/.bashrc 或 ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
```
### 升级
再次运行 `./install.sh`。安装程序：
- 检测现有安装
- 提供创建时间戳备份
- 更新包装脚本、角色、模板
- 保留自定义配置
- 安装新的 v2.0 组件
### 卸载
```bash
# 预览将删除的内容
./uninstall.sh --dry-run
# 删除安装
./uninstall.sh
```
## 用法
### 基本调用
```bash
# 使用角色
./skills/kimi.agent.wrapper.sh -r <role> "提示"
# 使用模板
./skills/kimi.agent.wrapper.sh -t <template> "提示"
# 同时使用两者
./skills/kimi.agent.wrapper.sh -r reviewer -t feature "计划新用户身份验证"
# 使用 Git diff 上下文
./skills/kimi.agent.wrapper.sh -t verify --diff "验证我的更改是否正确"
# 自动模型选择（K2 与 K2.5）
./skills/kimi.agent.wrapper.sh -r reviewer --auto-model "审查此代码库"
# 设置工作目录
./skills/kimi.agent.wrapper.sh -r reviewer -w /path/to/project "审查此项目"
```
### 命令选项
```
用法：
./skills/kimi.agent.wrapper.sh [选项] "提示"
包装器选项：
-r, --role ROLE 代理角色（映射到 .kimi/agents/ROLE.yaml）
-m, --model MODEL 克米模型（默认：kimi-code/kimi-for-coding）
-w, --work-dir PATH 克米的工作目录
-t, --template TPL 要添加的前缀模板（映射到 .kimi/templates/TPL.md）
--auto-model 启用每任务的 K2 与 K2.5 自动选择
--diff 包含 Git diff（HEAD 与工作树）到提示中
--dry-run 显示命令而不执行
--verbose 显示包装器调试输出
-h, --help 显示帮助并退出
克米 CLI 选项（传递）：
--thinking 启用更深层次的推理的思考模式
--no-thinking 禁用思考模式
-y, --yes, --yolo 自动批准所有操作
--print 在非交互式打印模式下运行
（以及其他kimi CLI标志）
环境：
KIMI_PATH 克米二进制文件位置的重写（在 Windows 上很有用）
KIMI_FORCE_MODEL 强制模型选择（k2 或 k2.5）
```
## 代理角色
所有代理都定义在 `.kimi/agents/` 中，作为 YAML + Markdown 对。
### 分析角色（只读）
分析角色具有受限的工具访问权限 - 它们可以读取文件和搜索，但不能修改任何内容。适用于代码审查和审计。
| 角色 | 目的 | 用例 |
|------|---------|----------|
| **reviewer** | 代码质量评估 | 代码审查、错误检测、最佳实践 |
| **auditor** | 架构评估 | 技术债务、模式、系统级问题 |
| **security** | 漏洞评估 | OWASP、密钥扫描、安全审计 |
### 操作角色（完全访问）
操作角色具有完全的工具访问权限，包括 shell、文件写入和子代理创建。它们可以自主调查和解决问题。
| 角色 | 目的 | 用例 |
|------|---------|----------|
| **debugger** | 错误调查 | 跟踪错误、查找根本原因、应用修复 |
| **refactorer** | 代码重构 | 模式改进、DRY、可维护性 |
| **implementer** | 功能实现 | 构建新功能、绿地自由 |
| **simplifier** | 复杂度降低 | 删除死代码、整合 |
### 工具访问矩阵
| 工具 | 分析角色 | 操作角色 |
|------|----------------|--------------|
| ReadFile, Glob, Grep | 是 | 是 |
| SearchWeb | 是 | 是 |
| Shell | 否 | 是 |
| WriteFile | 否 | 是 |
| StrReplaceFile | 否 | 是 |
| CreateSubagent | 否 | 是 |
## 模板
模板为常见任务提供预构建的提示结构。位于 `.kimi/templates/` 中。
| 模板 | 标志 | 用例 |
|----------|------|----------|
| `feature` | `-t feature` | 计划新功能实现 |
| `bug` | `-t bug` | 调查和分析错误 |
| `verify` | `-t verify` | 变更后验证（与 `--diff` 一起使用） |
| `architecture` | `-t architecture` | 系统架构审查 |
| `implement-ready` | `-t implement-ready` | 生成实现指南 |
| `fix-ready` | `-t fix-ready` | 生成修复说明 |
### 示例模板用法
```bash
# 计划新功能
./skills/kimi.agent.wrapper.sh -r reviewer -t feature "添加密码重置功能"
# 验证更改后实施
./skills/kimi.agent.wrapper.sh -t verify --diff "验证身份验证更改"
# 错误调查
./skills/kimi.agent.wrapper.sh -r debugger -t bug "UserService.kt:245 中的 NullPointerException"
```
## 克劳德代码斜杠命令
斜杠命令定义在 `dist/.claude/commands/kimi/` 中，并由 `install.sh` 复制到您的项目（或 `~/.claude/`）。安装后，它们在克劳德代码中可用：
| 命令 | 角色 | 描述 |
|---------|------|-------------|
| `/kimi-analyze` | reviewer | 代码库分析和探索 |
| `/kimi-audit` | auditor | 架构和质量审计 |
| `/kimi-trace` | debugger | 带有完全工具访问的错误跟踪 |
| `/kimi-verify` | （模板） | 变更后验证，附带差异 |
| `/kimi-mcp` | - | MCP 服务器管理（v2.0） |
| `/kimi-hooks` | - | Git 钩子管理（v2.0） |
### 在克劳德代码中使用
```
/kimi-analyze src/ 身份验证如何实现？
/kimi-audit . 需要改进哪些模式？
/kimi-trace "Error at auth.ts:145"
/kimi-verify 检查我的更改是否正确
/kimi-mcp start
/kimi-hooks install
```
## MCP 桥（v2.0）
MCP 桥（`mcp-bridge/`）通过 stdio 将克米暴露为四个 JSON-RPC 工具，因此任何 MCP 感知客户端（克劳德桌面版、自定义代理、IDE 插件）都可以直接调用克米：
- `kimi_analyze` — 调用 `reviewer` 角色
- `kimi_audit` — 调用 `auditor` 角色
- `kimi_trace` — 调用 `debugger` 角色
- `kimi_verify` — 调用 `verify` 模板
设置：
```bash
# 安装 MCP 桥（在 ./install.sh --with-hooks 或独立运行）
./install.sh --with-hooks
# 使用kimi-mcp-setup安装MCP服务器
kimi-mcp-setup install
# 检查/启动/停止服务器
kimi-mcp start
kimi-mcp status
kimi-mcp stop
```
配置位于 `~/.config/kimi-mcp/config.json` （默认从 `mcp-bridge/config/default.json` 种子）。有关详细信息，请参见 [docs/MCP-SETUP.md](docs/MCP-SETUP.md)。
## Git 钩子（v2.0）
克米附带三个 Git 钩子（在 `hooks/hooks/` 中），它们在众所周知的 Git 事件中自动触发克米委托：
| 钩子 | 触发 | 行为 |
|------|---------|----------|
| `pre-commit` | 提交前 | 自动委托暂存区审查到 `reviewer` 角色 |
| `post-checkout` | 检出后 | 在新的 HEAD 上重新运行验证 |
| `pre-push` | 推送前 | 自动委托 `verify` 模板检查传出提交 |
使用以下命令将钩子安装到仓库中：
```bash
kimi-hooks install # 安装到当前仓库的 .git/hooks 中
kimi-hooks list # 显示已安装的钩子
kimi-hooks uninstall # 删除它们
```
有关配置选项和如何将钩子限定到特定路径的信息，请参见 [docs/HOOKS-GUIDE.md](docs/HOOKS-GUIDE.md)。
## 文档
- [MCP 设置指南](docs/MCP-SETUP.md) — 配置 MCP 服务器
- [钩子指南](docs/HOOKS-GUIDE.md) — Git 钩子配置
- [模型选择](docs/MODEL-SELECTION.md) — K2 与 K2.5 指南
- [克劳德代码集成](skills/Claude-Code-Integration.md) — 端到端集成指南
## 从 v1.0 迁移
v2.0 向后兼容。现有安装继续工作。
要升级：
```bash
./install.sh # 安装新组件
```
新组件是附加的 - 现有工作流程保持不变。
## 配置
### CLAUDE.md 集成
克米工作流部分包含在 `dist/.claude/skills/kimi-delegation/SKILL.md` 中的技能定义中。在您的项目的 `CLAUDE.md` 中添加一个 `克米研发子代理` 部分，以便克劳德代码遵守委托规则。典型的部分如下：
```markdown
## 克米研发子代理
**分工：** 克劳德 = 大脑（架构师、协调员、审查员），克米 = 手（开发者、实施者、调试器）
**工作流：** 设计（克劳德）-> 实现（克米）-> 审查（克劳德）-> 验证（克米）
## 委托规则
**委托给克米：** 功能实现、错误修复、重构、编写测试、多文件更改。
**自己保留：** 架构决策、设计审查、批准、用户沟通。
## 角色
**行动：** `implementer` `debugger` `refactorer` `simplifier`
**分析：** `reviewer` `auditor` `security`
```
### 上下文文件
在项目根目录中创建 `.kimi/context.md` 或 `KimiContext.md`。此内容会自动注入到每个克米查询中。
```markdown
# 项目上下文
- 框架：Next.js 15 with App Router
- 语言：TypeScript 严格模式
- 数据库：PostgreSQL with Prisma ORM
- 测试：Jest + Testing Library
## 关键约定
- 使用服务器操作进行突变
- 优先使用 React Server Components
- 所有 API 路由都需要身份验证
```
### 环境变量
| 变量 | 目的 |
|----------|---------|
| `KIMI_PATH` | 克米二进制文件位置的重写（在 Windows 上很有用） |
| `KIMI_FORCE_MODEL` | 强制模型选择（k2 或 k2.5） |
## 架构
```
+---------------------------------------------------------+
| 克劳德代码 |
| +-- /kimi-* 斜杠命令（dist/.claude/commands/） |
| +-- SKILL.md（dist/.claude/skills/kimi-delegation/） |
| +-- CLAUDE.md（用户配置委托规则） |
+----------------------------+----------------------------+
| 调用
v
+---------------------------------------------------------+
| skills/kimi.agent.wrapper.sh |
| +-- CLI 验证（kimi >= 1.7.0） |
| +-- 角色解析（.kimi/agents/*.yaml） |
| +-- 模板加载（.kimi/templates/*.md） |
| +-- 上下文注入（context.md，--diff） |
| +-- 提示组装 + 自动模型（K2 与 K2.5） |
+----------------------------+----------------------------+
| 委托给
v
+---------------------------------------------------------+
| 克米 CLI（kimi-for-coding） |
| +-- K2.5 大上下文分析 |
| +-- 基于代理的工具访问 |
| +-- 结构化输出 |
+---------------------------------------------------------+
v2.0 附加组件（独立于上述包装器）
+----------------------------+ +--------------------------+
| mcp-bridge/bin/ | | hooks/hooks/ |
| kimi-mcp-server | | pre-commit |
| （JSON-RPC via stdio: | | post-checkout |
| kimi_analyze, audit, | | pre-push |
| trace, verify） | | （在git事件上自动委托 |
+----------------------------+ | 调用） |
+--------------------------+
```
### 仓库布局
```
Climi/
+-- install.sh # 自动安装脚本
+-- uninstall.sh # 清洁卸载脚本
+-- kimi.ps1 # PowerShell shim（Windows）
|
+-- docs/ # v2.0 文档
| +-- MCP-SETUP.md # MCP 服务器设置指南
| +-- HOOKS-GUIDE.md # Git hooks 配置指南
| +-- MODEL-SELECTION.md # K2 vs K2.5 指南
|
+-- skills/
| +-- kimi.agent.wrapper.sh # 核心包装脚本
| +-- kimi-model-selector.sh # 模型选择器（v2.0）
| +-- kimi-cost-estimator.sh # 成本估算器（v2.0）
| +-- Claude-Code-Integration.md # 集成指南
|
+-- bin/ # v2.0 CLI 包装（安装到 ~/.local/bin）
| +-- kimi-mcp # MCP CLI 包装
| +-- kimi-mcp-setup # MCP Kimi-CLI 注册助手
| +-- kimi-hooks # Hooks 管理器
| +-- kimi-hooks-setup # Hooks 安装程序
|
+-- mcp-bridge/ # v2.0 MCP 服务器
| +-- bin/kimi-mcp-server # JSON-RPC 服务器入口
| +-- lib/ # 服务器内部（mcp-core, 工具等）
| +-- config/ # 默认配置 + 模型规则
| +-- tests/ # 桥接测试
|
+-- hooks/ # v2.0 git hooks（安装到 .git/hooks）
| +-- hooks/pre-commit
| +-- hooks/post-checkout
| +-- hooks/pre-push
| +-- lib/ # 共享钩子助手
| +-- config/ # 钩子配置
|
+-- .kimi/
| +-- agents/ # 7 个代理角色
| | +-- reviewer.yaml + .md
| | +-- auditor.yaml + .md
| | +-- security.yaml + .md
| | +-- debugger.yaml + .md
| | +-- refactorer.yaml + .md
| | +-- implementer.yaml + .md
| | +-- simplifier.yaml + .md
| +-- templates/ # 6 个查询模板
| +-- feature.md
| +-- bug.md
| +-- verify.md
| +-- architecture.md
| +-- implement-ready.md
| +-- fix-ready.md
|
+-- dist/ # Claude Code 工件（由 install.sh 复制）
+-- .claude/
+-- commands/kimi/ # 斜杠命令
| +-- kimi-analyze.md
| +-- kimi-audit.md
| +-- kimi-trace.md
| +-- kimi-verify.md
| +-- kimi-mcp.md # v2.0
| +-- kimi-hooks.md # v2.0
+-- skills/kimi-delegation/
+-- SKILL.md # Claude 技能定义
```
## 响应格式
所有 Kimi 代理返回结构化输出以便于一致的解析：
```markdown
## 概要
[1-2 句总结]
## 文件
- 路径/文件.ext:行号 - 描述
- 路径/另一个.ext:行号 - 描述
## 分析
[详细发现，代码分析，解释]
## 建议
1. 第一个行动项
2. 第二个行动项
3. 第三个行动项
```
## 故障排除
### "kimi not found"
```bash
# 安装 kimi CLI
uv tool install kimi-cli
# 或
pip install kimi-cli
# 验证安装
kimi --version
# 如果 PATH 问题仍然存在（Windows 上常见），设置 KIMI_PATH：
export KIMI_PATH=/path/to/kimi
```
### "jq: command not found"（v2.0）
```bash
# macOS
brew install jq
# Ubuntu/Debian
sudo apt-get install jq
# Windows（Git Bash）
choco install jq
```
### MCP/hooks 命令未找到
```bash
# 检查 ~/.local/bin 是否在 PATH 中
echo $PATH | grep ".local/bin"
# 添加到 PATH
export PATH="$HOME/.local/bin:$PATH"
# 重新运行安装程序
./install.sh
```
### "role not found"
```bash
# 检查 .kimi/agents/ 目录是否存在并包含 YAML 文件
ls -la .kimi/agents/
# 可用的角色在错误消息中显示
# 验证 YAML 文件是否存在：.kimi/agents/<role>.yaml
```
### "template not found"
```bash
# 检查 .kimi/templates/ 目录
ls -la .kimi/templates/
# 可用的模板在错误消息中显示
# 验证文件是否存在：.kimi/templates/<template>.md
```
### Windows 问题
1. **Git Bash 未找到：** 安装 Git for Windows，确保选择了“Git Bash”选项
2. **PowerShell shim 失败：** 运行 `.\kimi.ps1 --verbose` 查看它正在尝试使用的 bash
3. **路径问题：** 设置 `KIMI_PATH` 环境变量到 kimi.exe 位置
### 版本警告
```bash
# 警告：kimi CLI x.y.z 低于最低版本 1.7.0
# 升级 kimi CLI：
uv tool upgrade kimi-cli
# 或
pip install --upgrade kimi-cli
```
## 需求
| 组件 | 最低版本 | 备注 |
|-----------|-----------------|-------|
| **Kimi CLI** | >= 1.7.0 | `--quiet`, `--agent-file` 支持 |
| **Bash** | 任意现代版本 | Windows 上的 Git Bash |
| **jq** | >= 1.6 | MCP/hooks（v2.0）所需 |
| **Python** | >= 3.12 | Kimi CLI 所需 |
| **Git** | 任意版本 | 可选，用于 `--diff` 功能 |
| **OS** | macOS, Linux, Windows | 通过 WSL/Git Bash 支持 Windows |
## 许可证
MIT 许可证。
## 贡献
1. 分叉仓库
2. 进行更改
3. 使用 `./skills/kimi.agent.wrapper.sh --dry-run -r reviewer "test"` 进行测试
4. 确保所有角色和模板正确加载
5. 提交拉取请求
### 添加自定义角色
在 `.kimi/agents/` 中创建新角色：
```yaml
# .kimi/agents/my-role.yaml
version: 1
agent:
extend: default
name: my-role
system_prompt_path: ./my-role.md
# exclude_tools: [...] # 添加用于只读角色
```
```markdown
# .kimi/agents/my-role.md
# 我的自定义角色
您是一个[描述]。您的任务是[目标]。
## 流程
1. 第一步
2. 第二步
## 输出格式
使用 SUMMARY/FILES/ANALYSIS/RECOMMENDATIONS 结构。
## 约束
- 约束 1
- 约束 2
```
### 添加自定义模板
在 `.kimi/templates/` 中创建新模板：
```markdown
# .kimi/templates/my-template.md
# 我的模板
您正在帮助处理[任务类型]。
## 上下文
- 工作目录：${KIMI_WORK_DIR}
- 当前时间：${KIMI_NOW}
## 任务
[任务说明]
## 输出格式
[预期输出结构]
```
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器