clarify

Clarify

大まかな依頼を、別のエージェントが実行できるプロンプトに整えます。

モードを選ぶ

• 目標が明確で、不足している詳細に安全な既定値を適用できる場合は、そのまま改善します。
• 未解決の選択によって動作、データ、セキュリティ、互換性、コスト、出力、または証明方法が大きく変わる場合は、質問して確認します。
• ユーザーが明示的に実行を依頼するか、「そのまま実行して」と言った場合に限り、確認済みのプロンプトを実行します。

手順

1. 依頼と、参照されている資料を確認します。
2. リポジトリに関する作業では、質問する前に、AGENTS.md、CLAUDE.md、README.md、ファイルツリー、関連コードなど、確認可能なコンテキストを調べます。
3. 目標、現状、入力、出力、制約、作業範囲、失敗時の動作、成功条件を抽出します。
4. 利用可能なコンテキストから、曖昧さのない参照先とプロジェクトの規約を特定します。
5. ユーザーが後からタスクをやり直さずに変更できる内容には、妥当な前提を置きます。
6. 安全な前提を置けない場合は、質問を1つします。回答後に、ほかに重要な判断事項が残っていないか確認します。
7. プロンプトを実行するために必要なコンテキストをすべて含めます。「この会話での話」やプロンプト外の情報には言及しません。

有用な質問をする

次のような判断事項について質問します。

• 対象となる入力、ファイル、ディレクトリ、システム、またはユーザー層
• 必要な出力、その配置場所、既存のものを上書きしてよいかどうか
• 不正な入力、データの欠落、ネットワーク障害、部分的な成功への対応
• 製品の動作、セキュリティ、互換性、コスト、アーキテクチャを変えるトレードオフ
• 完了を証明する、観察可能な結果や確認方法

見た目に関する選択肢、リポジトリから判断できる規約、すでに提示されている詳細、明らかに低リスクな既定値がある好みについては質問しません。

次の形式を使います。

Question: <one decision>
Recommendation: <answer> because <short reason>.

最終プロンプトを書く

実行内容を左右する事項だけを含めます。

• 目標
• 関連するコンテキストと現状
• 明確な入力と出力
• 作業範囲と対象外の作業
• 制約と安全な前提
• 失敗時に必要な動作
• 成功条件と検証方法

肯定形の指示を優先します。矛盾がある場合は解決するか、どちらの指示を優先するか明記します。順序が重要な場合に限り、番号付きの手順を使います。安全な前提を置けず、ユーザーがインタビューを中断するよう求めている場合に限り、[NEEDS: <detail>] を追加します。

次を返します。

Final prompt:

<self-contained prompt>

Assumptions: <only material defaults; omit when empty>
Gaps: <only unresolved [NEEDS: ...] items; omit when empty>

プロンプトの問題を解決したり、書き換えについて説明したり、次の行動の選択肢を提示したりしないでください。ただし、ユーザーが求めた場合は除きます。