アクティベーション契約
このスキルは、既存の SKILL.md ファイルの監査、リファクタリング、正規化、または改善を行う際に使用します。新規スキルを再利用可能なパターンから作成する場合は gentle-ai-skill-creator を使用してください。
ハードルール
- 最初に
docs/skill-style-guide.mdを読み、それを規範的なスタイル契約として扱います。 SKILL.mdを真実の情報源として扱い、作成者の意図、重要なルール、アクティベーションセマンティクス、および出力要件を保持します。.atl/skill-registry.mdを、スキル名、トリガー、スコープ、および利用可能な場合は正確なパスのインデックスとして使用します。- デフォルトは監査のみとします。ユーザーが明示的に改善の適用を要求した場合にのみファイルを変更します。
- 意味のあるコンテンツを黙って削除しないでください。長い説明、例、テンプレート、スキーマはローカルの
references/またはassets/に移動します。 - トリガー、ポリシー、またはドメインルールを発明しないでください。あいまいなケースは人間によるレビューのためにマークします。
決定ゲート
| 状況 | アクション |
|---|---|
| フロントマターが欠落または無効 | name、引用符で囲まれた1行の description、license、metadata を修正 |
| スキルがチュートリアル風のドキュメントのように読める | ランタイム指示に変換し、背景情報は references/ に移動 |
| 本文が予算超過 | ルールを保持し、例や背景を補助ファイルに移動 |
| 散文に隠れた分岐ロジック | コンパクトな決定表に変換 |
| ルールが競合または意図が不明瞭 | 問題を報告し、そのルールを自動的に書き換えない |
実行手順
docs/skill-style-guide.mdを読みます。.atl/skill-registry.mdを読み、リストされたパスを使用してスキルを選択します。存在しない場合は、既知のスキルディレクトリで*/SKILL.mdをスキャンします。- 選択した各スキルについて、メタデータ、トリガーの明確さ、セクション順序、本文予算、実行可能性、決定ゲート、出力契約、およびローカル参照を監査します。
- スキルごとにグループ化され、重大度と正確な提案された変更を含む監査レポートを返します。
- 適用モードでは、安全な問題のみを編集し、コンテンツを保持し、必要に応じて補助ファイルを作成し、その後
/skill-registry:refreshを更新またはリクエストします。
出力契約
以下を返します：
- 監査されたスキルと使用されたパス
- 重大度ごとにグループ化された発見された問題
- 適用モードが要求された場合、変更されたファイル
- スキルのメタデータまたはパスが変更された場合のレジストリ更新推奨
- 人間によるレビューが必要なあいまいな点
参照
docs/skill-style-guide.md— 規範的なLLMファーストスキルスタイルガイドskills/skill-registry/SKILL.md— レジストリ更新とインデックス化契約