エージェントスキルで Genie Code を拡張する

ドメイン固有のタスクに特化した機能を使用して、エージェント モードで Genie Code を拡張するスキルを作成します。このページでは、スキルを作成して最適化する方法について説明します。

スキルとは何ですか?

特殊な機能で Genie Code を拡張するスキルを作成します。スキルは、エージェント スキルのオープン スタンダードに準拠します。スキルは、特定のタスクを実行するために Genie Code が必要に応じてロードできるドメイン固有の知識とワークフローをパッケージ化します。スキルには、ガイダンス、ベスト プラクティス、再利用可能なコード、実行可能なスクリプトなどが含まれます。

スキルはドメイン固有のタスクに合わせて調整する必要があります。スキルを使用すると、指示よりも多くのコンテキスト (スクリプト、例、その他のリソースなど) をタスクに提供できます。グローバルに適用されるカスタム命令とは異なり、スキルは関連するコンテキストでのみ自動的に読み込まれます。エージェント モードでは、Genie Code はリクエストとスキルの説明に基づいて、関連するスキルを自動的に読み込みます。@メンションすることで、スキルを手動で呼び出すこともできます。これにより、効率的なコンテキスト ウィンドウが維持され、複数のチャットにわたって同じコンテキストを提供する必要性が軽減されます。

スキルには2種類あります。

• ワークスペーススキル : ワークスペース内の全員が利用できます。 ワークスペース管理者は、ワークスペース スキルを作成し、他のユーザーにスキル フォルダへのアクセスを許可してスキルを追加できます。 ワークスペーススキルは、機械学習ワークフローやドメイン固有のプロセスなど、チーム全体で広く役立つワークフローに活用しましょう。
• ユーザースキル ：あなただけが利用できます。他のワークスペースメンバーとは関係のない個人的なワークフローには、ユーザー スキルを使用してください。

注記

スキルは Genie Code Agent モードでのみサポートされます。

スキルを作成する

スキルは.assistant/skills/ディレクトリに格納されます。各スキルには専用のフォルダと、そのフォルダ内にSKILL.mdファイルが必要です。勤務地はスキルタイプによって異なります。

• ワークスペーススキル ： Workspace/.assistant/skills/
• ユーザースキル ： /Users/{username}/.assistant/skills/

新しいスキルを作成するには:

1. スキルタイプに応じて、適切なパスに新しいスキルフォルダを作成してください。

   作成後、Genie Codeパネルからスキルフォルダにすばやくアクセスできます。クリック 設定 をクリックして、 スキルフォルダを開きます 。

2. スキルフォルダの中に、そのスキル専用のフォルダを作成してください。各スキルはそれぞれ専用のフォルダを持つ必要があります。例えば：

   Workspace/.assistant/skills/
   └── ml-workflows/
       └── SKILL.md
   
   /Users/{username}/.assistant/skills/
   └── personal-workflows/
       └── SKILL.md

3. スキル フォルダー内にSKILL.mdファイルを作成します。このファイルは必須であり、スキルを定義します。スキルはエージェント スキルの仕様に従います。

4. スキルに必要なフロントマターを追加します。

   ---
   name: skill-name
   description: A description of what this skill does and when to use it.
   ---

5. フロントマターの後に、スキルの説明を Markdown 形式で追加します。次のセクションを含めることをお勧めします。

   • ステップバイステップの説明: 明確な手順ガイド
   • 例: サンプル入力と期待される出力
   • エッジケース: 一般的なバリエーションと例外

6. (オプション) より複雑なスキルの場合は、追加のリソースを提供して参照することができます。

   • エージェントが実行できる実行可能コードを含むスクリプト。
   • ベスト プラクティスやテンプレートなど、参照するための追加ドキュメントを含むファイル。

   他のファイルを参照する場合は、ルート スキルからの相対パスを使用します。

   例えば、ワークスペースの機械学習ワークフロースキルと個人のワークフロースキルは、次のような構造を持つ可能性があります。

   Workspace/.assistant/skills/
   ├── ml-workflows/
      ├── SKILL.md                # Workflow overview and best practices
      ├── training-patterns.md    # Standard ML training patterns
      └── scripts/
            └── model-deploy.py   # Model deployment automation
   
   /Users/{username}/.assistant/skills/
   ├── personal-workflows/
      ├── SKILL.md                # Workflow overview and best practices
      ├── etl-patterns.md         # Personal ETL best practices
      ├── dashboard-templates.md   # Reusable dashboard patterns
      └── scripts/
            └── pipeline-setup.sh   # Environment setup scripts

Genie Code は、エージェント モードで次回使用するときに、自動的にスキルを取得します。また、スキルを@メンションして、Genie Code が確実にそのスキルを使用するようにすることもできます。

ベストプラクティス

効果的なスキルを書くには、次のガイドラインに従ってください。

• 適切なスキルタイプを選択してください。ワークスペースのスキルは、共有機械学習パイプラインやドメイン固有のプロセスなど、多くのユーザーにメリットをもたらすワークフローに活用しましょう。他のユーザーには関係のない、個人的なワークフローにユーザー スキルを使用します。
• スキルを集中させましょう。スキルは、単一のタスクまたはワークフローに焦点を当てた場合に最も効果を発揮します。スコープを狭くすると、スキルが適用されるタイミングを Genie Code が認識しやすくなります。
• 明確な名前と説明を使用してください。簡潔で説明的な名前と概要は、Genie Code が適切なスキルを適切なリクエストに一致させるのに役立ちます。
• 明確に、例を挙げて説明してください。ワークフローをステップごとに説明し、 Genie Code で再利用できる具体的な例やパターンを含めます。
• 不必要なコンテキストを避けてください。タスクに必要な情報のみを含めます。詳細を追加すると、スキルを確実に適用することが難しくなる可能性があります。
• 時間をかけて繰り返します。スキルを生きたワークフローとして扱います。実際の使用状況に基づいた小さな更新により、結果が大幅に改善される可能性があります。
• ガイダンスと自動化を分離します。マークダウンを使用して、意図とベストプラクティス、および繰り返し可能なアクションのスクリプトを説明します。これらの懸念事項を明確にしておくと、スキルの維持と再利用が容易になります。

参照

• Genie Code の応答を改善するためのヒント: チャット プロンプトでスキルを手動で参照する方法を学びます。
• AIコーディングアシスタント向けエージェントスキル：ClaudeやGitHub CopilotなどのAIコーディングアシスタント向けエージェントスキルを見つけてインストールします。