codex-spec-interviewer

Codex 仕様インタビュアー

目標

範囲が明確で、テスト可能な受け入れ条件、根拠となるソースに基づく決定、検証、および必要な ADR を含む、ユーザー確認済みの実装仕様を作成します。合意したリポジトリパスに納品します。明示的に求められた場合は、チャットで納品します。承認は、変更されていない成果物と、具体的に許可された書き込みを対象とします。

これは、最初から最後まで一貫したワークフローです。明確な依頼があれば、このワークフローを選択します。レビューや保存のバリエーションを作り出したり、ワークフロー選択の確認ステップを追加したりしないでください。依頼内容のない呼び出しでは、タスクを指定するよう尋ねてください。

使用する場合

• ユーザーに大まかなアイデアはありますが、本番環境に対応できる実装仕様がありません。
• タスクが複数のファイルや関心事にまたがる、またはトレードオフの判断が必要です。
• 依頼に受け入れ条件、検証コマンド、ロールアウトに関する注記、またはリスク対応が必要です。
• 実装開始前に、再利用可能な文書化された成果物をユーザーが求めています。
• コーディング前に、要件、機能の形、ADR の前提、または実装方針を、リポジトリの実情や最新の外部情報と照らし合わせて検討する必要があります。

使用しない場合

• ユーザーが、対象ファイル、制約、テスト、受け入れ条件を含む完全な実装仕様をすでに提示しています。
• 意味のある曖昧さがない、小規模な単一ファイルの編集です。
• ユーザーがブレインストーミングのみを希望し、具体的な実装成果物を求めていません。
• ユーザーが実装仕様ではなく、AGENTS.md の内容または Codex のメモリー項目の作成のみを求めています。
• タスクの主題が、ポリシー、法律、またはビジネス上の意思決定に関する文書です。
• ユーザーが Codex のメモリー状態の監査または整理を求めています。その場合は、Codex メモリースキルを使用してください。

調査する入力

• 現在のユーザー依頼と、その後の回答。
• 関連する AGENTS.md、README.md、課題の説明、ADR、リポジトリのドキュメント、および docs/agents/ 内のファイル。
• ユーザーが保持または再検討を求めている既存の仕様、計画、要件、PRD。
• 提供された場合は、調整済みのプロダクト計画作業項目（プロダクト／リリース／スライス ID、正規の契約とリビジョン、過去の回答、対象外事項、エビデンスの制限、実際の許可を含む）。単独で使用する場合は、これを必須としないでください。
• ファイル構成、命名規則、スクリプト、パッケージマネージャー、lint／テスト／型チェックのコマンド、CI の要件。
• 最新の動作に依存する判断には、利用可能な MCP ツールまたはウェブ検索を通じて、現在のフレームワーク、ライブラリ、API、プラットフォームのドキュメントを確認します。
• ユーザーが提供したエラーメッセージ、スクリーンショット、ログ、PR のフィードバック、またはサンプルファイル。

ワークフロー

共通のインタビュー、承認、納品のライフサイクルについては、workflow-details.md に従ってください。ホストの制御または遷移が関係する場合に限り、host-adapters.md を使用してください。

1. 実行ホストの機能と権限を個別に確認し、現在有効な、または要求された Plan モードに従います。大規模で未確定の作業には Plan を推奨しますが、許可された調査や質問を、手動での切り替えを理由に妨げないでください。
2. 既存の調整済みハンドオフの場合は、上流のスキルを再開せずに、プロダクト計画のハンドオフ を読みます。関連するリポジトリの情報と過去の回答を確認します。compact、standard、deep のいずれかを選び、依頼とリポジトリの慣例に基づいて納品の意図と宛先を決定します。
3. 未解決の重要な判断についてのみインタビューを行い、重要な前提を情報源に照らして検討し、ADR の要否を判定します。
4. レビュー可能な仕様全体と、必要な ADR／インデックスの内容を準備します。そのリビジョンと具体的な書き込みについて、肯定的な確認ステップを 1 回提示し、既存の権限を再利用します。ネイティブの Plan 承認をこの確認ステップとして使用できます。
5. Plan を終了する必要がある場合も、承認を保持します。ホストが書き込みを許可する場合に限り、承認済みの成果物を保存し、読み戻して実際の永続化を報告します。明示的にチャットのみで納品する場合は、保存せずに完了します。
6. Codex 実行プロンプトを出力し、評価基準を実行します。インタビュアー自身は機能を実装しません。別途許可された外部ワークフローは、ハンドオフ後に再開できます。

