Rovo Dev CLI をエージェント スキルで拡張する

Rovo Dev で新しいエージェント スキルを作成する

エージェント スキルは、Rovo Dev に特定のタイプのタスクの実行方法を教える再利用可能な指示セットです。スキルは、Rovo Dev にいつどのように使用するかを指示する短い YAML ヘッダーを含むマークダウン ファイルです。Rovo Dev にスキルを配備すると、タスクが一致するたびにその指示が読み込まれ、ユーザーが毎回コンテキストを再説明しなくても、ナレッジに基づいて一貫して動作するようになります。エージェント スキルは、オープンなエージェント スキル プロトコルに準拠しています。

スキルを配備する場所

スキルをどこに保存するかによって、誰がそのスキルを使用できるかが決まります。スキルが複数のレベルで同じ名前を共有している場合、優先度の高い場所 (組み込み > ユーザー > プロジェクト) が優先されます。

場所

パス

適用先

ビルトイン

Rovo Dev に付属

全てのユーザーが

ユーザー

~/.rovodev/skills/<skill-name>/ または

~/.agents/skills/<skill-name>/

すべてのプロジェクト

Project

.rovodev/skills/<skill-name>/ または

.agents/skills/<skill-name>/

このプロジェクトのみ

最もシンプルな形では、各スキルは SKILL.md ファイルをエントリ ポイントとして含むディレクトリです。それと一緒にオプションのサポート ファイル (スクリプト、リファレンス ドキュメント、テンプレート) を配置し、より高度なスキルが必要な場合にメイン ファイルから参照できます。エージェント スキル プロトコルを参照して、スクリプト、リソース、その他のエージェント スキル機能の使用方法の詳細をご確認ください。

スキルをインタラクティブ モードで管理する

Rovo Dev TUI で、/skills を使用してインタラクティブなスキル メニューを開きます。ここでは、次の操作を行うことができます。

  • 組み込み、ユーザー、プロジェクトの各スコープで利用可能なすべてのスキルを表示し、説明、許可されたツール、ファイルの場所と併せて確認します。

  • 短いウィザードを進めて新しいスキルを作成します。ユーザーレベルとプロジェクトレベルのどちらのスキルかを選択し、名前、説明、指示を入力します。

  • 既存のスキルの説明や指示を編集します (組み込みスキルは編集できません)。

  • ユーザー スキルまたはプロジェクト スキルを削除します (組み込みスキルは削除できません)。

スキルを手動で作成する

スキルを手動で作成するには、適切な場所にディレクトリと SKILL.md ファイルを作成します。プロジェクトレベルのスキルの場合の例を次に示します。

.rovodev/skills/code-review/SKILL.md

SKILL.md ファイルは 2 つの部分で構成されます。YAML フロントマター ブロック (--- マーカー間) とマークダウン本文の 2 つであり、後者にはスキルが呼び出されたときに Rovo Dev が従う指示が含まれています。

--- name: code-review description: Reviews code changes and provides feedback on code quality, best practices, and potential issues. allowed-tools: - open_files - expand_code_chunks - grep - bash --- You are an expert code reviewer. When reviewing code: 1. Focus on correctness, maintainability, and adherence to best practices 2. Look for potential bugs, security issues, and performance problems 3. Suggest improvements with clear explanations 4. Be constructive and educational in your feedback

フロントマター フィールド

フィールド

必須

説明

name

必須

スキル名。小文字、数字、ハイフンを使用します (最大 64 文字)。ディレクトリ名と一致する必要があります。

description

必須

スキルの機能と使用するタイミング。Rovo Dev でスキルを自動的に読み込むタイミングを判断するために使用されます。

allowed-tools

任意

スキルの使用が事前に承認されているツールのリスト。

license

任意

スキルのライセンス情報。

compatibility

任意

スキルの互換性情報。

metadata

任意

任意のキーと値のメタデータ。

スキルを呼び出す

Rovo Dev では、スキルを次の 2 つの方法で読み込んで使用できます。

  • 自動的 — セッション開始時に Rovo Dev により各スキルの「説明」フィールドが読み取られ、手元のタスクに適合する場合に、該当するスキルの指示が読み込まれます。明白な選択を可能にするキーワードを含めて、明確で具体的な説明を記述してください。

  • 明示的 — Rovo Dev に使用させるスキルをプロンプトで名前で指定します。たとえば、Use the code-review skill to review my latest changes のように指定します。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。