关于 fusion-skills
Fusion Skills 将技能相关请求路由给专门 Agent,处理发现、生命周期管理、编写和质量审查。它只加载对应的 Agent 文件,并通过 MCP 工具搜索和管理技能。
主要功能
- 01将请求路由到专门的技能 Agent
- 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
技能生命周期入口点。解析意图,并调用合适的 Agent。
加载行为
仅加载路由到的 Agent 文件。Agent 需要时会按需加载参考资料(例如,只有 MCP 失败时才加载 skill-catalog.md,只有设置模式下才加载 sync-workflows.md)。不要预加载所有 Agent 或所有参考资料。
MCP 工具
此技能使用 mcp_fusion_skills——用于处理技能发现和生命周期操作的 Fusion MCP 工具:
- 发现(
intent: query):按描述或任务对技能索引进行语义搜索。 - 清单(
intent: inventory):列出已安装的技能。 - 生命周期(
intent: install | update | remove):提供管理技能的建议命令。
路由
| 意图 | Agent |
|---|---|
| 查找或发现合适的技能;列出已安装的技能 | agents/discovery.agent.md |
| 安装、更新、移除或检查技能;设置自动化 | agents/greenkeeper.agent.md |
| 创建、编写或改进技能 | agents/author.agent.md |
| 检查技能的质量问题,或报告技能故障 | agents/warden.agent.md |
如果用户是从 fusion 主入口带着部分已解析的意图(例如“skills”)路由到此处,请直接交由最可能的 Agent 处理,不要再次询问顶层问题。
如果意图确实不明确,且此前尚未向用户提出澄清问题,请询问一个问题:“您是想查找技能、安装或更新技能、创建自己的技能,还是报告技能问题?”
复合意图: 如果请求涉及多个 Agent(例如“检查此技能并修复问题”),请依次运行 Agent。将第一个 Agent 的输出作为上下文传递给第二个 Agent。
防止循环: 如果您是从 fusion 主入口激活的,请勿将用户重定向回 fusion。请在您的 Agent 中处理请求,或说明该请求不在支持范围内。
不支持的范围: 解决 GitHub issue、审核 PR、规划任务拆解或编写 GitHub issue。请将用户引导至相关的已安装技能或 fusion 主入口;但如果您是从 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处理(该 Agent 会重定向至源代码库fusion-skill-authoring),故障应交由agents/warden.agent.md处理(报告模式)。