コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

Aggrega スキル

Aggrega スキルは、AI アシスタントに Aggrega のインストールと使い方を教えます。これは aggrega という名前のフォルダーで、オープンな Agent Skills 形式の SKILL.md ファイルを収めています。多くのアシスタントは、この形式のファイルを独自のスキルフォルダーから読み取り、リクエストが Aggrega に関わるときに読み込みます。

アシスタントにスキルを提供する方法は 2 つあります。プラグインをインストールできるアシスタントは、Aggrega プラグインの一部としてスキルを受け取ります。このプラグインはアシスタントを Aggrega MCP サーバーにも接続し、これらを 1 つの手順で行います。プラグインのインストールを参照してください。フォルダーからスキルを読み込むアシスタントであれば、aggrega バイナリにスキルをそのフォルダーへ書き込ませることができます。スキルのみのインストールを参照してください。

プラグインのインストール

リポジトリ aggrega-ai/aggrega-skills はスキルを収めており、以下のアシスタント向けのプラグインでもあります。プラグインをインストールすると、Aggrega スキルが追加され、アシスタントが Aggrega MCP サーバーに接続されます。サーバーはその後アシスタント自身が aggrega mcp として起動するため、そのアシスタントには aggrega skills install も MCP サーバーの接続の手順も必要ありません。

プラグインは aggrega バイナリをインストールしません。アシスタントがサーバーを起動するときに PATH 上で aggrega を見つけられるよう、バイナリのインストールの説明に従って先にインストールしてください。

Claude Code

Terminal window
claude plugin install aggrega --marketplace aggrega-ai/aggrega-skills

Claude Code の中では、同じ操作は /plugin install aggrega --marketplace aggrega-ai/aggrega-skills です。

Codex

Terminal window
codex plugin marketplace add aggrega-ai/aggrega-skills
codex plugin add aggrega@aggrega

1 つ目のコマンドはリポジトリを aggrega という名前のプラグインマーケットプレイスとして追加し、2 つ目のコマンドはそこから aggrega プラグインをインストールします。

GitHub Copilot

GitHub Copilot CLI の場合:

Terminal window
copilot plugin marketplace add aggrega-ai/aggrega-skills
copilot plugin install aggrega@aggrega

GitHub Copilot を使う Visual Studio Code は、GitHub Copilot CLI がインストールしたプラグインを見つけて同様に使用します。Visual Studio Code 自体からプラグインをインストールするには、コマンドパレットから Chat: Install Plugin from Source を実行し、リポジトリのアドレス https://github.com/aggrega-ai/aggrega-skills を指定します。

Gemini CLI

Terminal window
gemini extensions install https://github.com/aggrega-ai/aggrega-skills

Gemini CLI は、プラグインを拡張機能の 1 つとしてインストールします。

Antigravity

Terminal window
agy plugin install https://github.com/aggrega-ai/aggrega-skills

Cursor

Cursor は ~/.cursor/plugins/local/ の下にあるフォルダーからプラグインを読み込みます。そこにリポジトリを置き、コマンドパレットから Developer: Reload Window を実行します:

Terminal window
git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega

Kiro

Kiro はプラグインを power としてインストールします。Powers パネルで Add Custom Power、続いて Import power from GitHub を選択し、リポジトリのアドレス https://github.com/aggrega-ai/aggrega-skills を入力して Install を選択します。Kiro はプラグインの MCP サーバーを power と一緒に起動・停止します。

OpenClaw

Terminal window
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skills

OpenClaw は、自身でレビューしていないソースからプラグインをインストールする前に、2 回確認を求めます。まず処理を止め、ソースをレビューしてから --force を付けてコマンドを再実行するよう求めます。次に、--accept-capabilities によって、プラグインがもたらすもの(ここではスキルと MCP サーバー)への同意を求めます。リポジトリをレビューしたら、次を実行します:

Terminal window
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skills --force --accept-capabilities

--force は、すでにインストールされている同じ名前のプラグインも置き換えます。そのため、以前に aggrega という名前のプラグインをインストールしたことがある場合は、先に openclaw plugins list を確認してください。

サーバーが作業するフォルダー

