Delegate X Research

delegate-x-research

x.com / X の調査を、X 調査 capability を持つ子プロセスへ委譲する。task_type=xresearch、既定モデル grok-build。他 delegate と同じ request/response protocol v1 を使う。現在の実装バックエンドは Grok CLI で、grok -p -m へリクエストを渡す。

スクリプトパス

• Claude Code: skill_dir=.claude/skills/delegate-x-research
• Codex: skill_dir=.agents/skills/delegate-x-research

以降のコマンド例は Claude Code の .claude/skills/delegate-x-research を使う。Codex で使う場合は、同じ相対構造の .agents/skills/delegate-x-research に読み替える。

モデル価格参照

コスト分析・単価比較が必要な場合のみ、<skill_dir>/model-token-prices.json を読む。このデータは参照用であり、delegate の起動可否判定には使わない。

委譲する前に

この skill は、X 上の投稿・アカウント・スレッド・検索結果・直近の反応・コミュニティノートなど、Grok の X 調査能力を使う必要がある場合に使う。通常の Web ページ、リポジトリ内ドキュメント、コード調査だけで足りる場合は、main が直接処理するか delegate-explore を使う。

リクエストには、調査対象、期間、言語、地域、確認したい主張、必要な粒度、引用してよいソース種別を明記する。特に「最新」「今日」「昨日」などの相対日付は、request 作成時点の具体的な日付も併記する。

実行フロー（one-shot）

1. リクエスト作成: Objective / Scope / Context / Acceptance criteria / Verification / Constraints の Markdown を stdin で渡す。調査対象、期間、言語、地域、確認したい主張、必要な粒度、引用してよいソース種別を明記する。特に「最新」「今日」「昨日」などの相対日付は、request 作成時点の具体的な日付も併記する。
   • DELEGATE_X_RESEARCH_MODEL は effort suffix に対応しない。@ 付きモデルは prepare が exit 6 で fail-closed する。
2. 実行: out="$(printf '%s' "$req_md" | bash .claude/skills/delegate-x-research/scripts/run-x-research.sh "$PARENT_TASK_TYPE_CHAIN" "$REQUESTER_SESSION_ID")"（top-level 起動なら $PARENT_TASK_TYPE_CHAIN は空でよい）。
   • run-x-research は内部で prepare → delegate-x-research-grok → read-response を順に実行し、stdout は成功・失敗とも単一 JSON（exit_code / status / content / content_truncated / response_file / observe_file / run_dir）を返す。
   • selector 省略時の既定は auto。
   • exit code は内部スクリプトを透過する。exit 3=前提不足 / exit 4=委譲サイクルなら中止する。exit 6 の場合は、許容値列挙を含む stderr の 1 行をそのままユーザーへの説明に使う。
   • run-x-research.sh は dispatch 前に observe_file: <path> を stderr へ先出しする。run-x-research.sh が Bash timeout で background へ退避しただけの場合は再実行しない（再実行は worker の二重起動になり、implement / chore では同一 worktree の同時書き換えになる）。復旧は bash .claude/skills/delegate-x-research/scripts/read-json.sh .state.phase "$observe_file" を見て分岐する。ended または stalled なら終端なので、どちらでも bash .claude/skills/delegate-x-research/scripts/read-json.sh .run.response_file "$observe_file" で応答パスを取得して bash .claude/skills/delegate-x-research/scripts/read-response.sh で読む（stalled でも failed response が書かれる）。running の間は .heartbeat.ts が進んでいれば待つ。running のまま .heartbeat.ts が DELEGATE_OBSERVE_HEARTBEAT_INTERVAL（既定 10 秒）を大きく超えて進まない場合は dispatcher ごと停止しているので応答は来ない。この場合に限り新しい run を出してよい。background 退避した出力ファイルは stdout と stderr が合流するが、read-json.sh は既知の harness 行（空行 / observe_file: 行 / [exited with ...] 行）に囲まれた JSON object を切り出して読める。
   • 非対話モードの親（claude -p 等）では run-x-research を必ずフォアグラウンドで実行し、委譲所要時間より長い Bash timeout（Claude Code なら BASH_DEFAULT_TIMEOUT_MS / BASH_MAX_TIMEOUT_MS または Bash tool の timeout 引数）を設定する。
3. レスポンス消費と検証: status="$(printf '%s' "$out" | bash .claude/skills/delegate-x-research/scripts/read-json.sh .status)" / content="$(printf '%s' "$out" | bash .claude/skills/delegate-x-research/scripts/read-json.sh .content)" を読む。content_truncated が true なら response_file="$(printf '%s' "$out" | bash .claude/skills/delegate-x-research/scripts/read-json.sh .response_file)" を取り出し、bash .claude/skills/delegate-x-research/scripts/read-response.sh "$response_file" <N> で Findings / Sources / Limitations / Blockers など必要 section だけ段階読みする。読了後、worker の本文を再要約しない。main のユーザー向け応答は、必要な結論と参照すべき section を短く示す。重要な主張について、Sources に投稿URL・アカウント・投稿日時・確認時刻が含まれるか確認する。根拠が弱い箇所や Grok 側のアクセス制限は Limitations / Blockers として扱い、断定しない。

高度なフロー（個別スクリプト）

dispatch 中の observe 監視、background 実行など、途中で親の判断を挟むフローでは従来の個別スクリプトを使う。

