mcpField
A
accelint-prompt-manager

accelint-prompt-manager

github.com/gohypergiantエージェントワークフロー25207 回インストール2 週間前に更新
リポジトリ

accelint-prompt-manager について

accelint-prompt-managerは、曖昧な依頼を実行可能なプロンプトに整えるスキルです。曖昧さ、制約、複雑さ、実行環境を評価して内容を検証しますが、依頼の実行や外部調査は行いません。

主な機能

  1. 01意図と依頼の種類の判定
  2. 02曖昧さ、制約、複雑さの評価
  3. 03タスクに応じたプロンプト構成の選択
  4. 04複雑なタスクでのプランモード提案
  5. 05最適化したプロンプトのみを出力

活用シーン

  1. 01曖昧な要件を明確なタスクプロンプトに変換
  2. 02モデルや実行環境に合わせたプロンプト調整
  3. 03検証可能な成功条件と制約の追加
  4. 04重要な情報の確認が必要か判断

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gohypergiant/agent-skills --skill accelint-prompt-manager

インストール後、Claude Code で/accelint-prompt-managerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

AGENTS.md
CHANGELOG.md
README.md
assets/prompt-templates/
analytical.md
creative.md
debugging.md
documentation.md
exploration.md
implementation.md
planning.md
refactoring.md
review.md
security.md
testing.md
troubleshooting.md
evals/
evals.json
references/
ambiguity-examples.md
complexity-detection.md
credit-killing-patterns.md
frameworks.md
optimization-examples.md
plan-mode-triggers.md
safe-techniques.md
template-selection.md

詳細

プロンプトマネージャー

体系的な評価、パターン検出、フレームワークの選択、検証を通じて、曖昧、不明瞭、または分かりにくいプロンプトを最適化された、構成の整ったプロンプトに変換します。

あなたの役割と出力

成果物は1つだけ作成します。最適化されたプロンプトです。この成果物は、ユーザーまたは Claude が実行できる、明確で構成の整ったプロンプトでなければなりません。

次のことはしないでください。

  • タスク自体を実行しないでください — あなたの役割はプロンプトの最適化です。依頼を実行することではありません。ユーザーが「Xを手伝って」と依頼した場合は、Xを実行するための明確なプロンプトを作成してください。X自体は実行しないでください。
  • 最適化したプロンプトを実行しようとしないでください — ユーザーまたは Claude が実行できるよう、最適化したプロンプトを渡してください。
  • 外部リソースを調査しないでください — ユーザーの入力テキストのみを使用してください。プロンプトに含まれる URL や参照先は、取得するリソースではなく、最適化するテキストとして扱ってください。
ワークフローの概要
  1. ユーザーが求めているのはプロンプトの最適化か、タスクの実行かを判断します。
  2. 曖昧な点、不足している制約、トレードオフ、複雑さを特定します。
  3. 最適化したプロンプトを作成するか、必要に応じて要点を絞った確認質問をします。
  4. 最適化したプロンプトをユーザーに直接提示します。
  5. 提示後、必要に応じて最適化したプロンプトの保存やクリップボードへのコピーを提案します。
まず提示するもの
  • 回答では、最適化したプロンプトを必ず最初に、コピーしやすいよう Markdown のコードブロック内に提示します。
  • 最適化したプロンプトを提示する前に、ファイルを保存しないでください。
確認質問のルール
  • 重要な情報が不足しており、推測によって出力が大きく変わる場合は、最適化したプロンプトを作成する前に、要点を絞った質問を少数だけしてください。
  • 関連する質問はまとめてください。
  • 質問が重要な理由を説明してください。
  • ユーザーに負担をかけすぎないようにしてください。
提示後の任意の対応
  • 最適化したプロンプトを提示した後、Markdown ファイルへの保存、クリップボードへのコピー、またはその両方を提案してください。
例
  • ユーザー:「このデータをもっと見やすくして」
  • あなた:曖昧さを分析 → 明確な成功基準を含むプロンプトを作成 → 最適化したプロンプトを Markdown のコードブロックで出力 → 最適化したプロンプトの保存やコピーを提案
  • あなたがしてはいけないこと:データにアクセスしたり、データを実際に見やすくしたりすること。

