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/

デフォルト設定

プロバイダー	CLI バイナリ	デフォルトモデル	最適な用途
xAI Grok	grok	grok-4.5	X／ウェブ検索、調査、画像生成、動画生成、汎用エージェント
Moonshot Kimi	kimi	kimi-code/k3 (1M コンテキスト)	フロントエンド UI／CSS／コンポーネント、長いコンテキストでのコード変更
Anthropic Claude	claude	fable -> Fable 5	最も複雑なコーディング、長時間のタスク、深い推論。opus／sonnet に切り替え可能

ユーザーが別のモデルを指定しない限り、常にこれらのデフォルト設定を優先してください。

ルーティングルール

1. ユーザーが Grok／X 検索／画像生成／動画生成／リアルタイム情報／マルチツールエージェント と指定した場合 → grok-4.5 を使って Grok CLI を使用します。
2. ユーザーが Kimi／フロントエンド作成／UI／CSS／React／Vue／ページのデザイン性／長いコンテキストでのフロントエンド変更 と指定した場合 → kimi-code/k3 を使って Kimi CLI を使用します。
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：UI の実装に K3 1M を使用し、具体的なファイルと検証メモを含めます。
• Claude Coding：複雑なコーディングにはデフォルトで Fable 5 を使用します。明示的に選択した場合は Opus 4.8 または Sonnet 5 を使用します。
• Claude Review：指摘事項を先に示す読み取り専用のレビュー用プロンプトです。
• Batch：独立した Grok／Kimi／Claude のジョブを、ネイティブのストリームイベント、上限付きキャプチャ、非公開ログ、成果物の Done Gate とともに同時実行します。
• 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. 複数のモデルを起動する前に、依存関係グラフを作成します。
   • どのジョブも別のジョブの出力を使わない → max_workers >= ジョブ数 として、batch を 1 回呼び出します。
   • 後続のジョブが先行ジョブの出力を使う → 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

注記：

• 単発呼び出しとバッチジョブでは、秘匿化された JSON 進捗イベント（started、heartbeat、activity、finished）が直ちに stderr に出力されます。
• バッチジョブでは、デフォルトで各 CLI のネイティブ JSON ストリームが使用されます。高頻度の差分は集約されます。Grok の思考テキストが正規化されたイベントにコピーされることはありません。
• batch は生の stdout/stderr、正規化された応答テキスト、events.jsonl、再開可能な状態、summary.json を書き出します。1 つの失敗によって、独立したジョブがキャンセルされることはありません。
• 実行ディレクトリのモードは 0700、ログ／設定／状態のモードは 0600 です。メモリ内の stdout/stderr キャプチャは上限付きですが、出力全体は引き続きディスクに書き込まれます。
• batch は独立した作業向けです。ステージ 2 がステージ 1 の出力を使用するため、dual は逐次実行のままです。
• オーケストレーターから独立したモデル呼び出しを 1 つずつ起動して比較と呼ぶのは避けてください。まず設定を作成し、その後 1 回のバッチ呼び出しを実行してください。
• 現在の CLI では、Kimi の --prompt は --yolo または --auto と併用できません。
• Grok をヘッドレスで使用する場合、ツールを無人で利用するには、多くの場合 --permission-mode bypassPermissions が必要です。
• Claude のエイリアスは、最新のファミリーリリース（fable、opus、sonnet）を指します。保護対象のトピックでは、Fable が Opus にフォールバックすることがあります。
• bypassPermissions はプロジェクトの編集とコマンドの実行を許可します。信頼できるワークスペースでのみ使用してください。無人での書き込みを意図しない場合は、より厳格なモードを選択してください。
• Grok で画像／動画を扱う場合は、偽の画像 URL を書き出すのではなく、ネイティブツール（image_gen／image_edit／/imagine／/imagine-video）を使うようモデルに指示してください。

タスクのプロンプト契約

Grok X／ライブ検索

必須事項：

• ネイティブのウェブ／X 検索ツールを使用する
• 投稿、指標、日付を捏造しない
• 時刻、全文／要約テキスト、メディアの有無、可能であればエンゲージメント、リンクを返す

Grok 画像

必須事項：

• ネイティブの画像ツールを使用する
• 実際に生成されたローカル／リモートのアセットパスを返す
• セーフティによってブロックされた場合は、停止して報告する

Grok 動画

必須事項：

• ネイティブの動画生成経路を使用する
• 生成された場合は、ショットプランと最終アセットのパス／URL を報告する
• 利用できない場合は、CLI エラーとともに利用できない旨を伝える

Kimi フロントエンド

必須事項：

• まず既存のプロジェクトスタイルを確認する
• アドバイスだけでなく、実際のファイルを実装する
• デザインシステムのトークンがある場合は維持する
• 変更したファイルと、簡潔なビジュアル QA チェックリストを記載する
• デモ用の足場づくりより、プロダクション品質の UI 仕上げを優先する

Claude のコーディング／レビュー

必須事項：

• 編集前にプロジェクトのルールと既存コードを確認する
• 最高の性能を求める場合は Fable を使用し、ユーザーが速度とコストのバランスを選択した場合は Opus／Sonnet を使用する
• 既存の変更を維持し、プロジェクトで提供されているチェックで検証する
• レビューでは、まず指摘事項を報告し、編集は行わない

出力契約

呼び出しのたびに、以下を報告してください。

1. 実際に使用したプロバイダーとモデル
2. コマンドの形式（シークレットは含めない）
3. 結果の概要／アーティファクトのパス
4. 該当する場合は、ツール使用の証拠（検索、画像／動画の生成、ファイル編集）
5. 失敗と次の対処（login、バイナリの不足、権限、レート制限）
6. バッチの場合：summary.json、各ジョブのステータス、経過時間、stdout/stderr/response の各パス、Done Gate のチェック、タイムアウト／キャンセルの有無

境界

• Grok、Kimi、Claude の設定ファイルに含まれる認証情報や非公開のプロバイダー設定を保存したり、そのまま出力したりしないでください。
• CLI の証拠がない限り、X の検索・画像生成・動画生成が成功したと主張しないでください。
• このスキルから main にプッシュしたり、アカウントを公開したりしないでください。
• ユーザーがコンテキスト内にあるローカルファイルの編集だけを求めている場合、プロジェクト固有のコーディングエージェントを置き換えないでください。外部の高性能モデル 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