mcpField
K
kimi-runner

kimi-runner

github.com/robsonrungAgent 工作流249 次安装1 天前更新
代码仓库

关于 kimi-runner

kimi-runner 是通过共享的 `pi-runner` 实现执行提示词的技能，默认经 OpenRouter 将 Kimi 席位固定到 `moonshotai/kimi-k3`。它支持按角色限制工具并提供一致的输出封装，且不会回退到其他服务商。

主要功能

  1. 01通过共享的 `pi-runner` 执行
  2. 02经 OpenRouter 固定使用 Kimi K3
  3. 03支持覆盖模型
  4. 04分析默认只读
  5. 05可限制或禁用工具
  6. 06不回退到其他服务商

适用场景

  1. 01在 Kimi 席位上运行提示词
  2. 02按指定角色审查代码
  3. 03进行只读分析
  4. 04一致地比较运行器输出

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/robsonrung/rar-skills --skill kimi-runner

安装后在 Claude Code 中输入/kimi-runner确认已加载。

附带文件agents/openai.yamlscripts/run_kimi.py

详细介绍

Kimi Runner

通过共享的 pi-runner 实现，以 Kimi 席位的身份执行提示词。这取代了之前基于 Cline 的适配层——每次调用都会固定使用 --provider openrouter --model moonshotai/kimi-k3，因此该席位不再依赖 Cline 可变状态恰好指向的服务商；回答始终来自转发的 Moonshot 模型，并通过 OpenRouter 提供服务。

默认模型

  • moonshotai/kimi-k3 — Moonshot 的旗舰 Kimi K3 席位（擅长长周期编码、理解大型代码库、支持 1M-token 上下文并始终启用思考），每次运行都会固定使用 --provider openrouter --model moonshotai/kimi-k3。K3 只有一个 ID，不存在 -code/-thinking 变体。使用 --model 可将 Kimi 席位指向其他 OpenRouter 模型 ID。

前置条件

  • 已安装 pi CLI，且位于 PATH 中（npm install -g @mariozechner/pi-coding-agent）
  • 环境中设有 OPENROUTER_API_KEY（或 Pi 的身份验证存储中有 OpenRouter 凭据）

安全模型

此技能委托给 pi-runner，因此执行和数据共享模型与 Pi 封装器相同——参见 ../pi-runner/SKILL.md。运行环境是隔离的（不会发现扩展、技能或 AGENTS.md/CLAUDE.md）。分析角色（除 implementer 外的所有角色）默认处于只读模式（仅启用 Pi 的文件读取工具）。传入 --allow-write 可选择退出只读模式，传入 --no-tools 可完全禁用工具。

共享封装器参考

支持的选项、角色、--json 输出封套键约定、返回代码和注意事项均与共享封装器相同——请阅读 shared/references/runner-common.md，了解共享标志、封套键、返回代码和席位保真规则。封套由 pi-runner/scripts/run_pi.py 生成，其中 runner=kimi、effective_runner=pi、effective_provider=moonshotai（根据 moonshotai/... 模型 ID 推断）；native_provider=openrouter 是提供服务的网关。

用法

python3 .agents/skills/kimi-runner/scripts/run_kimi.py "your prompt here"

示例

python3 .agents/skills/kimi-runner/scripts/run_kimi.py "Summarize the core module architecture"
python3 .agents/skills/kimi-runner/scripts/run_kimi.py --prompt-file /tmp/review.md --role codereviewer
python3 .agents/skills/kimi-runner/scripts/run_kimi.py "Read-only analysis" --restrict-tools --json
python3 .agents/skills/kimi-runner/scripts/run_kimi.py "Answer from the brief only" --no-tools --json

行为

  1. 委托给共享的 pi-runner 实现，并将 runner 身份设为 kimi（封套报告 runner=kimi、effective_runner=pi）。
  2. 每次调用都固定使用 --provider openrouter --model moonshotai/kimi-k3，因此实际回答问题的就是 Kimi 席位所对应的模型——不存在可能在不知情的情况下将请求改路的可变服务商状态。
  3. 绝不回退到其他服务商。缺少 CLI 时会明确阻止该席位（status: seat_unavailable、return_code -2）；缺少凭据时会报告 status: auth_missing 和 auth_ok: false——这就是席位保真，也是每个 runner 都遵循的同一原则：绝不以其他模型的回答替代 Kimi 席位的回答。
  4. 保留共享封套，以便各委员会始终能一致地比较 Kimi 与其他 runner 的输出。

迁移说明

此技能不再使用基于 Cline 的适配层（及其 --lane kimi 隔离身份验证工作流），现在仅依赖 pi 和 OPENROUTER_API_KEY。此前专用的 kimi-cli 二进制文件也不会被调用。如果其他工具仍直接通过 shell 调用 cline 或 kimi-cli，则不受此更改影响。

评论

支持 Markdown