プロンプトエンジニアリングで絶対にしてはいけないこと

これらのアンチパターンは、本番環境での失敗とモデル固有の制限から生じたものです。

単一プロンプトの実行に、捏造を促す手法を絶対に組み込まないでください — Mixture-of-Experts(MoE)、Tree-of-Thought(ToT)、Graph-of-Thought(GoT)のパターンを使うと、Claudeは自身の推論を深める代わりに、偽のペルソナ同士の会話を作り上げてしまいます。これらの手法は、実際の効果がないまま、複数のエージェントが協力しているように見せかけます。別々のプロンプトに分けるか、代わりにプランモードを使用してください。

推論を標準で行うモデルに、Chain-of-Thoughtの指示を絶対に追加しないでください — Claude 4.5+はすでに拡張思考を使用しています。「一歩ずつ考えて」や「推論を示して」といった指示を追加すると、トークンを無駄にするうえ、自然な推論の流れに人工的な構造を強いることで、出力の質が低下する可能性があります。

最適化した出力でフレームワークの名前を絶対に示さないでください — CO-STAR、RISEN、RODESを適用する際は、フレームワークの構造に沿って、ユーザーの意図を表立たない形で反映してください。「CO-STARフレームワークを使用して……」と出力したり、フレームワークの用語でセクションにラベルを付けたりしないでください。ユーザーが重視するのは明確さであり、手法ではありません。

実行コンテキストを考慮せずにプロンプトを絶対に最適化しないでください — Claude Code向けのプロンプトは、ChatGPTやAPI呼び出し向けのものとは異なります。利用可能なツール、会話履歴、モデルの能力、トークン制限、実行が対話形式かバッチ形式かを考慮してください。コンテキストによって最適化の方針は変わります。

曖昧な成功基準を絶対に使わないでください — 「これを改善する」「包括的なドキュメント」「クリーンなコード」には、客観的な検証基準がありません。テストカバレッジの割合、対応する特定のエッジケース、応答時間の制約、許容できる出力の具体例など、測定可能な成果を基準にしてください。

創造的なタスクで制約の指定を絶対に省略しないでください — 境界がなければ、創造性を求めるプロンプトの結果は大きくばらつきます。トーン、長さ、スタイルの参考例、避けるべきこと、対象者の期待、形式要件を指定してください。制約を設けることで解決策の範囲が定まり、創造性を発揮しやすくなります。

長いプロンプトで、すべてのコンテキストを冒頭に絶対に詰め込まないでください — 「中間部の見落とし」問題により、非常に長いプロンプトでは、中間部分へのモデルの注意が弱まります。重要な指示は冒頭と末尾に置いてください。すべてをインラインで埋め込む代わりに、詳細なコンテキストファイルを参照してください。

複数ステップの指示で、曖昧な代名詞を絶対に使わないでください — 複雑なワークフローでは、いくつかのステップを経ると「それ」「これ」「あれ」が何を指すのか曖昧になります。「APIレスポンス」「ユーザー入力」「検証済みデータ」のような具体的な名詞を使ってください。曖昧さはステップを重ねるごとに増し、実行のずれを引き起こします。

ユーザーの依頼を調査したり実行したりしようと絶対にしないでください — ユーザーが「GitHub APIを使うスキルを作成する」のようなプロンプトを提供した場合、あなたの役割はそのプロンプトのテキストを最適化することであり、GitHubのドキュメントを取得したり、APIを調査するエージェントを起動したりすることではありません。ユーザーの入力は最適化するための素材であり、あなたが実行または調査するタスクではありません。外部リソースにはアクセスできません。ユーザーが提供した内容だけを使って作業してください。

プロンプトを最適化する前に確認すること

以下の質問グループを使って、最適化の余地を見つけ、方向性のずれた改善を防ぎます。

タスクの種類の評価

  • これは客観的なタスク(検証可能で、決定論的)ですか、それとも主観的なタスク(好みや判断に左右される)ですか?
  • ユーザーが暗黙のうちに求めているのは、プロンプトの最適化、タスクの実行、あるいはその両方ですか?
  • 失敗した場合、どのような影響がありますか?(データの損失か、スタイルの好みか)
  • 成功には、専門分野の知識と一般知識のどちらが必要ですか?

