关于 Jam
Jam skills 为编码 Agent 提供读取屏幕录制、定位问题、验证修复和生成端到端测试的能力。它结合 Jam 录制中的日志、网络请求、操作步骤与画面,为问题分析提供证据。
主要功能
- 01读取录制、日志和操作步骤
- 02根据证据分析问题根因
- 03录制修复效果并生成链接
- 04为截图添加问题标注
- 05从录制生成端到端测试
适用场景
- 01分析 Jam 录制中的错误
- 02为 Pull Request 提供修复演示
- 03标注截图中的问题位置
- 04把用户流程转成回归测试
MCP 相关
jam-fix 和 jam-to-e2e 可通过 Jam MCP 服务或 Jam CLI 读取录制;插件还会连接 Jam MCP 服务。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.jam.dev/mcpclaude mcp add --transport http jam https://mcp.jam.dev/mcp{"mcpServers":{"jam":{"type":"http","url":"https://mcp.jam.dev/mcp"}}}在 Cursor 中打开{"servers":{"jam":{"type":"http","url":"https://mcp.jam.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"jam":{"type":"http","url":"https://mcp.jam.dev/mcp"}}}{"mcpServers":{"jam":{"serverUrl":"https://mcp.jam.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Jam 技能
让编码 Agent 展示工作过程的技能:阅读 Jam、证明更改有效、指出问题、测试流程。
npx skills add jamdotdev/skills
兼容 Claude Code、Cursor、Codex、GitHub Copilot、Gemini CLI、OpenCode,以及 skills.sh 支持的所有 Agent。添加 --skill jam-fix 即可安装某个技能。
Jam 是一段屏幕录制,附带控制台日志、网络请求和用户操作,并通过一个链接分享。它可以是错误报告、演示,也可以是流程演示。这些技能教会 Agent 阅读和制作 Jam。
技能
- jam-fix:“修复这个 jam.dev 链接。”读取录制中的控制台错误、失败请求、用户步骤、帧和转录内容,然后根据证据写出根本原因。只有在你提出要求时才会更改代码。
- jam-proof:“录制一个 Jam 来展示它正常工作。”录制更改正常运行的过程,并提供用于拉取请求的 Jam 链接,附带控制台和网络信息。默认使用无头 Chrome:录制的是页面,而不是你的屏幕。
- jam-annotate:“标出故障并提交问题。”将截图转换为 Jam,指出问题所在:包含方框、箭头、注释、涂黑和模糊处理,并正确计算视网膜屏幕缩放比例。
- jam-to-e2e:“为这个 Jam 编写端到端测试。”将 Jam 转换为使用你自己的测试运行器和语言编写的测试,并提供针对 Playwright 和 tester-army/e2e 的一流指导。流程的 Jam 会变成一个守护该流程的测试。错误的 Jam 会变成一个失败测试,让修复有机会让测试通过。
要求
每项技能都需要一个免费的 Jam 账户。jam-fix 和 jam-to-e2e 通过 Jam MCP 服务或 Jam CLI 读取 Jam;jam-proof 和 jam-annotate 会创建 Jam,因此需要 CLI。请从 jam.dev/cli 安装 CLI;技能会在需要时登录。在 CI 或云端 Agent 中,将 JAM_TOKEN 设置为个人访问令牌。jam-proof 中的窗口和显示器录制需要 macOS 或 Linux(X11);其默认的无头浏览器录制只需要 Chrome。
安装为插件
该插件会安装所有技能、连接 Jam MCP 服务 并自动更新。请使用该插件或 npx skills add,不要同时使用,否则 Agent 会看到重复的技能。
Claude Code
/plugin marketplace add jamdotdev/skills
/plugin install jam@jam-plugins
技能会以 /jam:jam-fix、/jam:jam-proof 等形式加载。要测试检出版本,请运行 claude --plugin-dir /path/to/skills。
Cursor
在侧边栏中打开 Customize,搜索 Jam,然后点击 Install。
要测试检出版本,请将其链接到本地插件文件夹,然后运行 Developer: Reload Window:
ln -s /path/to/skills ~/.cursor/plugins/local/jam
Codex
codex plugin marketplace add jamdotdev/skills
codex plugin add jam@jam-plugins
启动新会话,完成 OAuth 提示,然后运行 /mcp 检查连接。要测试检出版本,请将其路径传递给 marketplace add。
GitHub Copilot CLI
copilot plugin marketplace add jamdotdev/skills
copilot plugin install jam@jam-plugins
Gemini CLI
gemini extensions install https://github.com/jamdotdev/skills
运行一次 /mcp auth Jam 以登录。要测试检出版本,请运行 gemini extensions link /path/to/skills。
关于登录、令牌、MCP 服务的功能和权限,请参阅:docs/plugin.md。
参与贡献
发现技能中的错误,或有想要的技能?提交问题。欢迎提交拉取请求;CONTRIBUTING.md 内容简短。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。