mcpField
F
fusion-research

fusion-research

github.com/equinor開発1.4k 回インストール
リポジトリ

fusion-research について

fusion-research は、Fusion エコシステムについて出典に基づく回答を作成するスキルです。フレームワーク、EDS、スキル、プラットフォーム文書、バックエンドコードの各領域に調査を振り分け、実装や MCP のセットアップは対象外です。

主な機能

  1. 015つの調査領域へ質問を振り分け
  2. 02領域別の調査エージェントを提供
  3. 03出典パスと根拠の抜粋を必須化
  4. 04調査と実装・MCP セットアップを分離

活用シーン

  1. 01EDS コンポーネントのプロパティや使い方を確認
  2. 02Fusion の hook や package の資料を検索
  3. 03プラットフォームのオンボーディングやガバナンスを調査

MCP 対応

調査エージェントは Fusion MCP の検索ツールを使い、フレームワーク、EDS、スキル、文書、バックエンドコードを検索します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/equinor/fusion-skills --skill fusion-research

インストール後、Claude Code で/fusion-researchを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CHANGELOG.md
agents/
backend-code.agent.md
docs.agent.md
eds.agent.md
framework.agent.md
skills.agent.md
assets/
docs.follow-up.md
eds.follow-up.md
framework.follow-up.md
skills.follow-up.md
source-backed-answer-template.md
references/
backend-code.query.md
docs.query.md
eds.query.md
framework.query.md
skills.query.md

詳細

Fusion Research

使用する場面

Fusion エコシステムについて、ソースに裏付けられた回答が必要な場合に、このスキルを使用してください。

よくあるきっかけ:

  • 「この Fusion Framework のフックについて調べて、裏付けとなるソースを示してください。」
  • 「この EDS コンポーネントが受け取る props は何ですか?」
  • 「Fusion のワークフローで X を扱うスキルはどれですか?」
  • 「…のソースに裏付けられた例を探してください。」
  • 「この API を所有する Fusion のパッケージまたはモジュールはどれですか?」
  • 「この値に対応する EDS デザイントークンはありますか?」
  • 「Fusion アプリでユーザー設定を保持するにはどうすればよいですか?」
  • 「Fusion で X を実現する推奨パターンは何ですか?」
  • 「X を構築する Fusion Framework の例を示してください。」
  • 「EDS の色と間隔に関するデザイントークンは何ですか?」
  • 「Fusion はプラットフォームレベルで X をどのように扱いますか?」
  • 「Y に関する Fusion プラットフォームのガイダンスは何ですか?」
  • 「Fusion のオンボーディング方法を教えてください。」
  • 「Fusion プラットフォームにおける Z のガイドラインは何ですか?」

使用しない場面

次の用途には、このスキルを使用しないでください。

  • コードの変更を実装する場合 — fusion-app-react-dev または該当する開発スキルを使用してください。現在開発中の特定のアプリに関する調査の場合は、まず fusion-app-react-dev を使用してください。必要に応じて、このスキルが呼び出されます
  • スキルの検索、インストール、更新、削除を行う場合 — fusion-discover-skills を使用してください。このスキルは、スキルの範囲、関連性、カタログ内での適合性を理解する場合にのみ使用してください。インストールするスキルの検索には使用しないでください
  • スキルファイルを作成または編集する場合 — 作成時の調査には fusion-skill-authoring を使用してください
  • Fusion MCP のインストールまたはトラブルシューティングを行う場合 — fusion-mcp を使用してください。MCP の起動後に、調査のためにこのスキルへ戻ってください
  • 具体的なアーティファクト名(フック、コンポーネント、パッケージ、トークン)やプラットフォームのトピックを指定しない、純粋に概念的な Fusion に関する質問 — まず、具体的なアーティファクトの参照またはプラットフォームのトピックをユーザーに尋ねてください

手順

ステップ 0 — 範囲を明確にする(任意)

分類する前に、ドメイン固有の追加質問を使って、ユーザーの正確なニーズを絞り込んでもかまいません。

質問で具体的なアーティファクト(フック、コンポーネント、パッケージ、トークン、スキル)がすでに指定されている場合は、このステップを省略してください。

ステップ 1 — 調査の質問を分類する

質問がどのドメインに属するかを判断します。

ドメイン指標エージェント
FrameworkFusion Framework のフック、パッケージ、モジュール、TypeScript API、クックブックの例agents/framework.agent.md
EDSEDS コンポーネントの props、使用例、アクセシビリティ、デザイントークンagents/eds.agent.md
Skillsスキルカタログの検索、範囲の境界、関連スキル/オーケストレーターとの関係agents/skills.agent.md
DocsFusion プラットフォームの概念、オンボーディング、プラットフォーム運用、ガバナンス、実装以外のガイダンスagents/docs.agent.md
Backend CodeC# サービスの実装、インターフェース、CQRS パターン、認可、検証、サービス間 APIagents/backend-code.agent.md

複数のドメインにまたがる質問には、適切なエージェントを順に使用し、各ドメインについて個別に回答してください。

ステップ 2 — 適切なエージェントに依頼する

ランタイムがスキル内のエージェントに対応している場合は、エージェントを直接呼び出してください。それ以外の場合は、エージェントの指示をインラインで適用してください。

ステップ 3 — ソースに基づく回答を返す

assets/source-backed-answer-template.md の構成を使用します。

  • 使用したドメインとエージェントを明記します。
  • ソースに基づく根拠を 1 ~ 3 件記載します。
  • 最後に、残っている前提や不確実性、または次の確認手順を記載します。

リサーチエージェント

このスキルには、agents/ に 5 つのリサーチエージェントが含まれています。それぞれが Fusion のリサーチ領域を担当し、独自のクエリパターンと根拠チェックリストを備えています。

  • agents/framework.agent.md — Fusion Framework のフック、パッケージ、モジュール、クックブックの例に関する、ソースに基づく回答を提供します。mcp_fusion_search_framework を使用します。
  • agents/eds.agent.md — EDS コンポーネントのプロパティ、使用方法、アクセシビリティ、デザイントークンに関する、ソースに基づく回答を提供します。mcp_fusion_search_eds を使用します。
  • agents/skills.agent.md — Fusion スキルカタログ(存在するスキル、その対象範囲、相互の関係)に関する、ソースに基づく回答を提供します。mcp_fusion_search_skills を使用します。
  • agents/docs.agent.md — Fusion プラットフォームの概念、オンボーディング、運用、ガバナンスに関する、ソースに基づく回答を提供します。mcp_fusion_search_docs を使用します。
  • agents/backend-code.agent.md — Fusion バックエンドサービスの実装(C# サービス、インターフェース、CQRS パターン、認可、サービス間連携)に関する、ソースに基づく回答を提供します。mcp_fusion_search_backend_code を使用します。

アセット

安全性と制約

次のことは決して行わないでください。

  • Fusion Framework のフック、EDS のプロパティ、スキルカタログの項目を捏造する
  • MCP が利用できない場合や検索結果が不十分な場合に、根拠があると主張する
  • 改善を延々と続ける — エージェントごとに 1 回改善した後も不確実性が残る場合は、その旨を明記する
  • リサーチの過程でコードを変更したり、リポジトリに変更を加えたりする

必ず次のことを行ってください。

  • エージェントを選ぶ前に質問を分類する
  • 主張を確定する前に、ソースのパスと裏付けとなる抜粋を記録する
  • 回答の各部分について、どのエージェントとソースが根拠となったかを明記する

コメント