セルフラーニング スキル ジェネレーター

ウェブから新しいテクノロジーを自律的に調査・学習し、再利用可能なスキルを生成します。

使い方

/learn <topic>

<topic> が指定されていない場合は使い方を表示します。トピックが曖昧な場合は明確化を求めてください：

• "react" → "ウェブ用の React、React Native、または react-query のような特定のライブラリ?"
• "apollo" → "Apollo GraphQL クライアント、Apollo Server、または Apollo Federation?"
• "aws" → "どの AWS サービス? (S3、Lambda、DynamoDB など)"

ファイル名は kebab-case に正規化します。

2. ソース発見（ウェブ検索）

ウェブ検索ツールを使用して権威のあるドキュメントを探します：

試すべき検索クエリ：

1. <topic> official documentation
2. <topic> getting started guide
3. <topic> API reference
4. <topic> GitHub repository

ソースの優先順位：

1. 公式ドキュメントサイト (例: docs.、.dev)
2. 公式 GitHub リポジトリ (README、/docs)
3. 公式ブログ/アナウンスメント

最大 3～5 個の高品質 URL を選択します。

信頼できるソースが見つからない場合は、ユーザーに URL の提供を求めてください。

---

3. コンテンツ抽出（URL 読み込み）

選択された各 URL について、コンテンツを読み込みます：

関連セクションのみを抽出：

• インストール / セットアップ
• コアコンセプト
• API リファレンス / キー機能
• 一般的なパターン / 例
• バージョン情報

関連性のないコンテンツをスキップ：

• ナビゲーション、広告、ログインプロンプト
• 関連性のないサイドバーコンテンツ
• コメント、フォーラム

コンテンツ読み込みが失敗する場合（JavaScript が多く使われているサイト）は、ブラウザエージェントにフォールバックします：

Task: Navigate to <URL> and extract the main content including:
- Installation instructions
- Core concepts and API reference
- Code examples
Return the extracted content as markdown.

各ソースのスクレイプタイムスタンプを記録してください（現在の日付を YYYY-MM-DD 形式で使用）。

---

4. スキル生成

スキルはモジュール化された自己完結型パッケージです。すべてのスキルは必須の SKILL.md ファイルと、オプションのバンドルされたリソースで構成されます：

skill-name/
├── SKILL.md (必須)
│   ├── YAML frontmatter メタデータ (必須)
│   │   ├── name: (必須)
│   │   └── description: (必須)
│   └── Markdown 指示 (必須)
└── バンドルリソース (オプション)
    ├── scripts/          - 実行可能コード (Python/Bash など)
    ├── references/       - 必要に応じてコンテキストに読み込まれるドキュメント
    └── assets/           - 出力で使用されるファイル (テンプレート、アイコン、フォント など)

1. references/skill_creation_guide.md を読んでフォーマットと原則を理解します。
2. 学習・抽出した情報を新しいスキルに統合します。
   • トリガー： 使用する時期を明確に定義した説明を作成します。
   • ワークフロー： ステップバイステップの指示を作成します。
   • フォーマット： 有効な YAML frontmatter と適切なファイル構造を確認します。

5. スキルの保存

Antigravity は 2 つのタイプのスキルをサポートしており、ユーザーが要求した場合はグローバルワークスペースを保存します。

• .agent/skills/<skill-folder>/ ワークスペース固有
• ~/.gemini/antigravity/skills/<skill-folder>/ グローバル（すべてのワークスペース）

ディレクトリが存在しない場合は作成し、既存スキルを上書きする前にユーザーに警告を表示します。

---

6. ユーザーに確認

レポートを表示：

✓ Created skill: <topic>
  Sources scraped: <N>
  Saved to: .agent/skills/<topic>/SKILL.md
  This skill will auto-trigger when working with <topic>.

---

ツールリファレンス

• search_web: ドキュメント URL を発見
• read_url_content: 静的ページからコンテンツを抽出
• browser_subagent: JavaScript が多く使われているサイトからコンテンツを抽出
• write_to_file: 生成したスキルを保存

重要なルール

1. ドキュメントを捏造しない： スクレイプしたソースからの情報のみを含めてください。
2. API を作り上げない： ドキュメントが不明確な場合は、ユーザーに対処方法を尋ねてください。
3. URL を求める： 自動検出が失敗した場合は、特定の URL の提供をユーザーに求めてください。
4. ソースを検証： サードパーティのチュートリアルより公式ソースを優先します。