Tune skill
チューニングとは、既存のスキルに小さな証拠に基づいた編集を加えることです。書き換えではありません。目標は、適切なリクエストでトリガーされ、他のスキルの邪魔をせず、定義された形で作業を引き継ぐスキルにすることです。
基本ルール
- 最初に実際のSKILL.mdを読んでください。 README、リポジトリの説明、リストは、エージェントが実際に読み込むファイルから乖離していることがあります。スキルに関する主張は、すべてそのSKILL.mdまたはその参照元に基づいている必要があります。ファイルを開けない場合は、ファイル名を明示し、代わりに推測していることを述べてください。
- 自分の主張を確認してください。 後で読んだファイルが以前の主張と矛盾する場合は、その旨を率直に述べ、修正してください。静かに回避しないでください。
- 最小限の編集、作者の声。 監査で見つかった箇所のみを変更し、それ以外は変更しないでください。認識できないフロントマターキー（
version、argument-hint、user-invocable）はそのままにしてください。誠実さ、安全性、プライバシーに関するルールを弱めてはいけません。 - 実行していないことを主張しないでください。 どのチェックを実行したか、どのテストケースを書いただけか、どのファイルを見なかったかを明示してください。
ワークフロー
1. 収集
対象スキルのSKILL.mdと、それに関連するすべての兄弟スキルのSKILL.md、さらにアクセス可能なすべての参照を取得してください。ユーザーが開けないリンクを提供した場合は、ファイルのテキストまたはそのURLを尋ねてください。スキルがディスク上のフォルダの場合は、最初の読み取りとして今すぐチェックスクリプト（ステップ6）を実行してください。
2. マッピング
各スキルについて、簡単なインベントリを作成してください。その説明が約束していること、モードやコマンド、参照しているファイル、何を誰に引き継ぐかを含めてください。兄弟スキルの説明とコマンドリストを並べて表示してください。重複は、両方を見ることができて初めて明らかになります。
3. 監査
references/audit-checklist.mdに従って作業を進めてください。発見事項ごとに、証拠（該当行を引用）、重大度（トリガーを壊す、混乱を招く、外観上の問題）、および最小限の修正を記録してください。最も重大なものから報告してください。
4. 境界の確定
2つのスキルが同じリクエストを主張する場合、1つの所有者に割り当ててください。ユーザーの既存の設計で既に使用されている分割方法を使用してください（例：verdictとartifact：一方のスキルが判断し、もう一方が作成する）。ユーザーの設計で解決できない場合にのみ、一度だけユーザーに尋ねてください。
5. 編集
各発見事項を修正する最小の変更を行ってください。ユーザーが結果をそのままリポジトリにドロップする場合は、置き換えファイル全体を返却し、変更されていないテキストは正確にコピーしてください。修正に新しい共有部分（例えばハンドオフ形式）が必要な場合は、まだ見ていないファイルを編集する代わりに、新しい参照ファイルを追加してください。おそらく一致する更新が必要な参照ファイルをリストアップしてください。
6. 検証
各スキルフォルダでチェックスクリプトを実行してください：
python scripts/check_skill.py <path-to-skill-folder>
これにより、名前がフォルダと一致すること、説明が1024文字の制限内に収まりトリガーと境界の文言があること、H1が名前と一致すること、参照ファイルが存在すること、本文が妥当な長さであることがチェックされます。すべてのFAILを修正してください。各WARNを判断してください。テキストを貼り付けただけの場合は、SKILL.mdをスキル名のフォルダに保存してそこで実行してください。その場合、参照ファイルがないという警告は想定内です。
7. テストケースの作成
references/test-cases.mdに従ってください。変更した境界ごとに、両側に1つのテストケースを作成してください。説明に対して手動でテストケースを実行してください。一部のエージェントは、作成ツールに自動トリガーループを組み込んでいます。実行していない場合は、実行したと暗示しないでください。どれを実行したかを明示してください。
8. 報告
簡潔にまとめてください：
- スキルごとに、何が変わったかとその理由（各行1つ）。
- 以前の主張に対する修正。
- 確認できなかった、または実行しなかったこと。
- 次のステップを1つ。
プロセスではなく、変更点を最初に提示してください。