搭子.skill / Partner

搭子.skill (Partner)

私の Claude Code と Codex は世界一の相棒です。

概要

このスキルを使用して、2 エージェントコーディングワークフローを実行します。Claude Code は高価値な計画、洗練、レビューエージェントとして機能し、Codex は外部オーケストレーター兼主実装者として機能します。Claude Code の使用は API 経由で課金される可能性があるため、集中的に使用してください。

中小規模のタスクでは、1 つの長寿命 Claude Code セッションを優先します。Claude に計画を依頼し、Codex に実装させ、差分サマリーと重要なファイルを同じ Claude セッションに戻して UI/インタラクションの洗練と最終的な /codex:review を実行します。これにより、同じプロジェクトコンテキストを再構築するための Claude への支払いを回避し、Claude が作業を改善するのに十分な継続性を確保します。

Partner は委任の言い訳ではありません。ユーザーは依然として責任者であり、Codex はリポジトリの証拠に対して責任を負い、Claude Code はその出力を検証する必要がある高価値の共同作業者として扱われます。

デフォルトフロー

1. ターゲットリポジトリに接地する。

   • agent-workbench ルートではなく、具体的なプロジェクトディレクトリに入る。
   • Claude Code を開始する前に git status --short を実行する。
   • タスクがグリーンフィールド、機能重視、UI 重視、レビューのみ、またはデバッグのいずれであるかを特定する。

2. 高コストな思考ループのために 1 つの Claude Code セッションを開始する。

   • 計画のために：PTY で Claude Code を開始し、目標を設定する。
   • デフォルトでは claude --permission-mode plan --name <task-name> を使用する。
   • インタラクティブセッションで、/goal <明確な完了条件> を送信する。
   • Claude Code に具体的な実装計画、合格基準、UI/インタラクションガイダンスを依頼する。
   • タスクが大きすぎない限り、この同じセッションを後の洗練とレビューパスのために開いたままにしておく。
   • Codex が実装を完了したからといって、別の claude -p レビュー専用セッションを開始しない。それはコールドスタートコンテキストにトークンを費やし、Claude の継続性を弱める。

3. 主に Codex で実装する。

   • Claude Code の計画を短いチェックリストに変換する。
   • 既存のリポジトリパターンを使用して、Codex で直接コード変更を行う。
   • リスクの高い編集後は、最速の関連チェックを実行する。
   • ユーザーが要求しない限り、Claude Code を機械的な一括編集、繰り返しの lint 修正、長いコマンドループに参加させない。

4. 実装済みの状態を同じ Claude Code セッションに戻して洗練する。

   • 特にフロントエンド UI、インタラクション品質、プロダクトフィーリング、アクセシビリティ、エッジ状態に使用する。
   • 限定されたペイロードを送信する。可能であれば references/handoff-template.md を使用する：元の計画、変更ファイルのリスト、git diff --stat、テスト/チェック出力、リスク、未解決の質問、そして Claude が必要とする主要なファイルスニペットまたは完全なファイルのみ。
   • 広範な書き換えではなく、優先順位付けされた調査結果を求める。
   • Codex は受け入れられた修正を適用し、チェックを再実行する。

5. 同じ Claude Code セッションから最終レビューを実行する。

   • Claude Code で、利用可能な場合は /codex:review を使用する。
   • 調査結果をまずバグ/リスク/テストの問題として扱い、スタイルの提案は二の次とする。
   • Codex はブロックする調査結果を修正し、チェックを再実行し、最終ステータスを報告する。
   • Partner Session Receipt で終了し、ユーザーが Claude Code コンテキストが再利用されたかどうかを確認できるようにする。

セッション戦略

• スモールまたはミディアムタスク：1 つの Claude Code セッションを plan -> polish -> /codex:review のために開いたままにする。
• 新しい Claude Code セッションはコストがかかるものとして扱う。再利用可能なセッションがない、以前のセッションが回復不能である、またはユーザーが明示的に新しい Claude パスを要求した場合にのみ、新しいセッションを開く。
• 同じ Claude セッションがプロンプト、権限待機、またはアイドル状態でスタックした場合は、まず制限されたメッセージで同じセッションを継続または再開してみる。その価値がコンテキストコストを明らかに上回る場合を除き、コールドスタートの代替レビューを開始しない。
• 大規模タスクまたは巨大な差分：Codex が計画、変更ファイル、主要な決定、既知のリスク、チェック結果を含むコンパクトなハンドオフを生成した後にのみセッションを分割する。
• 同じ Claude セッションが遅くなったり、混乱したり、コンテキストが重くなったりした場合は、トークンのトレードオフを報告した後、制限されたハンドオフで閉じて再起動する。
• ユーザーが明示的に迅速な最小ループを要求しない限り、UI/フロントエンド作業の Claude 洗練フェーズをスキップしない。
• /codex:review がハング、タイムアウト、または権限プロンプトでスタックした場合は、それを監視調査結果として記録し、スタックしたサブプロセス/セッションを停止し、Codex 側の検証を続行する。
• Claude Code が実用的な洗練を生成しない場合は、盲目的にプロンプトを続けない。空/低シグナルの結果をキャプチャし、Codex 検証を実行し、制限を報告する。
• claude -p はデフォルトの Partner パスではない。以前のセッションコンテキストを失っても問題ない安価な単発の質問にのみ使用する。

