mcpField
F
fusion-research

fusion-research

github.com/equinor开发1.4k 次安装
代码仓库

关于 fusion-research

fusion-research 是用于解答 Fusion 生态问题的技能,要求答案有来源依据。它将研究分派到框架、EDS、技能、平台文档和后端代码等领域,不负责实现或 MCP 安装。

主要功能

  1. 01将问题分派到五个研究领域
  2. 02提供领域专用研究 Agent
  3. 03要求记录来源路径和依据摘录
  4. 04区分研究、实现与 MCP 安装

适用场景

  1. 01查询 EDS 组件的属性或用法
  2. 02查找 Fusion hook 或 package 的资料
  3. 03研究平台入门或治理指南

MCP 相关

研究 Agent 使用 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 Hook,并给我展示支持它的来源。”
  • “这个 EDS 组件接受哪些属性?”
  • “Fusion 工作流中由哪个技能处理 X?”
  • “找一个有来源支持的示例,用于……”
  • “哪个 Fusion 包或模块负责此 API?”
  • “EDS 中有适用于此值的设计令牌吗?”
  • “如何在 Fusion 应用中持久化用户偏好设置?”
  • “在 Fusion 中,X 的推荐模式是什么?”
  • “给我展示一个用于构建 X 的 Fusion Framework 示例。”
  • “EDS 中有哪些颜色和间距设计令牌?”
  • “Fusion 在平台层面如何处理 X?”
  • “Fusion 平台关于 Y 的指导是什么?”
  • “如何开始使用 Fusion?”
  • “Fusion 平台对 Z 有哪些指导原则?”

不适用场景

以下情况不要使用此技能:

  • 实现代码更改——使用 fusion-app-react-dev 或相关开发技能;如果研究针对的是你正在构建的特定应用,请先使用 fusion-app-react-dev,它会在需要时调用此技能
  • 查找、安装、更新或移除技能——使用 fusion-discover-skills;仅使用此技能了解某项技能的范围、关系或目录归属,不要用它来查找要安装的技能
  • 创建或编辑技能文件——使用 fusion-skill-authoring 进行编写阶段的研究
  • 安装或排查 Fusion MCP 问题——使用 fusion-mcp;MCP 运行后,再回到此处进行研究
  • 纯粹的 Fusion 概念性问题,且未提及具体工件名称(Hook、组件、包、令牌或平台主题)——先请用户提供具体的工件引用或平台主题

说明

步骤 0 — 明确范围(可选)

在分类前,你可以使用特定领域的后续问题,进一步明确用户的具体需求:

如果问题中已指定具体工件(Hook、组件、包、令牌或技能),则跳过此步骤。

步骤 1 — 对研究问题进行分类

确定问题所属的领域:

领域关键词Agent
FrameworkFusion Framework Hook、包、模块、TypeScript API、操作手册示例agents/framework.agent.md
EDSEDS 组件属性、用法示例、无障碍设计、设计令牌agents/eds.agent.md
Skills技能目录查询、范围边界、配套技能/编排器关系agents/skills.agent.md
DocsFusion 平台概念、入门、平台运维、治理、非实现类指导agents/docs.agent.md
Backend CodeC# 服务实现、接口、CQRS 模式、授权、验证、跨服务 APIagents/backend-code.agent.md

如果问题涉及多个领域,则依次使用相应的 Agent,分别回答各领域的问题。

步骤 2 — 分派给正确的 Agent

如果运行时支持技能本地 Agent,请直接调用该 Agent;否则,将该 Agent 的说明应用于当前流程。

步骤 3 — 返回有来源支持的答案

使用 assets/source-backed-answer-template.md 中的结构:

  • 说明使用了哪个领域和 Agent。
  • 列出 1 到 3 条有来源支持的证据。
  • 最后说明任何尚存的假设、不确定性或下一步验证步骤。

研究 Agent

此技能在 agents/ 中包含五个研究 Agent。每个 Agent 都覆盖一个 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 不可用或结果薄弱时声称存在证据
  • 无限期地反复完善——每个 Agent 经过一轮完善后仍不确定时,应明确说明
  • 在研究流程中实现代码更改或修改代码库

始终:

  • 在选择 Agent 前对问题进行分类
  • 在最终确定任何主张前,记录来源路径和支持性摘录
  • 明确说明答案的每个部分由哪个 Agent 和来源支持

评论

支持 Markdown