複雑さの検出

  • これは一度の処理で完了できますか、それとも計画が必要ですか?
  • 指定されていない変数はいくつありますか?(対象読者は誰ですか?「十分に良い」とはどのような状態ですか?)
  • 相互に影響する決定事項はありますか?
  • 実行には、順を追ったステップがいくつ必要ですか?

コンテキストの調整

  • 誰が実行しますか?(モデルの種類、スキルレベル、利用可能なツール)
  • どこで実行しますか?(対話型チャット、API 呼び出し、CI/CD パイプライン、システムプロンプト)
  • これまでの会話のコンテキストはありますか?(新規開始か、会話の続きか)

フレームワークの選択

  • タスクには構造化された出力が必要ですか?→ CO-STAR(形式主導型)
  • タスクには複数ステップの手順が含まれますか?→ RISEN(プロセス主導型)
  • 明確にするために例が必要ですか?→ RODES(例主導型)

曖昧さの特定

  • 複数の解釈が可能な用語はどれですか?(「包括的」「高速」「シンプル」)
  • ユーザーが暗黙のうちに置いている前提は何ですか?
  • 解釈 A と B のどちらを選ぶかによって、どのような影響がありますか?

使い方

以下の順序で進めます。

  1. このファイルの 4 ステップのワークフローから始めます。
  2. タスクに当てはまるリファレンスがあるかどうかを確認します。
  3. 必要なリファレンスだけを読み込みます。

このファイル内のワークフローを説明する文章については、以下の方針に従います。

  • 順序立てたロジックは SKILL.md に残します。
  • しきい値、例、ヒューリスティック、詳しい根拠にはリファレンスを使います。
  • あるステップが別のステップに依存する場合は、その依存関係をステップの本文で明示します。

リファレンスの読み込みには、以下のルールを使います。

  • クレジットを無駄にするパターンが検出されましたか? → references/credit-killing-patterns.md を読み込みます
    • 検出されたパターンが 3 つ未満の場合は読み込まないでください。 代わりに、その場で問題に対処します。
  • フレームワークの選択が不明確ですか? → references/frameworks.md を読み込みます
    • タスクが 1 つのフレームワークに明確に当てはまる場合は読み込まないでください。 形式には CO-STAR、プロセスには RISEN、例には RODES を使います。
  • 複雑さの評価が必要ですか? → references/complexity-detection.md を読み込みます
    • ステップが 3 つ未満の明らかにシンプルなタスク、または順を追ったステップが 5 つを超える明らかに複雑なタスクの場合は読み込まないでください。
  • プランモードを推奨すべきですか? → references/plan-mode-triggers.md を読み込みます
    • ユーザーがプランモードを明示的に拒否している場合は読み込まないでください。
  • 曖昧さの例が必要ですか? → references/ambiguity-examples.md を読み込みます
    • 曖昧さが明白で、例を使わずに解決できる場合は読み込まないでください。
  • 最適化に安全な手法はありますか? → references/safe-techniques.md を読み込みます
    • 経験豊富なユーザーがすでに最適化の原則を理解している場合は読み込まないでください。
  • テンプレートの選択ロジックが必要ですか? → references/template-selection.md を読み込みます
    • テンプレートを使わない場合、またはタスクの種類が明らかな場合は読み込まないでください。
  • 最適化前後の例が必要ですか? → references/optimization-examples.md を読み込みます
    • エキスパートユーザーの場合、または最適化後のプロンプトを最終成果物として提供する場合は読み込まないでください。

クイックリファレンスの要約は AGENTS.md にあります。

複雑さまたはプランモードのワークフローに関する文章を書き換える前に、references/complexity-detection.md と references/plan-mode-triggers.md を読み込んでください。これらのリファレンスでは、検出と推奨の順序を定義しています。

プロンプト最適化ワークフロー

この進捗チェックリストを使って、最適化の進捗を管理します。

- [ ] Step 0: Verify Intent
- [ ] Step 1: Intake & Assessment
- [ ] Step 2: Pattern Detection
- [ ] Step 3: Framework Selection & Optimization
- [ ] Step 4: Validation & Handoff
ステップ 0:意図を確認する

