fusion-skills について
Fusion Skillsは、スキルの検索、ライフサイクル管理、作成、品質確認の依頼を専用エージェントに振り分けます。該当するエージェントのファイルだけを読み込み、MCPツールでスキルを検索・管理します。
主な機能
- 01依頼を専門のスキルエージェントに振り分け
- 02タスクや説明からスキルを検索
- 03インストール済みスキルの一覧表示
- 04スキルの追加、更新、削除に関する案内
- 05スキルの作成やレビュー
活用シーン
- 01タスクに合うスキルや導入済みスキルを探す
- 02インストール済みスキルを確認・更新
- 03スキルを作成、または報告された品質問題を調査
MCP 対応
mcp_fusion_skills MCPツールを使い、スキルの意味検索、インベントリ確認、ライフサイクル操作を行います。ライフサイクル操作では管理用のコマンドを案内します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ equinor/ fusion-skills --skill fusion-skillsインストール後、Claude Code で/fusion-skillsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/author.agent.mddiscovery.agent.mdgreenkeeper.agent.mdwarden.agent.mdassets/issue-templates/skill-workflow-failure-bug.mdassets/workflows/skills-sync.yml.mdreferences/follow-up-questions.mdskill-catalog.mdsync-workflows.md詳細
Fusion Skills
スキルのライフサイクルのエントリーポイントです。意図を特定し、適切なエージェントに引き継ぎます。
読み込み動作
ルーティングされたエージェントファイルのみを読み込みます。参照ファイルは、必要になったときにエージェントがオンデマンドで読み込みます(例:MCP の失敗時にのみ skill-catalog.md、セットアップモード時にのみ sync-workflows.md)。すべてのエージェントや参照ファイルを事前に読み込まないでください。
MCP ツール
このスキルでは、スキルの検出とライフサイクル操作の両方を処理する Fusion MCP ツール mcp_fusion_skills を使用します。
- 検出(
intent: query):説明やタスクを使って、スキルインデックスをセマンティック検索します。 - インベントリ(
intent: inventory):インストール済みのスキルを一覧表示します。 - ライフサイクル(
intent: install | update | remove):スキル管理のための助言コマンドです。
ルーティング
| 意図 | エージェント |
|---|---|
| 適切なスキルを検索または検出する;インストール済みのスキルを一覧表示する | agents/discovery.agent.md |
| スキルをインストール、更新、削除、確認する;自動化をセットアップする | agents/greenkeeper.agent.md |
| スキルを作成、執筆、改善する | agents/author.agent.md |
| スキルの品質上の問題を調査する、またはスキルの失敗を報告する | agents/warden.agent.md |
fusion メインゲートから、意図が部分的に解決された状態(例:「skills」)でここにルーティングされた場合は、最上位の質問を再度尋ねず、最も可能性の高いエージェントに直接進んでください。
意図が本当に不明確で、まだ確認の質問をされていない場合は、次の質問を 1 つだけ尋ねてください:「スキルを探していますか、インストールまたは更新しますか、自分で作成しますか、それとも問題を報告しますか?」
複合的な意図: リクエストが複数のエージェントにまたがる場合(例:「このスキルを調査して問題を修正する」)、エージェントを順番に実行してください。最初のエージェントの出力を、2 番目のエージェントにコンテキストとして渡してください。
ループの防止: fusion メインゲートから起動された場合は、fusion に戻さないでください。担当エージェント内で対応するか、対象外であることを伝えてください。
対象外: GitHub のイシューの解決、PR のレビュー、タスク分割の計画、GitHub イシューの作成。ユーザーを関連するインストール済みスキルまたは fusion メインゲートに案内してください。ただし、そこから起動された場合は fusion に戻さないでください。
非推奨スキルからの移行
fusion-discover-skills または fusion-skill-self-report-bug がこのスキルと併せてインストールされている場合は、ユーザーに次のように伝えてください。
"非推奨のスキルがインストールされています。この機能は現在
fusion-skillsに含まれています。apm.ymlからその依存関係を削除し、apm pruneを実行してロックファイルとデプロイ済みファイルを整合させてください。"
安全性
- シークレットや認証情報を扱わないでください。
- 確認なしに GitHub を変更しないでください。
- リモートスクリプトを実行しないでください。
- スキル名やカタログの検索結果を捏造しないでください。
- インストール済みのスキルファイルはコピーです(依存関係の由来とデプロイ済みファイルの所有権を調べるには
apm.ymlとapm.lock.yamlを使用してください)。直接その場で編集せず、内容の修正はagents/author.agent.md(ソースリポジトリのfusion-skill-authoringに転送します)に、失敗の報告はagents/warden.agent.md(報告モード)にルーティングしてください。