核心用法
Coding CLI Management 是一项面向多 Agent 系统的委托式编码技能。Manager 通过检测 ~/coding-cli-config.json 配置，识别可用的 AI 编码 CLI 工具（Claude Code / Gemini CLI / qodercli），并在管理员授权后代 Worker 执行编码任务。
工作流程分为四步：
1. 首次检测：运行 detect-available-cli.sh 扫描环境，向管理员确认是否启用 CLI 委托模式
2. 任务分配：若启用，为 Worker 注入 coding-cli skill，并在 spec.md 中附加「Coding CLI Mode」模板
3. 请求处理：解析 Worker 发送的 coding-request: 消息，同步 MinIO 工作区、创建处理锁、调用 run-coding-cli.sh 执行 CLI 工具
4. 失败回退：执行失败时通知 Worker 自行编码，并向人类管理员推送诊断信息（凭证、软链、binary 可用性）
显著优点
- 人机协作分离：Worker 专注提示词工程，Manager 负责 CLI 执行与状态管理，降低认知负担
- 资源复用：支持 Claude、Gemini、qodercli 多工具热切换，避免重复安装
- 并发安全：通过
task-coordination技能的 processing marker 机制防止多进程冲突 - 故障透明：失败时自动降级至人工编码，并输出结构化诊断建议
潜在缺点与局限性
- 强依赖外部 CLI：需预先在容器内安装并配置凭证（
~/.{cli}/），首次部署成本较高 - 超时硬编码：当前
--timeout 600固定，面对大型项目可能不足 - 回滚机制缺失：CLI 执行成功后直接推送 MinIO 覆盖，无自动快照或版本回退
- 语言耦合：管理员交互需匹配其使用语言，增加了本地化复杂度
适合人群
- 运行 Hiclaw 多 Agent 平台的开发团队
- 需要将「代码生成」与「代码执行」职责分离的组织
- 已在本地或容器化环境部署 Claude Code、Gemini CLI 或 qodercli 的用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 凭证泄露 | CLI token 存储于 `~/.{cli}/`，需确保容器隔离与权限控制 || 并发冲突 | 虽有过期时间为 15 分钟的 processing marker，但极端情况下可能出现竞态 |
| 数据覆盖 | MinIO 同步使用 `--overwrite`，误操作可能导致工作区数据丢失 |
| 供应链风险 | 依赖外部 CLI binary，需验证来源完整性 |
建议：生产环境启用前，应在 staging 环境验证凭证挂载、软链正常性及超时阈值适配性。