refine

必須の準備

/agent-workflow を実行してください。ワークフローの原則、アンチパターン、コンテキスト収集プロトコルが含まれています。先に進む前にプロトコルに従ってください。ワークフローのコンテキストがまだ存在しない場合は、必ず先に /teach-maestro を実行してください。

---

これは最終的な品質チェックです。ワークフローは動作しています。ここから優れたものに仕上げてください。

改善チェックリスト

プロンプト

• すべてのプロンプトが 4 ゾーンパターン（役割、コンテキスト、指示、出力）に従っている
• 出力スキーマが明示され、検証されている
• 否定的な指示で、してはいけないことが明確になっている
• 矛盾する指示がない
• あいまいなタスクには少数ショットの例が含まれている
• 複数ステップの推論タスクには思考の連鎖が使われている

ツールの説明

• すべてのツールに、用途、使用するタイミング、使用しないタイミング、戻り値を説明する複数行の説明がある
• 入力パラメーターに説明と型がある
• エラーレスポンスが文書化されている
• 説明に少なくとも 1 つの入力／出力例がある

エラーメッセージ

• エラーメッセージが具体的である（「エラーが発生しました」ではない）
• エラーメッセージに修正方法が示されている
• エラーにコンテキスト（何を試みていたか）が含まれている
• エラーが構造化されている（コード＋メッセージ＋詳細）

ログ

• すべてのモデル呼び出しが記録されている（入力トークン数、出力トークン数、レイテンシー、コスト）
• ツール呼び出しが入力と出力とともに記録されている
• エラーが完全なコンテキストとともに記録されている
• ログから PII が削除されている
• ワークフロー ID がすべてのログエントリーで追跡されている

設定

• すべてのマジックナンバーが名前付き定数になっている
• 環境固有の値がコードではなく設定にある
• デフォルト値が適切で、設定は上書きに使用される
• コスト上限が設定されている
• すべての外部呼び出しにタイムアウト値が設定されている

出力

不合格となるチェック項目ごとに、次の内容を提示してください。

1. 問題点（具体的な指摘）
2. 該当箇所（ファイル、行、またはコンポーネント）
3. 修正方法（具体的な提案）
4. 優先度（critical／important／nice-to-have）

優先度マトリクス

優先度	基準	Maestro のアクション
Critical	正確性または安全性に影響する	リリース前に /fortify または /guard
Important	品質または保守性に影響する	現在のサイクルで /calibrate
Nice-to-have	表面的な問題、または軽微な不整合	次の /refine パス用に記録

推奨される次のステップ

改善が完了したら、現実的なシナリオに対して洗練されたワークフローを検証するため、/evaluate を実行してください。

絶対にしてはいけないこと：

• チェックリストを飛ばすこと。すべての項目を確認してください
• 確認せずに項目を合格とすること
• 動作を変える変更を提案すること（これは仕上げであり、再設計ではありません）
• ワークフローが機能的に正しくなる前に改善すること（まず修正し、最後に仕上げてください）