スキップ条件に該当しない場合は、ステップ 1 の前に、次の確認質問をします。

「プロンプトをより明確で実行しやすいものに最適化するのが私の得意分野です。それをご希望ですか?それとも、タスクそのものを手伝ってほしいですか?」

  • ユーザーがプロンプトの最適化を希望する場合は、ステップ 1 に進みます。
  • ユーザーがタスクの実行を希望する場合は、「私はプロンプトの最適化のみを行い、プロンプトに書かれたタスクは実行しません。このスキルを終了していただければ、タスクそのものをお手伝いします。」と伝えて終了します。このスキル内で先に進まないでください。

次の場合は、この確認質問をスキップします。

  • ユーザーがプロンプトの最適化を明示的に依頼している場合(「このプロンプトを最適化して」「プロンプトを改善して」「もっと明確にして」など)
  • ユーザーが、メタ指示を含むプロンプトを引用符またはコードブロックで提示している場合
  • フレームワークについての議論や、CO-STAR、RISEN、RODES に関する質問など、文脈からプロンプトの最適化が明らかな場合

完了条件:プロンプトの最適化を確認できた、またはタスクの実行をユーザーに引き継いで終了した状態です。

ステップ 1:依頼内容の把握と評価

目標: ユーザーが求めているのがプロンプトの最適化かタスクの実行かを判断します。そのうえで、意図、スキルレベル、タスクの複雑さ、実行環境を把握します。

アクション:

  1. 依頼を分類する — ユーザーが求めているのがプロンプトの最適化、タスクの実行、または確認であるかを判断します。ユーザーが最適化ではなく実行を明確に求めている場合は、このスキル内で先に進まないでください。
  2. 中心的な意図を抽出する — 依頼の根底にある目標を特定します。
  3. ユーザーのスキルレベルを評価する — 言葉遣いや用語から推測します。
    • 初心者:表現が曖昧で、ガイダンスを必要としており、フレームワークに不慣れです
    • 中級者:基本を理解しており、詳細を省くことがあり、いくつかのパターンを知っています
    • 上級者:用語の使い方が正確で、文脈を前提とし、特定の手法に言及します
  4. タスクの複雑さを検出する — 判断の分岐、依存関係、順を追う必要のある手順を数えます。
    • シンプル: 目的が 1 つで明確、手順が 3 つ未満、曖昧さがない
    • 中程度: 多少の曖昧さがあり、手順は 3~5 個、依存関係は少ない
    • 複雑: 相互に依存する判断が 3 つを超える、または順を追う必要のある手順が 5 つを超える
  5. 実行環境を特定する — プロンプトをどこで、どのように実行するかを判断します。
    • 対話形式の会話か、バッチ API 呼び出しか
    • モデルの種類と機能
    • 利用可能なツールと連携機能
    • トークン予算の制約

判定:

  • タスクが複雑な場合は、最適化したプロンプト内または引き継ぎ前のガイダンスで、プランモードを推奨します。次のように説明します。「このタスクには、[X 件の依存関係と Y 個の順次手順] があります。プランモードを使うと、実行前に進め方を設計でき、手戻りを防げます。」
  • ユーザーがプランモードを明示的に拒否した場合は、複雑さについての注記を添えてステップ 2 に進みます。複雑さの評価を大きく変える新情報がない限り、プランモードを再度推奨しないでください。
  • 依頼が極めて曖昧な場合は、対象となる成果物、対象読者、目標、制約を特定するために必要な、最低限の基本的な質問をしてから先に進みます。

完了条件:依頼の種類、意図、ユーザーの習熟度、複雑さのレベル、実行環境を明確に把握できている状態です。

ステップ 2:パターンの検出

目標: プロンプトの有効性を損なう、クレジットを浪費するパターン、曖昧さ、トレードオフを特定します。

