qiaomu-model-cli

Qiaomu Model CLI

通过本机 Grok CLI、Kimi Code CLI 和 Claude Code CLI，进行可验证的强模型调用。

Copyright (c) 向阳乔木

• X: https://x.com/vista8
• GitHub: https://github.com/joeseesun/

默认设置

Provider	CLI binary	Default model	Best for
xAI Grok	grok	grok-4.5	X/网页搜索、研究、生图、生视频、通用 Agent
Moonshot Kimi	kimi	kimi-code/k3（1M 上下文）	前端 UI/CSS/组件、长上下文改码
Anthropic Claude	claude	fable -> Fable 5	最复杂的编码、长任务、深度推理；可切换到 opus / sonnet

除非用户指定其他模型，否则始终优先使用这些默认设置。

路由规则

1. 用户提到 Grok / X 搜索 / 生图 / 生视频 / 实时信息 / 多工具 Agent → 使用 Grok CLI 和 grok-4.5。
2. 用户提到 Kimi / 写前端 / UI / CSS / React / Vue / 页面审美 / 长上下文改前端 → 使用 Kimi CLI 和 kimi-code/k3。
3. 用户要求多个模型对同一任务独立产出/比较/基准测试 → 使用 batch；在隔离的工作目录中并发启动所有独立任务。
4. 用户要求一个模型研究，另一个模型根据研究结果实现 → 使用依赖式 dual；此流程有意采用顺序执行。
5. 用户提到 Claude Code / Fable / Opus / Sonnet / 复杂编码 / 多文件重构 / 严格代码审查 → 使用 Claude Code。默认使用 fable；用户明确指定的别名优先。
6. 如果 Grok 原生搜索/工具可以完成任务，且用户想用 Grok，则不要为 X 使用 OpenCLI。
7. 优先使用可变别名（fable、opus、sonnet），而非脆弱的、带日期的 Claude 模型 ID。如果默认设置失效，运行 doctor 并报告实时 CLI 错误。
8. 绝不输出 API 密钥、OAuth 令牌、Cookie、网关 URL 或完整的身份验证/设置文件。

模式

• Doctor：检查二进制文件、登录状态和默认模型。
• Grok Chat/Agent：使用工具权限执行非交互式 Grok 任务。
• Grok X/Web：强制使用原生搜索/抓取工具获取实时信息。
• Grok Image：通过 Grok 原生图像工具 / /imagine 生成或编辑图像。
• Grok Video：通过 /imagine-video 或原生视频工具生成视频。
• Kimi Frontend：使用 K3 1M 实现 UI，并提供具体文件和验证说明。
• Claude Coding：复杂编码任务默认使用 Fable 5；明确指定时使用 Opus 4.8 或 Sonnet 5。
• Claude Review：只读审查提示词，优先列出发现的问题。
• Batch：独立的 Grok/Kimi/Claude 任务并发运行，使用原生流事件、有界捕获、私有日志和产物完成门禁。
• Retry：从之前的 summary.json 中仅重跑失败的任务，并创建新的运行目录。
• Dual：依赖式流水线；先由 Grok 收集事实/素材，再将结果交给 Kimi 实现。

核心工作流

1. 判断意图：搜索/研究、媒体、前端、复杂编码/审查、独立批处理或依赖式双阶段流程。
2. 首次在会话中使用，或调用失败时，检查环境：

python3 scripts/check_env.py

3. 选择提供方和模型：
   • Grok 默认值：-m grok-4.5
   • Kimi 默认值：-m kimi-code/k3
   • Claude 默认值：--model fable（当前为 Fable 5）；可选项为 opus（Opus 4.8）、sonnet（Sonnet 5）
4. 编写任务提示词，告知 CLI 在适用时使用原生工具。
5. 启动多个模型之前，绘制依赖关系图：
   • 没有任务使用其他任务的输出 → 调用一次 batch，且 max_workers >= job count
   • 后续任务使用前序任务的输出 → 使用 dual 或显式分阶段的流水线
