octocode-prompt-optimizer について
Octocode Prompt Optimizer は、文章の見栄えではなく指示の動作を改善するスキルです。意図や権限、機能するロジックを保ちながら、理解、評価、修正、検証を段階的に進めます。
主な機能
- 01段階的なプロンプトのレビューと修正
- 02証拠に基づく問題の重大度評価
- 03意図と動作の検証
- 04ツール・MCP 契約の最適化ガイド
- 05ホールドアウト評価のガイド
活用シーン
- 01不安定な動作を招く指示の修正
- 02ツール向けプロンプト契約の明確化
- 03意図を保ったプロンプトのノイズ削減
- 04ホールドアウトシナリオによる変更評価
MCP 対応
ツールや MCP の契約を最適化するガイドがあり、入力、出力、権限、失敗状態を明確にします。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ bgauryy/ octocode --skill octocode-prompt-optimizerインストール後、Claude Code で/octocode-prompt-optimizerを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdreferences/agent-communication.mdattention.mdconciseness-toolkit.mdcontext-budget.mdevaluation-data.mdfix.mdgates.mdimprove-loop.mdoutput.mdpatterns.mdprompt-caching.mdprompt-techniques.mdrate.mdtool-contracts.mduntrusted-content.mdvalidate.mdzod-agent-contracts.md詳細
Octocode プロンプトオプティマイザー
文章の見た目ではなく、指示の動作を最適化します。
フロー:READ → UNDERSTAND → RATE → FIX → VALIDATE → OUTPUT。
ロビーのルールとゲート
- READ:入力全体とその種類を確認します。UNDERSTAND:目標、構成要素、フロー、前提、未知の事項を整理します。
- RATE:根拠のある問題、重大度、ベースラインを記録します。FIX:Critical/High の問題に対処し、意図的に見送る項目を明記します。
- VALIDATE:意図と必要な動作が正しく保たれていることを証明します。OUTPUT:要求された成果物と、実際に即した差分を提示します。
- 複数セクションにわたる作業、曖昧な作業、ツール向けの作業、またはリスクの高い作業では、全工程を実施します。短く低リスクのテキストでは、隣接するステップをまとめてもかまいません。VALIDATE は必ず実施します。
- 意図、動作している分岐、識別子、コマンド、必須メタデータを維持します。変更する前に確認を求めます。
- 書き換える前に、引用されているコマンド、フラグ、パス、ツール名、スキーマを検証します。未検証の主張にはその旨を示します。
- 重大な動作に限って必須とし、本当の好みは希望としての表現を維持します。権限がある場合に限り、ファイルを変更します。
- 次の場合は停止します:意図、範囲、またはリスクを変えうる重要な不明点がある場合は、焦点を絞った質問を一つして一時停止します。指示の権限が曖昧な場合、または競合の解決がユーザーの意図を上書きする場合。編集によって意図や動作中のロジックが変わった場合は、変更を元に戻して UNDERSTAND に戻ります。書き込み権限がない場合は、ファイルを変更せず、パッチ形式の差分を提示します。同じセクションの VALIDATE チェックが二度失敗した場合は、無理に合格させず、最も弱い分岐を報告します。信頼性の向上を示す保留データでの証拠がない場合は、未測定として報告します。
スマートルート — 現在のステップで必要なものだけを読み込む
- READ と UNDERSTAND:
references/gates.mdを読み込みます — すべてのセクションに目を通し、評価や草稿の作成前に意図を整理します。 - RATE:
references/rate.mdを読み込みます。FIX:references/fix.mdを読み込みます。VALIDATE:references/validate.mdを読み込みます。OUTPUT:references/output.mdを読み込みます — 現在のゲートだけを読み込み、後続ステップの助言が現在の判断に影響しないようにします。 - 指示が競合する場合、または簡潔な指示パターンが必要な修正を行う場合は、
references/patterns.mdを読み込みます — より高い権限を優先し、解決内容を一行で記録します。 - ノイズを減らす場合は
references/conciseness-toolkit.mdを読み込みます。優先順位や階層を修正する場合はreferences/attention.mdを読み込みます。観察された失敗に対する手法を選ぶ場合はreferences/prompt-techniques.mdを読み込みます — 手法を失敗のメカニズムに合わせます。 - ツールまたは MCP の契約を最適化する場合は
references/tool-contracts.mdを読み込みます。エージェント間の引き継ぎにはreferences/agent-communication.mdを読み込みます。型付きパケット境界にはreferences/zod-agent-contracts.mdを読み込みます — 入力、出力、権限、失敗状態を明示します。 - コンテキストがあふれる可能性がある場合は
references/context-budget.mdを読み込みます。繰り返される呼び出しで安定したプレフィックスを共有する場合はreferences/prompt-caching.mdを読み込みます — 関連性、ページネーション、レイテンシ、コストを管理します。 - 信頼性を測定する必要がある場合は
references/evaluation-data.mdを読み込みます — 現実的な保留シナリオ、検証器、メトリクス、失敗台帳を作成します。 - 指示が検索結果やユーザー提供のコンテンツを扱う場合は
references/untrusted-content.mdを読み込みます — データと権限の境界を維持します。 - このスキルを改善する場合は、
octocode-graph-evalを優先します。それ以外の場合はreferences/improve-loop.mdを読み込みます — 直感ではなく、測定可能な合格基準を必須にします。
関連ルート
- スキルフォルダーのアーキテクチャやレビューには
octocode-skillsを使用します。引用された契約の検証にはoctocode-researchを使用します。保留データでの動作評価にはoctocode-graph-evalを使用します。 - 委任のトポロジーには
octocode-subagentを使用します。
完了ゲート
- このスキルにはスクリプトが含まれていません。上記のすべてのゲートはモデル駆動型であるため、実際に行っていないチェックを報告してはいけません。
- 完了には、VALIDATE に合格していること、要求に合った OUTPUT 形式であること、報告する変更前後のスコア、変更ファイル、見送り項目がすべて実態と一致していることが必要です。
コメント
Markdown 対応