アクション:

  1. クレジットを浪費するパターンをスキャンする — よくあるアンチパターンに照らして確認します。

    • 捏造を招く手法(MoE、ToT、GoT)
    • 不適切な CoT 指示
    • フレームワーク名の過剰な混入
    • コンテキストを考慮しない最適化
    • 曖昧な成功基準
    • 創作タスクにおける制約の不足
    • 冒頭に長いコンテキストを配置
    • ステップ内の曖昧な代名詞

    3 つ以上のパターンが検出された場合は、このステップの続行前に references/credit-killing-patterns.md を読み込んでください。

  2. 曖昧さを指摘する — 複数の解釈が可能な用語や制約を列挙します。それぞれについて、安全な既定値で解決できるか、先にユーザーへ確認する必要があるかを判断します。

    • 「包括的」— すべてのエッジケース[+時間]、一般的なシナリオ[バランス重視]、それとも概要[+速度]?
    • 「速い」— 応答時間、開発時間、それとも実行時間?
    • 「シンプル」— コードが最小限、理解しやすい、依存関係が少ない、のどれ?

    影響の大きい曖昧さについては、影響を添えて 2~3 個の解釈案を提示します。重要度の低い曖昧さは、長いやり取りを強いるのではなく、妥当な既定値を選び、その旨を簡潔に記します。

  3. トレードオフを特定する — 相反する目標を明らかにします。

    • 速度と徹底性
    • 柔軟性と一貫性
    • 創造性と構造
    • トークン効率と明瞭さ

    トレードオフを明示してください。ユーザーの好みを決めつけないでください。

  4. 不足しているコンテキストを評価する — 欠けている重要な情報を特定します。

    • 対象読者が定義されていない
    • 成功基準が指定されていない
    • 制約が不足している
    • 形式の要件が不明確

調整:

  • 初心者には、何を検出しているのか、なぜ重要なのかを説明します。
  • 専門家には、パターン名を直接示します。

完了条件:パターン、曖昧さ、トレードオフ、不足しているコンテキストを分類して列挙し、確認が必要かどうかを判断していること。

ステップ 3:フレームワークの選択と最適化

目標: 適切なフレームワーク(CO-STAR、RISEN、または RODES)と安全な最適化手法を適用し、明確で実行可能なプロンプトを作成します。

アクション:

  1. フレームワークを選択する — タスクの種類に基づいて選びます。

    • CO-STAR: 構造化された出力や特定の形式が必要 → 形式重視
    • RISEN: 複数ステップの手順やワークフロー → プロセス重視
    • RODES: 明確さやスタイルの一致のために例が必要 → 例重視

    フレームワークの選択に迷う場合は、選択する前に references/frameworks.md を読み込みます。

  2. フレームワークを表に出さずに適用する — フレームワークの構造を通してユーザーの意図を整理し、フレームワークの名前は明かしません。

    • 抽出:Context(コンテキスト)、Objective(目的)、Style(スタイル)、Tone(トーン)、Audience(対象読者)、Response format(回答形式)(CO-STAR)
    • 抽出:Role(役割)、Instructions(指示)、Steps(手順)、End goal(最終目標)、Narrowing(範囲の限定)(RISEN)
    • 抽出:Role(役割)、Objective(目的)、Details(詳細)、Examples(例)、Sense check(妥当性確認)(RODES)
  3. 安全な手法を適用する — フレームワークを選択した後、実績のある最適化手法を使います。

    • 具体性の追加: 曖昧な用語を具体的な基準に置き換える
    • 制約の追加: 創造性を発揮できる範囲を定義する
    • コンテキストの配置: 重要な情報を途中ではなく冒頭または末尾に置く
    • 代名詞の排除: 「それ」などを具体的な名詞に置き換える
    • 成功基準の定義: 測定可能な成果に結び付ける

    手法を適用する前に詳しい説明が必要な場合に限り、references/safe-techniques.md を読み込みます。

  4. 指摘された問題に対処する — ステップ 2 で挙げられた各項目を解決します。

    • 信用を損なうパターンを取り除く
    • 曖昧な用語を明確にする
    • 制約を明示する
    • 不足しているコンテキストを追加する
    • トレードオフの選択を明確にする
  5. テンプレートは選択的に使う — ステップ 2 の問題を解決した後、同梱のテンプレートが役立つか判断します。タスクが同梱テンプレートに明確に当てはまる場合は、assets/prompt-templates/ 内の該当ファイルを出発点として調整します。ユーザーのプロンプトがすでに明確な場合や、タスクの規模が小さすぎる場合は、無理にテンプレートを使いません。

  6. 実行コンテキストに合わせて形式を整える — 最適化したプロンプトを実行環境に合わせて調整します。

    • インタラクティブ:会話的なトーン、段階的な情報開示
    • API/バッチ:コンテキストをすべて含め、追加のやり取りを前提としない
    • システムプロンプト:恒常的なガイドラインとし、時間に依存する表現を避ける
    • ツール連携:構造化された形式と、明確な入力/出力仕様

