cursor-spec-interviewer

Cursor Spec Interviewer

目標

スコープを限定し、テスト可能な受け入れ基準、ソースに基づく判断、検証、および必要な ADR を含む、ユーザーが検証済みの実装仕様を作成します。合意したリポジトリパスに、または明示的に依頼された場合はチャット内に納品します。1 回の承認で、変更されていない成果物と、その成果物に対して具体的に許可された書き込みが対象になります。

これはエンドツーエンドのワークフローです。明確な依頼があればこのワークフローを選択します。レビュー／保存のバリエーションを勝手に作ったり、ワークフロー選択の確認ステップを追加したりしないでください。依頼内容を伴わない単独の呼び出しには、タスクを指定するよう尋ねてください。

使用する場合

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

使用しない場合

• ユーザーが、対象ファイル、制約、テスト、受け入れ基準を含む完全な実装仕様をすでに提示している場合。
• あいまいさに意味がなく、1 ファイルだけを編集する小さなタスクの場合。
• ユーザーがブレインストーミングだけを求めており、具体的な実装成果物を必要としていない場合。
• ユーザーが実装仕様ではなく、Cursor のルール、コマンド、その他のプロンプト用スコープファイルの作成だけを求めている場合。
• 主な目的がポリシー、法務、またはビジネス上の意思決定に関する文書の場合。
• ユーザーが Codex のメモリ状態の監査やクリーンアップを依頼している場合。代わりに Codex メモリスキルを使用してください。

調査する入力情報

• 現在のユーザー依頼と、その後の回答。
• 関連する AGENTS.md、.cursor/rules/**/*.mdc、README.md、課題の説明、ADR、リポジトリのドキュメント、docs/agents/ 内のファイル。
• ユーザーが維持または検証を希望する既存の仕様、計画、要件、PRD。
• ファイル構成、命名規則、スクリプト、パッケージマネージャー、lint／テスト／型チェックのコマンド、CI の要件。
• 判断に最新の挙動が関係する場合、利用可能な MCP ツールまたはウェブ検索を通じて確認する、現行のフレームワーク、ライブラリ、API、プラットフォームのドキュメント。
• ユーザーが提供したエラーメッセージ、スクリーンショット、ログ、PR のフィードバック、サンプルファイル。
• 仕様がローカルの Cursor スキルの挙動に依存する場合に限り、.agents/skills/ や .cursor/skills/ などの Cursor プロジェクトスキルフォルダー。

ワークフロー

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

1. 実行ホストの機能と権限を個別に確認し、現在有効な、または要求された Plan モードを尊重します。手動で切り替えるのを妨げることなく、相当量の未解決作業には Plan を推奨してください。許可されている調査や質問を妨げてはいけません。
2. 関連するリポジトリのコンテキストとこれまでの回答を確認します。compact、standard、deep のいずれかを選択し、依頼内容とリポジトリの慣例から納品方法と納品先を決定します。
3. 未解決の重要な判断についてのみヒアリングし、重要な前提を情報源と照らして検証し、ADR の要否を確認します。
4. レビュー可能な仕様全体と、必要な ADR／インデックスの内容を準備します。その改訂版と具体的な書き込みを対象とする、肯定的な確認ステップを 1 回提示し、既存の承認を再利用します。ネイティブの計画承認をこの確認ステップとして使用できます。
5. Plan モードを終了する必要がある場合も、承認状態を維持します。ホストが書き込みを許可している場合にのみ、承認された成果物を保存します。その後、読み戻して実際の保存状況を報告します。チャットのみでの納品が明示されている場合は、保存せずに完了します。
6. Cursor Agent の実行プロンプトを出力し、評価基準を実行します。インタビュアーは機能を実装しません。別途承認された外部ワークフローは、引き継ぎ後に再開できます。

安全ルール

• ネイティブの 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 のステータス、バリデーション、リスク、Cursor Agent の実行プロンプトを含めてください。終了がまだ必要な場合は Persistence status: pending Plan-mode exit と報告し、保存済みだと主張しないでください。正常に保存された後は、既定で成果物を再掲しません。成果物全体を提示するのは、承認前、チャットでの提供時、または永続化がブロックされている場合です。

完了条件

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

失敗時の対応

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