アクティベーションコントラクト
このスキルは、スキルのインストール、削除、作成、移動、名前変更を行った後、またはデリゲーターが新しいスキルインデックスを必要とするときに使用します。
ハードルール
- レジストリはインデックスであり、コンパイラやサマリーではありません。
SKILL.mdが信頼できる唯一の情報源です。 - デフォルトでコンパクトルールを生成または注入しないでください。正確なスキルパスをサブエージェントに渡すことで、作成者の意図を保持します。
- SDD永続化モードに関係なく、常に
.atl/skill-registry.mdを書き込みます。 - 可能な場合は、
capture_prompt: falseを指定して、Engramにtopic_key: skill-registryとしてレジストリを保存します。 sdd-*、_shared、skill-registryをスキップし、スキル名で重複排除し、ユーザーレベルのスキルよりもプロジェクトレベルのスキルを優先します。- 明示的に無効にされていない限り、可能な場合は
.atl/を.gitignoreに追加します。
決定ゲート
| 状況 | アクション |
|---|---|
| 同じスキルがグローバルとプロジェクトに存在する | プロジェクトレベルのスキルを保持 |
| 同じスキルが複数のグローバルロケーションに存在する | スキャン順序で最初のソースを保持 |
| スキルが見つからない | エージェントが盲目的に検索を続けないように、空のレジストリを書き込む |
| エージェントが作業を委任する | 一致するレジストリ行を選択し、そのSKILL.mdパスを渡す |
実行手順
- 既知のすべてのユーザーおよびプロジェクトスキルディレクトリを
*/SKILL.mdについてスキャンします。 - 必要に応じてフロントマターのみを読み取り、
nameおよびdescriptionトリガーテキストを抽出します。 - スキャンしたソース、レジストリコントラクト、スキル名、トリガー/説明、スコープ、および正確なパスを含む
.atl/skill-registry.mdをレンダリングします。 - 可能な場合は、
title: skill-registry、topic_key: skill-registry、type: config、capture_prompt: falseを使用してEngramに永続化します。 - レジストリパス、スキル数、キャッシュステータス、Engramが更新されたかどうかを返します。
出力コントラクト
以下の情報を返します:
- プロジェクト名と
.atl/skill-registry.mdのパス。 - インデックス化されたスキルの数。
- キャッシュがヒットしたか、再生成されたか。
- スキップまたは重複したスキル(該当する場合)。
参考文献
docs/skill-style-guide.md— インデックス化前にスキルを作成する方法。skills/_shared/skill-resolver.md— デリゲーターがインデックスをどのように使用するか。