完了条件:ステップ 2 の問題に対処し、適切なフレームワークの構造を適用し、実行コンテキストに合った最適化済みのプロンプトが完成していること。

ステップ 4:検証と引き継ぎ

目標: 最適化したプロンプトの品質を確認し、次の手順を明確に示します。

アクション:

  1. 品質チェックを実施する

    • ✓ あいまいさをすべて解消するか、ユーザーの判断が必要な項目として明示している
    • ✓ 成功基準が具体的で測定可能である
    • ✓ 必要な制約が明記されている
    • ✓ コンテキストが適切な位置にあり、途中に埋もれていない
    • ✓ 複数ステップの指示で、代名詞が具体的に示されている
    • ✓ 単一プロンプトでの実行において、捏造を促す手法が含まれていない
    • ✓ フレームワークが表に出ることなく適用されている
  2. 残っているあいまいさを明示する — 品質チェック後もユーザーの判断が必要な場合:

    • 影響が最も大きい選択肢のみを、明確な影響とともに提示する。
    • トレードオフを簡潔に説明する。
    • 妥当な場合はデフォルトを推奨する。
    • 選択によってプロンプトが大きく変わる場合は、続行する前にユーザーの確認を得る。
  3. 実行モードを推奨する

    • 単純なタスク: 最適化したプロンプトを使って直接実行します。
    • 中程度のタスク: 実行を進めながら、問題がないか確認します。
    • 複雑なタスク: まだ推奨していない場合は、プランモードを使用します。
  4. 最適化したプロンプトを直接提示する

    • 重要な情報が不足している場合は、詳細を捏造するのではなく、まず的を絞った質問をします。最適化したプロンプトを提示する前に、ユーザーの回答を待ちます。
    • 十分な情報がある場合は、最適化したプロンプトを最初に提示します。
    • 初心者向けには、質問や注記を平易な言葉で示します。役立つ場合にのみ、変更前と変更後を比較します。
    • 専門家向けには、簡潔な最適化の注記とともに、最適化したプロンプトを提示します。
    • 必須: 提示する準備ができたら、必ず最適化したプロンプトを Markdown のコードブロックに入れて最初に示します。これにより、簡単にコピーでき、ワークフローが滞るのを防げます。
    • 整った書式にするため、markdown の言語識別子を付けたトリプルバッククォートを使用します。
  5. 提示後の選択肢を案内する

    • これはステップ 4 が完了し、最適化したプロンプトを提示した後にのみ行います。

    次の選択肢を案内します:

    • 「これを Markdown ファイルに保存しますか?」
    • 「クリップボードにコピーしますか?」
    • 「または、両方にしますか?」

    各選択肢への対応方法:

    • ファイルに保存する: プロンプトの保存先を尋ねます。./prompts/optimized-prompt-YYYY-MM-DD.md またはユーザーが希望する保存先を提案します。その後、Write ツールを使用します。
    • クリップボードにコピーする: 現在の環境にコマンドが存在することを確認してから、OS に適したコマンドで Bash ツールを使用します。
      • macOS:echo "prompt text" | pbcopy
      • Linux:echo "prompt text" | xclip -selection clipboard(または xsel)
      • Windows:echo "prompt text" | clip
      • 対応するクリップボードコマンドがない場合は、その旨を簡潔に伝え、プロンプトは手動でコピーできるよう Markdown のコードブロックにすでに記載されていることを案内します。
    • 両方: 先にファイルを保存します。その後、クリップボードが利用可能であればプロンプトをコピーします。利用できない場合は、ファイルを保存し、手動でコピーする方法を案内します。

    修正の場合: ユーザーからプロンプトの修正を求められたら、修正版を最初に提示します。その後、提示後の選択肢を再度案内します。

  6. 反復して調整する機会を案内する

    • 「このプロンプトの特定の部分を調整しますか?」
    • 「別の実行コンテキストに合わせて最適化を調整しますか?」
    • 「このプロンプトの構成について、別の方法も確認しますか?」

    タスクの実行を申し出てはいけません。 担当するのは、プロンプトの最適化と、任意の保存またはコピーのみです。

