CLI Worker Skill (Kimi CLI)

🖥️ Kimi CLI 并行委托,隔离执行无忧

将编码任务委托给 Kimi CLI 代理在独立 git worktree 中并行执行,支持无头自动化,需手动安装认证 CLI

收藏
4.3k
安装
1.2k
版本
0.1.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

CLI Worker Skill 是一个 OpenClaw 代理技能,用于将编码任务委托给 Kimi CLI 在隔离的 git worktree 环境中执行。主要适用场景包括:用户明确要求将任务委托给 Kimi/CLI worker、需要隔离的编码任务以避免 git 冲突、需要并行运行多个任务不阻塞主代理,以及需要从 OpenClaw 非交互式地运行 Kimi CLI 的头less任务。

该技能的核心命令为 cli-worker execute "任务提示",可选 --constraint--success 参数指定约束与成功条件。执行后会创建独立的 git worktree(若处于 git 仓库中),任务完成后可通过 --output-format text 获取完整纯文本输出。其他辅助命令包括 cli-worker status <taskId> 查询状态、cli-worker worktree list/remove 管理工作树、cli-worker cleanup --older-than N 清理旧工作树。

任务完成后,若需保留结果,从主分支运行 git merge openclaw/<taskId> 后移除 worktree;若无需保留,直接移除即可。

显著优点

1. 真正的并行执行:相比 sessions_spawn 可能创建永不处理的僵尸会话,CLI 方式确保任务实际运行
2. 完整的隔离性:每个任务在独立 git worktree 中执行,彻底避免分支冲突和状态污染

3. 原生 Kimi 能力:直接调用官方 Kimi CLI,获得完整的代码生成、理解和编辑能力

4. 灵活的工作流:支持约束条件、成功标准定义,以及保留/丢弃结果的显式决策

5. 自动化友好:支持非交互式 headless 执行,适合 CI/CD 或批量处理场景

潜在缺点与局限性

1. 依赖外部 CLI:必须用户手动安装 kimi-cliuv tool install kimi-cli 或官方脚本),并完成 OAuth 认证(/login),技能本身不管理凭证
2. 环境配置复杂:需要确保 CLI 在 PATH 中可用,涉及 npm 构建、link 等步骤,网关重启等操作

3. 无内置重试机制:若 sessions_spawn 失败需手动检测并切换为 cli-worker execute

4. worktree 管理开销:用户需手动决定合并或清理,长期运行可能积累大量 worktree

5. 平台限制:依赖 git worktree 功能,对非 git 项目或非 Unix-like 环境支持有限

适合人群

  • 需要并行处理多个独立编码任务的开发者
  • 追求任务隔离、避免分支冲突的团队
  • 希望将 Kimi 能力集成到自动化工作流(如 OpenClaw 代理链)的高级用户
  • 愿意投入环境配置、熟悉命令行和 npm/git 工具的技术用户

常规风险

  • 认证风险:OAuth 令牌由用户本地管理,若设备共享或令牌泄露可能导致账户被滥用
  • 代码执行风险:Kimi CLI 生成的代码在本地直接执行,存在潜在的恶意代码或误操作风险
  • worktree 残留风险:未及时清理的 worktree 可能占用磁盘空间,或包含未合并的敏感代码
  • 依赖漂移:Kimi CLI 版本更新可能导致行为不一致,需保持版本同步
  • 合并冲突:虽在独立 worktree,但合并回主分支时仍可能产生冲突

CLI Worker Skill (Kimi CLI) 内容

手动下载zip · 3.1 kB
AGENTS.mdtext/markdown
请选择文件