skill-sync

目的

AGENTS.md の Auto-invoke セクションをスキルのメタデータと同期させます。スキルを作成または変更したら、同期スクリプトを実行して、影響を受けるすべての AGENTS.md ファイルを自動更新してください。

必須のスキルメタデータ

Auto-invoke セクションに表示するスキルには、metadata に以下のフィールドが必要です。

auto_invoke には、単一の文字列またはアクションのリストを指定できます。

metadata:
  author: prowler-cloud
  version: "1.0"
  scope: [ui]                                    # Which AGENTS.md: ui, api, sdk, root

  # Option A: single action
  auto_invoke: "Creating/modifying components"

  # Option B: multiple actions
  # auto_invoke:
  #   - "Creating/modifying components"
  #   - "Refactoring component folder placement"

スコープの値

スコープ	更新対象
root	AGENTS.md（リポジトリのルート）
ui	ui/AGENTS.md
api	api/AGENTS.md
sdk	prowler/AGENTS.md
mcp_server	mcp_server/AGENTS.md

スキルには複数のスコープを指定できます：scope: [ui, api]

---

使用方法

スキルの作成・変更後

./skills/skill-sync/assets/sync.sh

実行内容

1. すべての skills/*/SKILL.md ファイルを読み込みます
2. metadata.scope と metadata.auto_invoke を抽出します
3. 各 AGENTS.md の Auto-invoke テーブルを生成します
4. 各ファイルの ### Auto-invoke Skills セクションを更新します

---

例

次のスキルメタデータがある場合：

# skills/prowler-ui/SKILL.md
metadata:
  author: prowler-cloud
  version: "1.0"
  scope: [ui]
  auto_invoke: "Creating/modifying React components"

同期スクリプトは ui/AGENTS.md に次の内容を生成します：

### Auto-invoke Skills

When performing these actions, ALWAYS invoke the corresponding skill FIRST:

| Action | Skill |
|--------|-------|
| Creating/modifying React components | `prowler-ui` |

---

コマンド

# Sync all AGENTS.md files
./skills/skill-sync/assets/sync.sh

# Dry run (show what would change)
./skills/skill-sync/assets/sync.sh --dry-run

# Sync specific scope only
./skills/skill-sync/assets/sync.sh --scope ui

---

スキル変更後のチェックリスト

• 新規または変更したスキルに metadata.scope を追加した
• アクションの説明を含む metadata.auto_invoke を追加した
• ./skills/skill-sync/assets/sync.sh を実行した
• AGENTS.md ファイルが正しく更新されたことを確認した