mcpField
M
multica-autopilots

multica-autopilots

github.com/multica-aiエージェントワークフロー54.1k39 回インストール今日更新
リポジトリ

multica-autopilots について

Multicaのautopilotを調査・管理するエージェントスキルです。エージェントまたはスクワッドリーダーに作業を割り当てるルールを対象に、トリガー、実行モード、CLI操作、実行状況の調査を扱います。

主な機能

  1. 01autopilotの状態と実行履歴を確認
  2. 02スケジュールとWebhookトリガーを設定
  3. 03課題作成または実行のみを選択
  4. 04CLIでautopilotの状態を管理
  5. 05失敗または保留中のディスパッチを追跡

活用シーン

  1. 01autopilotが実行されなかった理由を調査
  2. 02Webhookの配信状態を確認
  3. 03エージェント作業を定期実行
  4. 04課題作成と直接タスク実行を選択

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/multica-ai/multica --skill multica-autopilots

インストール後、Claude Code で/multica-autopilotsを入力して読み込まれたか確認します。

同梱ファイルreferences/autopilots-source-map.md

詳細

Multica Autopilots

クイックスタート

Autopilots は永続的な自動化です。変更を加える前に必ずお読みください:

multica autopilot list --output json
multica autopilot get <autopilot-id> --output json
multica autopilot runs <autopilot-id> --output json

テストのために trigger、delete、trigger-delete、trigger-rotate-url を実行しないでください。これらは実際の副作用を伴います。

コアモデル

Autopilot はエージェントではありません。エージェント、またはスクワッドのリーダーエージェントに作業をディスパッチするルールです。

連鎖は次のとおりです: トリガーが発火(schedule、webhook、または manual)-> autopilot_run 行 -> execution_mode が出力を決定 -> 担当者の準備状況チェック -> issue/タスクの実行 -> 実行ステータスの同期。Webhook の前段には永続的な受け入れステップがあります: HTTP イングレスがキューに入った webhook_delivery を保存し、その冪等な実行を同期的に作成または再利用して、status=accepted|skipped と run_id を含む 200 を返します。その後、データベースリースのワーカーが受け入れられた実行を再開し、復旧可能な issue/タスクのディスパッチを担います。

実行モード:

  • create_issue は Multica の issue を作成し、実行を issue の状態として可視化します。
  • run_only はエージェントタスクを直接作成します。issue は作成されません。永続的な レポートの保存先は、他のタスクコンテキストや指示から取得する必要があります。

issue-title-template は {{date}} のみをサポートします。{{trigger_id}}、{{branch}}、その他の変数を勝手に作らないでください。

CLI

multica autopilot list --output json
multica autopilot get <autopilot-id> --output json
multica autopilot create --title "<title>" --description "<task prompt>" --agent <agent-name-or-id> --mode create_issue|run_only --output json
multica autopilot update <autopilot-id> --status active|paused --output json
multica autopilot runs <autopilot-id> --output json
multica autopilot trigger-add <autopilot-id> --kind schedule --cron "0 9 * * *" --timezone Asia/Shanghai --output json
multica autopilot trigger-add <autopilot-id> --kind webhook --label "ci" --output json
multica autopilot trigger <autopilot-id> --output json
multica autopilot trigger-rotate-url <autopilot-id> <trigger-id> --yes --output json

trigger は、ユーザーが手動実行を明示的に要求した場合にのみ使用してください。trigger-rotate-url は、Webhook URL をローテーションする場合にのみ使用してください。古い URL は無効になります。

autopilot get はデフォルトで webhook_token、webhook_path、webhook_url を伏せ字にしつつ、トークンが存在するかどうかとその機密性の低いヒントを報告します。ユーザーが実際の Webhook 認証情報の取得を明示的に要求した場合にのみ --show-secrets を追加してください。このコマンドは stderr に警告を出力します。Webhook トークンや署名用の情報をコメント、ログ、ドキュメント、PR に貼り付けないでください。

デバッグ

「なぜ実行されなかったのか」を調べるには:

  1. multica autopilot get <id> --output json — ステータス、モード、担当者、トリガー。
  2. multica autopilot runs <id> --output json — 実行ステータスと失敗理由。
  3. スクワッドに割り当てられている場合は、スクワッドを調べます: multica squad get <squad-id> --output json。実行はリーダーに送られます。
  4. 対象のエージェント/ランタイムを調べます: multica agent get <agent-id> --output json および multica runtime list --output json。
  5. Webhook の場合は、配信ステータスを調べます: queued はワーカーがディスパッチを完了していないことを意味します。failed はワーカーのエラーを保持しています。同じ X-GitHub-Delivery / Idempotency-Key でのプロバイダーによる再試行は、元の配信を再利用します。
  6. create_issue の場合は、実行が記録していれば、作成された issue を調べます。

副作用

これらは永続的な状態を変更したり、作業を開始したりします: create、update、delete、トリガーの追加/更新/削除/ローテーション、trigger、および /api/webhooks/autopilots/{token} への Webhook 呼び出し。

ソースに基づく詳細: references/autopilots-source-map.md。

コメント

Markdown 対応