安全ルール

• ネイティブの Plan が有効な間は、インタビューを読み取り専用に保ち、リポジトリの成果物を永続化しないでください。モードや書き込み権限の状態が不明でも、書き込みは許可されません。
• 以前の回答と、変更のない内容および書き込みに対する承認を再利用してください。無応答、タイムアウト、事前選択されたオプション、モードの切り替えは、内容への承認とはみなしません。
• 未解決の重要な変更、あいまいな保存先、ディレクトリの作成、上書き、または必要な ADR の書き込みのみ確認してください。以前に与えられた明確な承認は引き続き有効です。
• ADR の永続化の提案と、そのアーキテクチャ上の決定への承認を区別してください。必要な承認が得られるまで、依存する実装をブロックしてください。
• パス、コマンド、API、決定を捏造せず、不明な事実は不明として明示してください。成果物に秘密情報や個人を特定できる情報を含めないでください。
• ターゲットランタイムの指示、ルール、メモリーファイルは証拠であり、仕様の保存先ではありません。ユーザーがトレードオフを理解したうえで別の形式を明示的に求めない限り、リポジトリが管理する成果物を使用してください。
• ユーザーのスコープを維持してください。リスクのある移行とロールバックについて説明し、承認済みの ADR を暗黙に上書きしないでください。

参照資料

現在のステップに必要な参照資料のみを読みます。

• workflow-details.md：インタビュー、単一のチェックポイント、保存のみの引き継ぎ、完了。

• host-adapters.md：実行ホストの制御と機能の証拠。

• question-bank.md、spec-rubric.md、source-challenge.md：未解決の質問、詳細度、最終セルフチェック、ソースの検証。

• artifact-destinations.md、adr-gate.md、rollout-checklist.md：保存先、永続的な決定、リスクのあるデリバリー。

• 出力形式については、該当する assets/spec-template.*.md、同梱の仕様書サンプル、実行プロンプトを参照します。

• プロダクト計画の引き継ぎと作業項目テンプレート：任意の、契約を考慮した入力と対象を絞ったフィードバックに使用します。新たなワークフローではありません。

スクリプト

同梱スクリプトはありません。

出力形式

保存済みのパス、チャットのみでの提供を明示する旨、または永続化が保留中／ブロック中であることを先頭に記載してください。検証結果、重要な前提、ソースの検証、ADR の状態、検証方法、リスク、Codex 実行プロンプトを含めてください。Plan モードの終了が必要な場合は Persistence status: pending Plan-mode exit と報告し、保存したと主張しないでください。完全な成果物は、承認前、およびチャットでの提供時または永続化がブロックされた場合に提示します。保存に成功した後は、原則として再掲しません。

完了条件

具体的な仕様に、スコープ、受け入れ基準、検証方法、完了条件が記載されています。ユーザーは現時点の内容と必要な書き込みを一度承認済みです。要求された成果物は保存して読み戻し確認済みか、チャットのみでの明示的な提供が完了しています。必要な ADR はリポジトリの規約に従っており、承認ゲートがある場合は明示されています。検証と永続化は別々に記録されています。保存のみの最終処理では、機能を実装しません。

失敗時の対応

• リポジトリまたは外部の証拠が不足している場合：不明点を明示し、制約を説明して、独立した作業を続行します。
• 要件または承認済み ADR に重大な矛盾がある場合：矛盾を提示し、実装前に影響を受ける決定を解決します。
• 重要な回答が保留中の場合：依存する作業は保留のままにし、承認済みで独立した作業のみ進めます。
• 計画または質問の制御機能が利用できない場合：ホスト機能を捏造せず、同じ会話形式のインタビューを使用します。
• Plan、権限、承認の不足、または保存先の状態変更により要求された保存がブロックされた場合：有効な承認を保持し、残っている作業を正確に報告して、保存可能なドラフトを提示します。永続化が保留中の状態を完了と呼ばないでください。