6. 对于并发写入任务，为每个任务分配独立的 cwd；不要让多个模型编辑同一目录。
7. 通过包装器（首选）或原始 CLI 调用。
8. 对于会生成文件的工作，声明 expects 和可选的 verify_commands；仅退出码为零不代表任务已完成。
9. 保持进度可见：原生提供方事件会统一格式，默认每 15 秒发送一次心跳。
10. 遇到中断时，让包装器取消所有活动进程组。使用 retry --summary 恢复，不要重新运行已成功的任务。

首选包装器

# Grok research / X search
python3 scripts/qiaomu_model_cli.py grok --task x-search --prompt "查 @vista8 最近3条帖子，给正文和链接"

# Grok image
python3 scripts/qiaomu_model_cli.py grok --task image --prompt "一张极简黑白海报，主题是 AI coding"

# Grok video
python3 scripts/qiaomu_model_cli.py grok --task video --prompt "一只猫在爵士酒吧弹钢琴"

# Kimi frontend
python3 scripts/qiaomu_model_cli.py kimi --task frontend --prompt "把这个 landing hero 改成更精致的杂志感布局" --cwd /path/to/project

# Claude complex coding (Fable 5 default)
python3 scripts/qiaomu_model_cli.py claude --task coding --prompt "完成这个多文件重构并跑测试" --cwd /path/to/project

# Claude with a lower-cost latest model
python3 scripts/qiaomu_model_cli.py claude --model sonnet --task coding --prompt "修复这个组件" --cwd /path/to/project

# Three independent implementations: concurrent fan-out
python3 scripts/qiaomu_model_cli.py batch \
  --config examples/batch-homepages.json \
  --max-workers 3 \
  --log-dir logs/model-run

# Retry only failed jobs from a prior run
python3 scripts/qiaomu_model_cli.py retry \
  --summary logs/model-run/summary.json \
  --log-dir logs/model-retry

# Dependent pipeline: Grok output feeds Kimi
python3 scripts/qiaomu_model_cli.py dual --prompt "研究 2026 AI coding CLI 趋势，并写一个单页展示站"

原始 CLI 基线

Grok：

grok -p "<PROMPT>" -m grok-4.5 \
  --permission-mode bypassPermissions \
  --output-format plain \
  --max-turns 12

Kimi：

kimi -p "<PROMPT>" -m kimi-code/k3 --output-format text

Claude Code：

claude -p "<PROMPT>" --model fable --effort xhigh \
  --output-format text --permission-mode bypassPermissions \
  --no-session-persistence

注意：

• 单次调用和批处理作业会立即向 stderr 输出经过脱敏的 JSON 进度事件（started、heartbeat、activity、finished）。
• 批处理作业默认使用各 CLI 原生的 JSON 流。高频增量会合并；Grok 的思考文本绝不会复制到规范化事件中。
• batch 会写入原始 stdout/stderr、规范化响应文本、events.jsonl、可恢复状态和 summary.json；一个作业失败不会取消其他独立作业。
• 运行目录的权限模式为 0700；日志/配置/状态文件的权限模式为 0600。内存中的 stdout/stderr 捕获内容有大小上限，但完整输出仍会继续写入磁盘。
• batch 用于独立任务。dual 保持顺序执行，因为第 2 阶段会使用第 1 阶段的输出。
• 不要让编排器逐个启动独立的模型调用，然后称之为对比；应先创建配置，再调用一次批处理。
• 当前 CLI 中，Kimi 的 --prompt 不能与 --yolo 或 --auto 组合使用。
• Grok 在无人值守使用工具时通常需要 --permission-mode bypassPermissions。
• Claude 别名会跟随最新的系列版本：fable、opus、sonnet。对于受保护的话题，Fable 可能会回退到 Opus。
• bypassPermissions 允许修改项目和执行命令。仅在可信工作区中使用；如果不希望无人值守时写入内容，请选择限制更严格的模式。
• 对于 Grok 图像/视频任务，应指示模型使用原生工具（image_gen / image_edit / /imagine / /imagine-video），而不是编造图像 URL。