完了条件:最適化したプロンプトの検証を終え、回答で直接提示し、必要に応じて提示後のアクションを案内していること。

自由度の調整

このガイドラインにどの程度厳密に従い、どの程度柔軟に適用するか:

タスクの脆弱性自由度指針
メタプロンプト/システムプロンプト低フレームワークの構造に厳密に従います。これらは他のプロンプトの動作を定義します
本番環境向けのプロンプト最適化中例を参考にフレームワークを適用し、一貫性と状況に応じたニーズのバランスを取ります
創造的なプロンプト設計高原則とアンチパターンをガードレールとして使い、ユーザーの創造的なビジョンに合わせて自由に調整します

脆弱性が高いほど(左側)、遵守は厳格になります。脆弱性が低いほど(右側)、適用の自由度は高くなります。

重要な注意事項

モデルごとの動作の違いは大きいです Claude 4.5+ はネイティブで拡張思考を使用します。GPT-4 は内部的な CoT を使用します。古いモデルでは、明示的な CoT 指示が有効な場合があります。あるモデルファミリーで有効な最適化戦略が、別のモデルファミリーでは性能を低下させることがあります。対象モデルの能力を常に考慮してください。

本番環境ではトークンの節約が重要です システムプロンプトの各単語は、API 呼び出しの回数分だけコストに影響します。冗長な指示は、規模が大きくなるほど高コストになります。明確さと簡潔さのバランスを取ってください。必要に応じて詳細を読み込む段階的な開示により、基本のトークンコストを削減できます。

プロンプトインジェクションのセキュリティ上の影響 ユーザー入力を扱うプロンプトを最適化する際は、インジェクション攻撃を考慮してください。入力を検証してサニタイズし、指示とデータを区切り文字で分離してください。また、ユーザーコンテンツによってシステム指示が上書きされることは決して許可しないでください。

応答パターン

ユーザーまたは文脈から明らかに別の対応が求められていない限り、次のデフォルトを使用してください。

  1. 明示的な最適化の依頼 — 確認の質問は省略します。直接最適化してください。不適切なプロンプトになるのを防ぐために必要な確認だけを行ってください。
  2. 暗黙的または曖昧な依頼 — 確認の質問を使って、プロンプトの最適化とタスクの実行を切り分けます。
  3. 非常に曖昧な依頼 — 草案を作成する前に、成果物の種類、対象者、目的、制約、成功基準など、基本的な質問をしてください。
  4. 複雑度の高い実行依頼 — 後続のタスクでは実行前に設計が必要になるため、最適化したプロンプトまたはガイダンスで計画モードを推奨してください。
  5. すでに優れたプロンプト — フレームワーク全体の書き換えを無理に行わず、効果の高い小さな編集にとどめてください。

集中的なセルフチェック

仕上げる前に、次の点を重点的に確認してください。

  1. 逐次指示の確認 — 手順の順序、ゲート、スキップ条件、提供後のタイミングが明確で、依然として正しいことを確認します。
  2. 平易な英語の確認 — 説明文の振る舞いを損なわず、直接的で読みやすく、ざっと確認しやすい表現に整えます。
  3. 定性的な表現の確認 — 隠れたゲートや許可として機能し得る、不要な定性的表現を削除するか、簡潔にします。
  4. 義務表現の確認 — 特に MUST、DO NOT、NEVER、計画モードに関する指針について、要件の強さが正確に保たれていることを確認します。
  5. 参照情報の厳密な確認 — ファイルパス、フレームワーク名、ツール名、コマンド、ユーザー向けの引用文を再確認します。
  6. ファイル間の一貫性の確認 — 読み込んだ参照資料と AGENTS.md を再確認し、用語、ワークフロー、ガードレールが一致していることを確認します。

コメント