• 简体中文

      • Skills

      Module Federation 现在对外提供一个统一的 mf skill。

      你不需要在很多 skill 之间自己挑，也不需要先把文档看完再转述给 Agent。更直接的方式是安装这一个 skill，然后让 Agent 自己判断现在该走“读文档”、“看配置”还是“排查问题”。

      当问题只在页面运行现场暴露时，skill 使用 Divebell MF Extension 获取 Remote、Shared、Bridge 和模块性能的结构化证据。浏览器只是进入现场和触发 加载路径的入口。Divebell 安装在 Agent 所在机器，不会加入应用依赖。

      如果你还没看过，建议先从 AI 快速开始 开始。

      安装

      npx skills add module-federation/agent-skills --skill mf -y

      安装后，主入口就是：

      /mf <子命令或问题>

      如果无法使用命令行安装，也可以直接从 GitHub 手动复制目录：

      https://github.com/module-federation/agent-skills/tree/main/skills/mf

      这个 skill 是怎么用的

      mf 只有一个入口，但里面包含多个能力。你可以显式写子命令，也可以直接用自然语言提问。

      显式写子命令：

      /mf docs 如何在 Modern.js 里使用 Module Federation？
/mf integrate
/mf type-check
/mf runtime-error RUNTIME-008
/mf observability 帮我接入观测插件，记录 MF 加载过程

      直接写自然语言：

      /mf shared 里的 singleton 和 requiredVersion 有什么区别？
/mf 帮我看看这个项目为什么 remote types 没拉下来
/mf ���我把 Module Federation 接到当前项目里
/mf 我想让 AI 能看见 MF remote 和 shared 的加载状态，应该怎么接
/mf 我看到 Module Federation console error，traceId 是 mf-...

      mf 目前支持什么

      子命令适合做什么
      docs先读最新文档，再回答配置、API、概念问题
      context快速查看当前项目的 MF 配置情况
      module-info查看远端模块的地址、暴露内容和相关信息
      integrate把 Module Federation 接入已有项目
      type-check排查类型相关问题
      shared-deps排查共享依赖冲突和重复打包
      perf排查本地开发慢、HMR 慢的问题
      config-check排查配置错误、暴露路径错误、插件不匹配
      bridge-check排查 Bridge 接入问题
      runtime-error排查明确的运行时报错码，尤其是 RUNTIME-001 / RUNTIME-008
      observability通过 Divebell 定位 MF 运行时错误、加载链路和性能瓶颈，或读取观测报告

      最常用的几类场景

      1. 先读文档再回答

      这是最常见的用法，也是最推荐的起点：

      /mf docs shared 里的 singleton 和 requiredVersion 有什么区别？

      这样 Agent 会先去读最新文档，再回来回答你，而不是靠过时记忆硬猜。

      2. 让 Agent 直接接入

      如果你想把 Module Federation 接进现有项目：

      /mf integrate

      它会自动看你当前项目的构建器和配置，再决定下一步怎么做。

      3. 让 Agent 直接排查

      如果你已经遇到具体问题：

      /mf type-check
/mf shared-deps
/mf config-check
/mf runtime-error RUNTIME-008
/mf observability

      这时候重点不是你自己查，而是让 Agent 直接开始定位。

      4. 让 Agent 调试真实 MF 页面

      一次性排查不需要先改应用。把页面地址和用户路径直接交给 skill：

      /mf observability
请用 Divebell 打开 https://example.com，复现结算失败流程，
并检查 Remote 和 Shared 加载链路。

      skill 会发现已安装的 Divebell CLI 与 MF Extension Skill，使用 divebell open <url> --mf 在导航前开启诊断，并选择最小的 divebell mf 专项命令。页面操作仅用于触发相关懒加载，结论应以结构化的 Remote、Shared、Bridge 或模块性能证据为准。

      安装命令、命令选择、Remote 代理和证据边界请查看 排查运行时问题。

      5. 让 Agent 分析长期保留的观测报告

      如果报告需要持续采集、生产上报或由 Node/SSR 写入文件，再接入 观测插件。浏览器控制台打印 traceId 和 read: 命令后，把仍可访问的报告来源交给 skill：

      /mf observability
我看到了这条 Module Federation console error：

[Module Federation] Observability report generated
traceId: mf-...
read: window.__FEDERATION__.__OBSERVABILITY__["runtime_host"].getReport("mf-...")

请读取报告并帮我修复问题。

      这里的“报告”不是让你手动整理出来的长日志，而是观测插件生成的结构化 结果。浏览器里通常通过控制台里的 read: 命令读取；Node、SSR 或��产 环境上报场景，可以让 Agent 读取文件或你们自己上报系统里的报告：

      /mf observability
请读取 .mf/observability/latest.json，告诉我可能是谁的问题，以及应该怎么修。

      你真正需要记住的只有一件事

      不是你自己先读文档、再告诉 Agent 该怎么办。

      而是直接把 mf 装上，然后让 Agent 先读、先看、先判断、先动手。