shotfleet

shotfleet 技能

此仓库包含 shotfleet 的 Agent 技能和 MCP 服务配置。shotfleet 是一款 macOS 命令行工具，可通过一个英文 Maestro 流程（或你自己的 XCUITest 截图测试，自 0.1.6 起支持）为应用支持的每种语言采集 App Store 和 Google Play 截图，并检查每张截图是否确实使用了正确的语言。

shotfleet 本身是付费的闭源程序，但提供免费档：check 免费，run 最多支持 2 种语言。这里的文件采用 MIT 许可，不包含 shotfleet 源码；它们只负责告诉你的 AI 编码 Agent 如何使用 shotfleet。这些文件适用于 shotfleet 0.1.9。

这些技能可让你的 AI 编码 Agent 了解如何安装、设置、运行和检查 shotfleet，以及如何读取报告：

技能	功能
shotfleet	主技能：该运行哪个命令、退出代码、--json、编写流程以及故障排查
shotfleet-review	将检查报告转换为修复清单（需要重新采集哪些语言的截图，以及应该在应用还是流程中修复）
shotfleet-ci	将 shotfleet check 添加到 GitHub Actions 或其他 CI

这些技能会告诉 Agent 要输入什么命令。你的 Mac 上仍需安装 shotfleet 本身：

curl -fsSL https://shotfleet.com/install.sh | sh

安装

MCP 服务

安装 shotfleet 后：

claude mcp add shotfleet -- shotfleet mcp

对于其他 MCP 客户端，命令是 shotfleet mcp（stdio）。请参阅下方的 MCP 服务部分。

Claude Code 插件

在 Claude Code 会话中：

/plugin marketplace add noloman/shotfleet-skills
/plugin install shotfleet@shotfleet

或在 Shell 中运行：

claude plugin marketplace add noloman/shotfleet-skills
claude plugin install shotfleet@shotfleet

此插件包含三个技能和 shotfleet MCP 服务（shotfleet mcp，提供 check、run 和 doctor）。 只有安装了 shotfleet，MCP 服务才会启动；如果未安装，/mcp 会将其显示为失败，但技能仍可使用。 如果你已经运行过 shotfleet skill install，这些技能会显示两次。请删除其中一份（~/.claude/skills/shotfleet*）。

GitHub Copilot、Codex、Cursor、Gemini CLI 等（gh）

需要 GitHub CLI 2.90 或更高版本：

gh skill install noloman/shotfleet-skills --all --scope user

使用 --agent 选择 Agent，例如 --agent codex、--agent cursor、--agent gemini-cli 或 --agent claude-code。省略 --scope user 即可安装到当前项目中。

任何 Agent（npx）

npx skills add noloman/shotfleet-skills --skill '*' -g

Gemini CLI

gemini skills install https://github.com/noloman/shotfleet-skills.git --path skills/shotfleet
gemini skills install https://github.com/noloman/shotfleet-skills.git --path skills/shotfleet-review
gemini skills install https://github.com/noloman/shotfleet-skills.git --path skills/shotfleet-ci

已经安装了 shotfleet？

那么你也已经拥有这些技能。此命令会将它们复制到 Claude Code、Codex、Cursor、Gemini CLI 和 Copilot 会查找的位置：

shotfleet skill install

完成上述任一操作后，启动新的 Agent 会话，然后提出类似“用 shotfleet 检查我的 fastlane 截图”的请求。

MCP 服务

shotfleet mcp 会运行一个本地 stdio MCP 服务。需要在你的 Mac 上安装 shotfleet。

工具	功能
check	检查截图文件夹：每张截图都显示对应语言、不同语言之间没有重复截图、没有缺失截图，并符合商店尺寸和数量规则；返回简短摘要
doctor	说明 Maestro、Xcode 和 Android SDK 是否就绪，以及缺少什么；不会更改任何内容
run	根据 shotfleet.toml 以每种语言采集截图，然后进行检查；会启动模拟器和仿真器，因此需要几分钟

安全说明：除非调用通过 hooks: true，否则 MCP 不会运行配置中编写的命令。未通过时，run 会跳过 [hooks]，并拒绝包含 [capture] 构建、[ios] simctl 或 [android] shell 的配置。run 始终会在模拟器上安装并运行配置中的应用，因此只应将其指向你信任的项目。check 并非只读：它会将报告（check.json 和 index.html）写入报告文件夹，但绝不会更改任何截图。

价格

这些技能免费，采用 MIT 许可。在 shotfleet 中，check 免费，run 最多支持 2 种语言。超过 2 种语言的 run 和 export 需要许可证：shotfleet.com。

你的许可证密钥

切勿将许可证密钥粘贴到 Agent 配置、聊天、MCP 设置或代码仓库中。请在你自己的终端中亲自运行一次：

shotfleet activate <your key>

之后，你的 Agent 会使用 shotfleet，且不会看到密钥。在 CI 中，将密钥放入名为 SHOTFLEET_KEY 的机密中。 不要通过 claude mcp add --env 传递密钥，否则它会以纯文本形式写入 ~/.claude.json。

问题

请写信至 [email protected]。此处的文件会在每次发布时从 shotfleet 源代码复制而来，详见 SYNC.md。