任务提示词约定

Grok X / 实时搜索

要求：

• 使用原生 Web/X 搜索工具
• 不得捏造帖子、指标或日期
• 返回时间、全文/摘要、媒体标记、可用时的互动数据，以及链接

Grok 图像

要求：

• 使用原生图像工具
• 返回实际生成的本地/远程资源路径
• 如果因安全限制而受阻，请停止并说明

Grok 视频

要求：

• 使用原生视频生成路径
• 报告镜头计划，以及生成后的最终资源路径/URL
• 如果不可用，请说明不可用并提供 CLI 错误

Kimi 前端

要求：

• 先阅读现有项目的风格
• 实际修改文件，而不只是提供建议
• 如有设计系统令牌，须予以保留
• 列出已更改的文件，并提供简短的视觉 QA 检查清单
• 优先打造适合生产环境的精致 UI，而非演示用脚手架

Claude 编码/审查

要求：

• 修改前先阅读项目规则和现有代码
• 要求最高能力时使用 Fable；用户选择速度/成本平衡时使用 Opus/Sonnet
• 保留现有更改，并使用项目提供的检查进行验证
• 进行审查时，先报告发现的问题，不要修改

输出约定

每次调用都须报告：

1. 实际使用的提供方 + 模型
2. 命令形式（不包含机密信息）
3. 结果摘要/产物路径
4. 相关时的工具使用证据（已搜索、已生成图像/视频、已编辑文件）
5. 失败原因和下一步修复方式（登录、缺少二进制文件、权限、速率限制）
6. 对于批处理：summary.json、每个作业的状态、耗时、stdout/stderr/响应路径、Done Gate 检查，以及任何超时/取消情况

边界

• 不要存储或回显 Grok、Kimi 或 Claude 配置文件中的凭据或私有提供商设置。
• 没有 CLI 证据时，不要声称 X 搜索、图片或视频操作成功。
• 不要通过此技能推送到 main 或发布账号。
• 如果用户只想编辑当前上下文中的本地文件，不要替换项目专用的编码 Agent；只有当重点是调用外部强模型 CLI 时，才使用此技能。
• 不要在同一个 cwd 中安排并发写入任务；应隔离输出，并在所有任务完成后再合并。
• 不要将心跳视为模型成功。成功仍须以 CLI 退出代码和预期产物为准。
• 不要将思维或推理文本解析为公开进度。保留原始流的私密性，仅输出安全计数器。
• 不要盲目重新运行整个成功的批次。使用 retry --summary，仅在新目录中执行失败的任务。
• 公开文档不得将私有的绝对机器路径硬编码为必需用法。

必读内容

1. references/routing.md
2. references/grok-cli.md
3. references/kimi-cli.md
4. references/claude-cli.md
5. references/frontend-playbook.md
6. references/batch-and-progress.md
7. references/provider-adapters.md

实用命令

python3 scripts/check_env.py
python3 scripts/qiaomu_model_cli.py doctor
python3 scripts/qiaomu_model_cli.py grok --task chat --prompt "..."
python3 scripts/qiaomu_model_cli.py kimi --task frontend --prompt "..." --cwd .
python3 scripts/qiaomu_model_cli.py claude --task coding --prompt "..." --cwd .
python3 scripts/qiaomu_model_cli.py batch --config examples/batch-homepages.json --max-workers 3
python3 scripts/qiaomu_model_cli.py retry --summary logs/model-run/summary.json
python3 -m unittest discover -s tests -v
python3 scripts/validate_skill.py .

元数据

• 技能：qiaomu-model-cli
• 版本：1.3.0
• 所有者：向阳乔木
• 根据本地 CLI 元数据验证的默认值：Grok grok-4.5、Kimi kimi-code/k3 (1M)、Claude 别名 fable / opus / sonnet