fusion-discover-skills

发现 Fusion Skills（已弃用）

**已弃用：**此技能已由 fusion-skills 取代。 请改用 fusion-skills 的 discover 模式。此技能的所有功能都可在那里使用。 安装：npx -y skills add equinor/fusion-skills fusion-skills

何时使用

当用户需要查找适合某项任务的 Fusion 技能，或需要 MCP 支持的安装、更新或移除技能指导时，请使用此技能。

常见触发语：

• “帮我找一个适合这个的技能”
• “我应该使用哪个 Fusion 技能？”
• “有没有用于编写 GitHub issue 的技能？”
• “如何安装合适的 Fusion 技能？”
• “如何更新或移除已安装的 Fusion 技能？”
• “这个工作流有哪些可用技能？”

何时不使用

以下情况请勿使用此技能：

• 在代码仓库中创建或编辑技能
• 直接执行底层任务，而不是帮助用户查找技能
• 在无法获取发现数据时猜测匹配的技能
• 未经用户请求自动安装、更新或移除技能

必需输入

回复前收集：

• 用户用自己的话表达的目标或查询
• 预期操作：query、install、update 或 remove
• 用户正在寻找的技能类型：领域、工作流或期望结果
• 需要提供安装指导且尚不明确时，当前 Agent/客户端的名称
• 会实质性影响建议的任何约束，例如目标运行环境或代码仓库背景

如果缺少关键信息，只询问解决意图所需的最少问题。 对于用户对所需技能或工作流的模糊请求，请使用 references/follow-up-questions.md。

说明

如果有可用的子 Agent，请针对具体发现情景使用随附的顾问 Agent：

• Fusion MCP 可用时使用 agents/fusion-mcp-advisor.md——这是主要发现路径
• Fusion MCP 不可用，但 GitHub MCP 搜索可用时使用 agents/github-mcp-advisor.md
• 作为最后的备用方案，使用 agents/github-raw-search-advisor.md，通过只读 CLI 和 GraphQL 检查进行搜索

如果运行环境不支持随附的 Agent，请按照下文所述，以相同的工作流直接执行。

主要工作流：

1. 判断用户的意图。
   • 将宽泛的“哪个技能适合这个？”请求视为 query。
   • 将“安装/添加”“更新/检查更新”和“移除/卸载”请求视为明确的生命周期意图。
   • 如果请求同时涉及发现和生命周期步骤，优先进行发现，然后提供与选定技能相应的生命周期指导。
2. 当目标技能仍不明确时，提出后续问题。
   • 如果请求含糊不清，就针对用户希望获得帮助的任务、领域或工作流，提出一个简短的澄清问题。
   • 优先提出能快速缩小搜索范围的问题：用户想做什么、是想发现、安装、更新还是移除技能，以及是否已经知道可能相关的领域，例如 GitHub 工作流、MCP 配置或技能编写。
   • 默认使用 references/follow-up-questions.md 作为问题库。
3. 仅在必要时询问缺失的 Agent 上下文。
   • 如果用户需要安装指导，但当前使用的 Agent 不明确，则询问命令应针对哪个 Agent/客户端。
   • 对于单纯的发现请求，不要询问 Agent 详情。
4. 如有 Fusion MCP，优先查询。
   • 为了基于来源发现有哪些技能及其用途，请使用用户的原话调用 mcp_fusion_search_skills。此工具会对本地技能索引进行语义搜索。
   • 如果 mcp_fusion_search_skills 的结果较弱或含糊，则使用 mcp_fusion_skills 跟进；它能够推断意图、消解含糊的名称，并提供更丰富的建议上下文。
   • 对于生命周期操作（安装、更新、移除），调用 mcp_fusion_skills 并明确设置 intent。
   • 默认情况下，当意图含糊时，让 mcp_fusion_skills 自动检测意图。
   • 对于安装意图，如果已知 Agent，则传入 agent，以便直接提供可用的建议命令。
   • 从少量排序结果开始，通常列出排名前 3 到 5 个。