Aggrega のツールはワークスペース内で動作し、ワークスペースを指定しない呼び出しには、サーバーが起動されたフォルダーから見つけたワークスペースで応答します。一部のアシスタントは、プラグインのサーバーをプロジェクトではなくプラグイン自身のフォルダーで起動します(Codex がそうです)。スキルはアシスタントに対し、プロジェクトで作業する前に config-show ツールでサーバーがどのワークスペースで応答するかを確認し、両者が異なる場合は、それを受け付ける各呼び出しでプロジェクトのフォルダーをフルパスで workspace_root として指定するよう指示します。相対パスの workspace_root は、サーバーがすでに応答しているワークスペースを基準に解釈されるためです。

スキルのみのインストール

プラグインを使わずにスキルをインストールするには、aggrega バイナリを使います。バイナリは組み込まれているコピーを書き込みます。マシン上のアシスタント向けに、すべてのプロジェクトで使えるようにインストールします:

Terminal window
aggrega skills install --global

現在のプロジェクトに、アシスタントを指定して 1 つのアシスタント向けにインストールします:

Terminal window
aggrega skills install --agent claude-code

インストール先にできるアシスタントを、それぞれが読み込むフォルダーとともに一覧表示します:

Terminal window
aggrega skills list

インストールコマンドでも、バイナリのインストール時にスキルを追加できます。そのオプションはインストール時にアシスタントスキルを追加するで説明しています。この方法でインストールしたスキルにはサーバーへの接続が含まれないため、MCP サーバーの接続の説明に従ってアシスタントをサーバーに接続してください。

スキルがアシスタントに伝える内容

スキルはアシスタントに、Aggrega のインストール方法、aggrega mcp サーバーへの接続方法、ワークスペースの始め方、そしてAggrega ファイルのオーサリングで説明しているオーサリングのループ(scaffold、validate、build)の進め方を伝えます。スキーマやエンティティコントラクトのコピーは一切含みません。構造に関する回答はすべてバイナリから得るよう(サーバーが接続されていれば MCP ツール、そうでなければ aggrega コマンドライン)、物事の意味については公開されているドキュメントを参照するよう、アシスタントに指示します。

スキルと MCP サーバーは異なる役割を担い、アシスタントは両方があるときに最もよく機能します。スキルはアシスタントが読む指示であり、サーバー(プラグインによって、または MCP サーバーの接続の手順で接続します)はアシスタントが呼び出すツールです。プラグインをインストールせず、--agent の一覧にもないアシスタントはスキルを利用しませんが、サーバーを通じて同じツールとリファレンス資料に到達できます。

インストール先

プラグインは、アシスタントがプラグインを保管するフォルダーにスキルを保管します。aggrega skills install は別の場所に書き込みます。--global を指定しない場合は、ワークスペースのルートにあるアシスタントのプロジェクト用スキルフォルダーに書き込みます。プロジェクトのスキルはそこにコミットされます。--global を指定すると、ホームディレクトリにあるアシスタントのユーザーごとのスキルフォルダーに書き込み、アシスタントはすべてのプロジェクトでそれを読み込みます。--global を指定し --agent を指定しない場合、コマンドはマシン上のアシスタントを探し、見つかった各アシスタントとそれを見つけた手がかりを表示し、ターミナルでは書き込む前に確認します。各アシスタントのフォルダー、各アシスタントを見つける手がかり、コマンドが上書きを拒否するものについては aggrega skills を参照してください。

スキルを最新に保つ

プラグインに付属していたスキルは、アシスタントが自身のプラグインを更新する方法で、プラグインとともに更新されます。Cursor のローカルフォルダーにクローンしたプラグインは、そのフォルダーで git pull を実行し、続いて Developer: Reload Window を実行して更新します。プラグインは PATH 上の aggrega バイナリが実行するサーバーに接続するため、ツールとリファレンス資料はインストールしたバイナリに従います。

スキルは aggrega バイナリにも組み込まれているため、aggrega skills install が書き込むコピーはインストール済みのバージョンと一致します。Aggrega をアップグレードした後(インストーラーのコマンドはバイナリをその場で更新します)、同じ aggrega skills install コマンドをもう一度実行して、そのコピーを新しいバージョンに更新してください。