Meticulous

Meticulous Agent 技能

Meticulous 的一组 Agent 技能 — Meticulous 是面向 Web 前端的自动化视觉回归测试平台。

这些技能让 AI 编码助手（Cursor、Claude Code 等）能够使用 Meticulous：审查测试运行、调查回放、调试差异等。

设置

完整的设置说明请参阅 Meticulous 文档：app.meticulous.ai/docs/agents/setup。其中介绍了如何安装 CLI、进行身份验证以及安装这些技能。

简要步骤：

# 1. Install/update the Meticulous CLI
npm install --global @alwaysmeticulous/cli@latest

# 2. Authenticate (opens a browser to sign in and pick a default project)
meticulous auth login

# 3. Install these skills into your project
npx skills add alwaysmeticulous/skills --skill "*" --agent claude-code --agent codex --agent cursor -y

Claude Code 插件

此仓库也打包为 Claude Code 插件，它会安装以下所有技能（命名空间格式为 /meticulous:<skill-name>），并自动连接托管的 Meticulous MCP 服务。要安装，请在 Claude Code 中运行：

/plugin marketplace add alwaysmeticulous/skills
/plugin install meticulous@meticulous

然后输入 /mcp，并为 Meticulous MCP 服务选择 Authenticate（在浏览器中登录；如果你已通过 CLI 使用 meticulous auth login 进行身份验证，则无需重复操作）。

Codex 插件

此仓库也打包为 Codex 插件，它会安装以下所有技能，并自动连接托管的 Meticulous MCP 服务。要安装，请运行：

codex plugin marketplace add alwaysmeticulous/skills
codex plugin add meticulous@meticulous

然后运行 codex mcp login meticulous 对 MCP 服务进行身份验证（在浏览器中登录）。要获取后续更新，请运行 codex plugin marketplace upgrade meticulous。

Cursor Marketplace

此仓库也打包为 Cursor 插件。在 Cursor Marketplace 上架后，Cursor 用户无需使用 npx skills，即可从 Customize → Plugins 安装 Meticulous 技能（也可以在 Marketplace 中搜索）。如果需要在多个 Agent 中使用相同的技能，仍建议采用上述 npx skills 流程。

技能

技能是 Markdown 文件，可为 AI 编码助手提供特定领域的知识和分步工作流。Agent 读取技能后，就能针对特定任务获得专业知识，无需在每次对话中都预先包含相关上下文。

技能遵循 Cursor 和 Claude Code 使用的 SKILL.md 格式。

技能	描述
审查技能
meticulous-review	处理 Meticulous 测试运行的结果，并根据其审查状态采取行动——针对 PR 预期的更改审查尚未审查的差异，并标记潜在回归；处理 PR 代码时，将需要修复的内容交给 meticulous-fix。在测试运行结果有意义时使用：审查拉取请求/合并请求、推送前端更改后、Meticulous CI 检查失败或仍在等待时，或有人要求查看 Meticulous 结果时。
meticulous-fix	修复测试运行中已审查并被拒绝的视觉差异；如果提供了审查意见，则按照意见修复。当用户已审查测试运行结果，并将修复任务交给 Agent 实施时，或 meticulous-review 移交需要修复的内容时使用。
meticulous-test	实施前端更改后运行 Meticulous 测试，然后将任务交给 meticulous-review 技能，将每项视觉更改分类为预期或非预期。
meticulous-zero-diff-task	实施端到端预期不会产生视觉差异的任务，以 Meticulous 作为迭代反馈循环，直到差异消失，然后创建 PR。当任务的核心要求是“UI 不应发生变化”时使用，例如依赖项/版本升级、代码重构、迁移或类似任务。
meticulous-increase-coverage	通过追踪覆盖率不足的特定文件，找到代码库中触发这些文件的实际 UI 操作；使用真实录制的浏览器会话执行该操作，并通过干净的覆盖率对比验证改进，从而提高 Meticulous 项目的覆盖率。还会创建 PR，建议将结构上永远不会在浏览器中执行的代码加入 .meticulousignore。有人要求“提高覆盖率”“查找未测试代码”或为项目“添加 .meticulousignore 条目”时使用。
meticulous-iterative-dev	使用 Meticulous 进行逐步视觉验证的前端迭代开发循环。实施多步骤前端更改，并希望在最终云端测试运行前，于每一步及时发现视觉回归和非预期副作用时使用。
meticulous-simulate-and-diff	针对实时 URL 运行 Meticulous 会话模拟并分析视觉输出——既可以直接检查屏幕截图（快速检查模式），也可以对比与基础回放之间的像素差异和 HTML 差异。检查代码更改是否为特定会话引入视觉回归时使用。
meticulous-use-session-data	下载并使用结构化的 Meticulous 会话数据（用户流程 + 网络模拟）在本地测试代码更改。需要了解测试涵盖哪些用户交互和 API 调用，或需要网络模拟来编写测试时使用。
meticulous-improve-test-env	确定如何更改项目的测试环境，以免 Agent swarm 在针对实时后端进行测试时受阻——填充更好的测试数据、扩大测试用户的权限、启用功能标志、修复测试登录。读取 Agent swarm 记录的环境配置阻碍，检查代码库和测试环境配置，并提出具体修复方案。
辅助技能
meticulous-cli	Meticulous CLI 工具及其全局选项概览。一般性询问 meticulous CLI、可用命令或适用于所有命令的全局标志时使用。
meticulous-cli-update	检查是否已安装 Meticulous CLI (@alwaysmeticulous/cli) 和技能，以及是否为最新版本；如未安装或不是最新版本，则进行安装/更新。每项其他 Meticulous 技能启动时都会调用此技能，因为 CLI 和技能仍在积极开发中，且经常更新和改进。

贡献

此仓库中的所有 Markdown、JSON 和 YAML 文件均使用 oxfmt 格式化，CI 也会强制执行：

pnpm install
pnpm format        # format in place
pnpm check-format  # what CI runs

这不仅仅是为了统一代码风格。此仓库中的技能会通过 npx skills add 安装到其他仓库中，其中有些仓库会使用 oxfmt 格式化整个目录树，包括已安装的技能文件。如果技能的源文件本身不符合 oxfmt 格式，目标仓库的格式化工具就会在安装时重写文件，导致安装后的副本与 skills-lock.json 中记录的上游哈希不再匹配，之后每次在该仓库中运行 npx skills update 都会与格式化工具冲突。让源文件保持相同的格式可以彻底避免这个问题，因此此处的 .oxfmtrc.json 与使用这些技能的仓库所采用的设置一致（尤其是 printWidth: 80）。

许可证

ISC © Meticulous, Inc.