権限ポリシー

• 計画にはデフォルトで --permission-mode plan を、実装レビューには通常の権限を使用する。
• ユーザーが明示的に skip、最高権限、全部允许、bypass を要求した場合、または作業が意図的に分離されたワークツリー内にある場合にのみ、スキップ/バイパスを使用する。
• スキップモードの場合、claude --permission-mode bypassPermissions --name <task-name> または claude --dangerously-skip-permissions --name <task-name> で Claude Code を開始する。
• スキップセッションの前に、リポジトリパス、現在の git ステータス、意図されたスコープ、および停止条件を述べる。
• ユーザーが別途明示的な指示を与えない限り、スキップモードでコミット、プッシュ、デプロイ、メッセージ送信、公開、またはシークレットに触れることを決して許可しない。
• skip をリポジトリ証拠を無視する許可として決して扱わない。skip は Claude Code の権限を変更するものであり、Partner の検証義務を変更するものではない。
• リポジトリの可視性の変更、リリースタグ、レジストリ公開、および外部発表は、別途明示的な公開指示の後に行う。

ルーティングルール

• Claude Code にルーティング：アーキテクチャ計画、実装戦略、UI/インタラクション批評、最終 Codex レビュー、困難なプロダクトトレードオフ。
• Codex にルーティング：スキャフォールディング、実装、長文コンテキストコード編集、テスト、ビルド修正、リポジトリ調査、監視、サマリー。
• UI 品質が重要な場合、または最初の実装が技術的には合格だが製品としての洗練が必要な場合は、同じ Claude Code セッションにルーティングバックする。
• Kimi Work/Kimi Code Goal は Claude Code /goal とは別に扱う。以前の「Goal モード」コンテキストは Kimi を指している可能性があり、Claude ではない。

検証ゲート

このワークフローを改善する場合、または重要なタスクに適用する場合は、references/darwin-ratchet.md のダーウィンスタイルのラチェットを使用する：

• 一度に 1 つのワークフロー次元（計画、実装、UI 洗練、レビュー、監視、権限、または報告）のみを変更する。
• 改善を「より良い」と呼ぶ前に、テストプロンプトまたは実際のミニループを実行する。
• リスクの高い変更に対して、同じエージェントが唯一の作成者かつ唯一の判断者となることを許可しない。
• リポジトリ証拠が改善された場合のみ変更を維持する。後退した場合は、git reset --hard ではなく、レビュー可能なリバートを使用する。
• 別のプロンプトループが低シグナルまたは 1 ポイント未満の期待される改善を生成した場合に停止する。

監視

アクティブな Claude Code セッションについては、references/monitoring.md を参照する。チャットテキストのみを信頼するのではなく、5 つのシグナルを優先する：

1. 実行中の Claude Code セッションからの PTY 出力。
2. claude agents --json --cwd <repo> セッションステータス。
3. メッセージ本文全体をデフォルトでダンプせずに、Claude JSONL トランスクリプト構造。
4. ~/.claude/tasks/<sessionId>/ の下のオプションのタスクファイル。
5. リポジトリ証拠：git status --short、git diff --stat、および関連するテスト/ビルドチェック。

出力契約

ユーザーに報告する際には、以下を含める：

• 現在のフェーズ：計画、Codex 実装、Claude 洗練、レビュー、または最終修正。
• Claude Code セッション ID（存在する場合）。
• 変更されたファイルと実行されたチェック。
• 修正済みまたは未解決のレビュー調査結果。
• 作業をコミットする準備ができているかどうか。デフォルトではコミットしない。
• アイドルセッション、権限待機、空のレビュー出力、差分なし、チェック失敗などの監視異常。
• 重要な Claude Code ワークフローに対する Partner Session Receipt：

[Partner session receipt]
phase: <planning | codex implementation | claude polish | review | final fix>
claude_session: <sessionId or none>
claude_session_reused: <yes | no | n/a>
new_claude_p_sessions: <0 | count | unknown>
codex_passes: <number of implementation/fix passes>
checks: <commands run or not run>
anomalies: <none | permission wait | idle | empty review | failed check | other>

トークンの節約を捏造しないこと。正確なトークンテレメトリが利用できない場合は、代わりに検証可能な動作を報告する：同じ Claude Code セッションが再利用された、新しい claude -p セッションがない、制限されたハンドオフが使用された、チェックに合格した。