5. 当 Fusion MCP 不可用或效果不佳时，回退到基于 GitHub 的发现方式。
   • 如果当前客户端提供 GitHub MCP 仓库或搜索工具，优先使用它们。
   • 否则，仅对可信来源进行只读的 Shell 检查，例如 npx skills add --list <source>、本地 skills/**/SKILL.md 搜索、gh search code 或针对目录仓库的 gh api graphql。
   • 只有在需要结构化仓库数据，且更高级的 MCP 或搜索工具无法清晰提供这些数据时，才使用 GraphQL。
   • GraphQL 只读查询至少消耗 1 点；将 first/last 设为较小的值（≤ 30），并避免嵌套连接，以尽量降低点数消耗。遇到速率限制错误时不要重试；说明失败情况并建议稍后重试。
   • 注意预算：一次典型的技能发现会话最多应需要 2–3 次 GitHub API 调用（一次搜索，加一到两次内容读取）。如果首次搜索结果较弱，只进行一次细化搜索，然后停止；不要循环搜索。
   • 除非 Fusion MCP 返回了明确的建议命令，否则将基于 GitHub 的生命周期指导视为备用指导。
   • 绝不要使用远程脚本执行模式，也不要使用会执行获取内容的 Shell 管道。
6. 首次结果集较弱时，进行一次细化搜索。
   • 使用用户请求中更明确的领域关键词重新表述查询。
   • 只进行一次细化搜索；不要无限期地继续搜索。
7. 返回可执行的结果。
   • 对每个推荐技能，请包含：
     • 技能名称
     • 一句话用途说明
     • 它与用户任务相符的原因
     • 下一步最佳操作
   • 当 MCP 返回生命周期指导时，原样转达建议命令或说明，包括仍需用户填写的任何占位符。
   • 如果使用了备用发现方式，请明确标注来源为 GitHub MCP、Shell 列表、代码搜索或 GraphQL 得出的指导。
   • 选定技能后，提供足够的使用指导，让用户无需再进行一轮发现即可继续操作。
8. 明确处理低置信度或未匹配的结果。
   • 说明未找到高度匹配的结果，或指出推荐结果尚不确定。
   • 如果有近似匹配项，将其作为暂定建议列出。
   • 建议下一步最佳操作：扩大查询范围、不使用技能继续操作，或记录这一缺口以便今后编写技能。
9. 将回复范围限定在发现上。
   • 除非用户明确要求执行，否则不要安装、更新或移除任何内容。
   • 如果 Fusion MCP 不可用，请明确说明，并指出实际使用的 GitHub 备用方式；不要编造目录结果。

示例

• 用户：“查找用于编写 GitHub 问题的 Fusion 技能。”
  • 结果：返回 fusion-issue-authoring，说明它会根据问题类型路由到相应技能，并附上 MCP 返回的安装指南或后续步骤。
• 用户：“如何更新我已安装的 Fusion 技能？”
  • 结果：调用 mcp_fusion_skills，设置 intent: update，并返回 MCP 提供的建议更新命令或说明。
• 用户：“有没有适用于这个冷门工作流的技能？”
  • 结果：如果 Fusion MCP 不可用或返回的匹配度较低，则使用由 GitHub 支持的备用发现方式，说明匹配结果是否只是暂定的，并建议下一步最佳操作。

预期输出

返回：

• 检测到的意图（query、install、update 或 remove）
• 用于提供建议的信息源（mcp_fusion_skills、GitHub MCP、shell 列表、代码搜索或 GraphQL 备用方案）
• 可用时，按排名列出的技能建议
• 对每个推荐技能的简要说明
• 所选结果的后续步骤指南
• MCP 提供建议命令时，提供建议的安装／更新／移除命令
• 若没有高度匹配的结果，明确说明不确定性，并给出备用的后续操作

Agent

针对特定发现情形的辅助 Agent（有子 Agent 可用时）：

• agents/fusion-mcp-advisor.md — Fusion MCP 可用时使用
• agents/github-mcp-advisor.md — Fusion MCP 不可用但 GitHub MCP 可用时使用
• agents/github-raw-search-advisor.md — 使用只读 CLI／GraphQL 作为最终备用方案

参考资料

• references/follow-up-questions.md — 用于澄清模糊请求的问题

安全与限制

切勿：

• 编造技能名称、可用性或安装／更新／移除命令
• 将低置信度的匹配结果说成确定结果
• 在备用发现过程中使用远程脚本执行模式或不安全的 shell 管道
• 除非用户明确要求执行下一步，否则不要更改用户的环境

始终：

• 优先使用 Fusion MCP，其次是 GitHub MCP，最后使用只读 shell 或 GraphQL 备用方案
• 保持建议简洁且聚焦任务
• MCP 返回建议命令时，原样保留命令文本
• 若建议来自 GitHub 备用方案而非 MCP，明确标注
• 证据较弱时，坦率说明不确定性