用途:kimi-delegate 让你充当编排者,把一项有边界的编码任务交给独立的实现者——Kimi Code CLI(kimi),然后审查它产出的 diff 并自行落地提交。你负责写任务简报和做判断,Kimi 在自己的会话里写代码,你负责验证与提交。该循环只需 shell 命令和文件访问,任何同类编排器都能驱动。
不适用场景:任务小到可直接内联完成,委派开销不划算;kimi CLI 未安装或未认证;需要 CLI 强制只读的实现者——无头 Kimi 没有只读模式。
前置条件:用 brew install kimi-code 安装(macOS/Linux),或按官方文档使用原生安装器;用 kimi login 认证(设备码流程,无 TUI),或在 TUI 中用 /login;确认 kimi --version 成功;在目标 git 仓库中工作,或用 --cd 指向它。
模型别名:省略 --model 时 Kimi 使用 config.toml 中的 default_model;要选其他别名,传 --model <你 kimi 配置中的别名>,别名是用户自定义配置键,应使用已配置好的而非自创。
循环五步:1)写简报——Kimi 只能看到你发送的文本和它能在工作区检查的内容,无聊天历史或共享上下文;需包含目标、当前状态、要改什么、不要动什么、项目实际门禁和报告契约,并告知不要提交,一份简报只放一个任务。2)派发——使用捆绑的 helper:node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo,可选 --model <别名>、--resume-last、--session <id>、--timeout 2h(默认 30m,实现类简报常需 1-2h),--help 查看全部选项;子进程 cwd 固定工作区,额外目录用可重复的 --add-dir;relay 默认把产物写到系统临时目录且从不提交。3)等待完成——helper 阻塞至 Kimi 结束,可用后台命令运行或后台轮询 result.json;预运行用法错误退出码 2 且不写结果,kimi 缺失退出码 127 并写 status: "kimi_unavailable";完成意味着进程退出且 result.json 存在,完整报告在 finalMessage 字段。4)审查——不要相信自述:自己重跑项目门禁,对照简报读 diff(从 touchedFiles 开始),运行已安装的守卫技能,删除或重命名后做迁移往返并 grep 悬空引用。5)落地——实现者改工作树,编排者提交;门禁通过且 diff 成立后才提交;需返工时用 --resume-last 或 --session <id> 发增量简报再审查。
自主性与权限:无头 -p 模式下 Kimi 始终以自动权限模式运行、从不请求批准;Kimi 拒绝 --prompt 与 --yolo、--auto、--plan 组合,因此 relay 不传这些,也不提供 --read-only 或 --full-access;没有 CLI 强制只读模式,每次运行后都要检查 touchedFiles 和 diff,diff 而非标志才是变更的保证。
授权模型:委派需人工主动选择;一旦同意(如“运行这个队列”“继续”),提交已验证且通过门禁的工作即为约定契约。两条限制:呈现而非吸收(报告 Kimi 的设计决策、合理但未被要求的转向、非阻塞小问题),范围变更时停下(若正确完成需要超出简报,应询问而非扩大授权)。
参考文档:references/writing-the-brief.md(简报结构、报告契约、真实门禁、argv 传递、增量简报)、references/dispatch-and-poll.md(标志、产物、result.json、轮询、失败恢复)、references/review-and-land.md(审查清单、提交边界、通过 Kimi 会话返工)、references/multi-task-queues.md(顺序队列、约束传递、进度跟踪、最终一致性检查)。