1. 準備: Objective / Scope / Context / Acceptance criteria / Verification / Constraints の Markdown を stdin で渡す。exit 3=前提不足 / exit 4=委譲サイクルなら中止。
   • DELEGATE_X_RESEARCH_MODEL は effort suffix に対応しない。@ 付きモデルは prepare が exit 6 で fail-closed する。
   • out="$(printf '%s' "$req_md" | bash .claude/skills/delegate-x-research/scripts/prepare.sh xresearch DELEGATE_X_RESEARCH_MODEL grok-build "$PARENT_TASK_TYPE_CHAIN" "$REQUESTER_SESSION_ID")"（top-level 起動なら $PARENT_TASK_TYPE_CHAIN は空でよい）
   • model="$(printf '%s' "$out" | bash .claude/skills/delegate-x-research/scripts/read-json.sh .model)" / request_file="$(printf '%s' "$out" | bash .claude/skills/delegate-x-research/scripts/read-json.sh .request_file)" / response_file="$(printf '%s' "$out" | bash .claude/skills/delegate-x-research/scripts/read-json.sh .response_file)" / run_dir="$(printf '%s' "$out" | bash .claude/skills/delegate-x-research/scripts/read-json.sh .run_dir)" / observe_file="$(printf '%s' "$out" | bash .claude/skills/delegate-x-research/scripts/read-json.sh .observe_file)"
2. 調査実行: 現在は bash .claude/skills/delegate-x-research/scripts/delegate-x-research-grok.sh "$model" "$request_file" "$response_file" "$run_dir" "$observe_file" で Grok CLI を起動する。Grok CLI は X / network access とローカルセッション状態を使うため、sandboxed requester では権限付き実行（Codex では sandbox_permissions=require_escalated）で起動する。非対話モードの親（claude -p 等）では子プロセス起動を必ずフォアグラウンドで実行し、委譲所要時間より長い Bash timeout（Claude Code なら BASH_DEFAULT_TIMEOUT_MS / BASH_MAX_TIMEOUT_MS または Bash tool の timeout 引数）を設定する。実行中の通常監視は observe_file から state.phase / state.started_at / heartbeat.ts / heartbeat.stdout_bytes / heartbeat.stderr_bytes / heartbeat.last_stream_change_at だけを read-json.sh で読む。state.phase は prepared | running | superseded | stalled | ended。prepared / superseded は dispatch されなかった observe（state.started_at == null、usage は未設定で read-json.sh では null 相当）なので、usage を集計する場合は分母から除外する。
3. レスポンス読み取り: bash .claude/skills/delegate-x-research/scripts/read-response.sh "$response_file" auto。auto が大きな response と判定した場合は status + index + Summary section を返すので、Findings / Sources / Limitations / Blockers など必要 section だけ ... "$response_file" <N> で追加取得する。読了後、worker の本文を再要約しない。main のユーザー向け応答は、必要な結論と参照すべき section を短く示す。
4. 検証フェーズ: 重要な主張について、Sources に投稿URL・アカウント・投稿日時・確認時刻が含まれるか確認する。根拠が弱い箇所や Grok 側のアクセス制限は Limitations / Blockers として扱い、断定しない。

待ち時間の隠蔽（対話親向け）

対話親では体感待ち時間を隠蔽できる。経路は起動スクリプトで異なる。delegate-x-research-grok.sh 経由は prepare.sh で response_file を事前取得済みなので、delegate-x-research-grok.sh を background で実行し、observe_file の state.phase / heartbeat を確認して ended または stalled になった後に read-response.sh する。run-x-research.sh 経由は response_file を事前に取得できないので、run-x-research.sh を background で実行した場合は read-json.sh .run.response_file "$observe_file" で応答パスを取るか、合流した出力 JSON をそのまま read-json.sh で読む。総所要時間（wall time）は変わらない体感改善であり、非対話モードの親では従来どおりフォアグラウンド実行必須。

Worker report

worker の report Markdown は次の見出しを基本にする。

• Summary: 結論の短い要約
• Findings: 主な発見。事実、推測、未確認情報を分ける
• Sources: x.com URL、投稿者、投稿日時、確認時刻、関連検索語
• Method: 検索語、確認した範囲、除外した情報
• Limitations: 非公開投稿、削除済み投稿、検索結果の偏り、取得不能、時点依存
• Blockers: Grok CLI 不在、ログイン不備、X へのアクセス不可、入力不足

制約

• DELEGATE_X_RESEARCH_MODEL → grok-build の順でモデル解決する
• Grok CLI が指定モデルを公開しておらず grok-build が利用可能な場合は、実行時に grok-build へフォールバックする
• GROK_DELEGATE_SANDBOX が設定された場合のみ Grok CLI に --sandbox を渡す
• 現在の実行バックエンドは Grok CLI。将来別バックエンドに差し替える場合も、skill 名と env 名は X 調査という用途に合わせる
• x.com / X の調査に集中する。Web 一般やコード調査へ広がる場合は、request の Scope に必要な範囲だけを書く
• 直近情報は確認日時を明記し、削除・編集・非公開化で変わり得ることを Limitations に残す
• task_type_chain 内種別への再委譲はしない（別種別 delegate は可）
• main は worker の探索ログを echo / 再要約しない。必要な結論と参照 section だけを返す