calibrate について
calibrateは、AIワークフローの各要素の規約をそろえるMaestroスキルです。命名、プロンプト、エラー処理、ログを監査し、優先順位付けとテスト検証を促します。
主な機能
- 01命名規約の監査
- 02プロンプト構造とスタイルの確認
- 03エラー処理パターンの点検
- 04ログの一貫性確認
- 05変更の優先順位付けと検証
活用シーン
- 01ツール名の不整合の発見
- 02プロンプト形式の統一
- 03エラー応答の標準化
- 04ログと個人情報のマスキング確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ sharpdeveye/ maestro --skill calibrateインストール後、Claude Code で/calibrateを入力して読み込まれたか確認します。
詳細
必須の事前準備
/agent-workflow を実行してください。ワークフローの原則、アンチパターン、コンテキスト収集プロトコルが含まれています。作業を進める前にプロトコルに従ってください。ワークフローのコンテキストがまだ存在しない場合は、必ず先に /teach-maestro を実行してください。 命名とスタイルの一貫性パターンについては、agent-workflow スキルのプロンプトエンジニアリングリファレンスを参照してください。
すべてのワークフローコンポーネントに一貫性を持たせてください。一貫性がないと、モデル、開発者、ユーザーに混乱を招きます。
調整の観点
命名規則
- ツール名は一貫したパターンに従っています(verb_noun、noun.verb、または camelCase のいずれかを選択)
- エージェント名は一貫したパターンに従っています
- 設定キーは一貫したパターンに従っています
- ファイル名は一貫したパターンに従っています
プロンプトのスタイル
- すべてのプロンプトで同じ構造パターン(4 ゾーン)を使用しています
- 区切りスタイル(XML タグ、Markdown の見出し、三重ダッシュ)が一貫しています
- 出力スキーマ形式(JSON スキーマ、Markdown テンプレート)が一貫しています
- 指示のスタイル(命令形、番号付き手順)が一貫しています
エラー処理
- すべてのツールが同じ形式でエラーを返します
- エラーコードが一貫した方式に従っています
- エラーメッセージのトーンが一貫しています
- 再試行ロジックで一貫した戦略を使用しています
ログ記録
- すべてのログで同じ形式(構造化 JSON、テキストなど)を使用しています
- すべてのログエントリでフィールド名が一貫しています
- ログレベル(debug、info、warn、error)が一貫しています
- PII のマスキング方法が一貫しています
調整プロセス
- 標準を特定する:既存のコードベースで最も一般的なパターンは何ですか?それが標準です。
- 逸脱を列挙する:標準から逸脱しているすべてのコンポーネントを見つけます。
- 優先順位を付ける:影響の大きい逸脱から修正します(ユーザー向け > 内部向け)。
- 適用する:テストが引き続き通ることを確認しながら変更します。
- 文書化する:確立した規約を
.maestro.mdに反映します。
一貫性監査表
| 観点 | 標準 | 発見した逸脱 | 優先度 |
|---|---|---|---|
| ツールの命名 | ? | ? 個 / ? 個のツール | 高/中/低 |
| プロンプトの構造 | ? | ? 個 / ? 個のプロンプト | 高/中/低 |
| エラー形式 | ? | ? 個 / ? 個のツール | 高/中/低 |
| ログ形式 | ? | ? 個 / ? 個のエントリ | 高/中/低 |
調整チェックリスト
- 各観点の規約標準を特定した
- 逸脱を場所とともにすべて列挙した
- 影響の大きい逸脱から修正した
- 調整の変更後にテストが通る
- 確立した規約を
.maestro.mdに反映した
推奨される次のステップ
調整後、最終的な仕上げとして /refine を実行するか、一貫性の改善を確認するために /evaluate を実行してください。
絶対に行わないでください:
- 既存の規約が機能しているのに、新しい規約を考案する
- 動作を変えるような調整を行う(これは標準化であり、リファクタリングではありません)
- 調整後のテスト検証を省略する
- すべての参照先を更新せずに命名規則を変更する
コメント
Markdown 対応