Reticle Skill:让 AI coding agent 的”修好了”有证据可查

AI coding agent 说自己修好了一个 bug,你怎么知道它真的修好了?Reticle 给出了一个直接的回答:让 agent 实际跑一下你的 app,看结果。

功能与原则

Reticle 是一个面向 AI coding agent 的运行时验证工具。它驱动真实的运行中应用,读取实际的页面状态、网络请求、控制台输出,然后返回 pass / fail / couldn’t tell 并附带证据(哪个请求、哪个状态变化、哪行代码需要检查)。

核心设计原则:
– 不写测试语法:用自然语言描述”应该发生什么”,Reticle 自动执行验证
– 证据驱动:每个结论都有具体的请求/响应/文件行号,不是模糊的”看起来修了”
– 开箱即用的 MCP:支持 Claude Code、Codex CLI、Cursor 等主流 coding agent

认可度

截至 2026-10-03,Reticle 的 GitHub 数据:
– Star:1,152(2 天前 trending 榜单 1,020 → 今日 1,152,增速约 +65 星/天)
– Forks:168
– 最后更新:2026-10-03

该 repo 入选 linny006/trending-claude-skills leaderboard 实时追踪(每 15 分钟刷新),在 AI coding agent 技能圈获得持续关注。

链接

GitHub:https://github.com/reticlehq/reticle

原作者

由 ReticleHQ 组织维护(GitHub org reticlehq),不是一个个人维护项目,而是有完整团队和 Discord 社区的商业级开源项目。

介绍

传统上,AI coding agent 写完代码后,只能靠”自己说自己修好了”来报告结果。人类开发者需要自己去跑、去检查,验证成本并没有降低。

Reticle 的思路是:让 agent 在真实的浏览器环境里跑一遍你要验证的流程,读取运行时的实际行为证据,然后告诉你 pass 还是 fail。

安装后,Reticle 会:
1. 驱动 Chrome/浏览器,打开你的 app
2. 按 agent 的指令执行操作(如:点击结账、输入表单、触发 API)
3. 捕获网络请求、DOM 状态变化、控制台错误
4. 返回结构化的 pass/fail 结果 + 证据截图/请求记录

支持的验证场景包括:功能回归(结账流程是否正常)、安全检查(权限控制是否生效)、性能断言(某个 API 响应时间是否达标)、视觉 diff(UI 改动后页面是否正常渲染)。

特点

  • 零测试代码:不需要写 Playwright/Selenium,只要说”结账流程应该成功”,Reticle 自动执行
  • 多 Agent 支持:Claude Code(插件形式)、Codex CLI、Cursor,以及任何支持 MCP 的 agent
  • 本地优先:reticle init 可完全本地运行,不上传任何数据;reticle connect 才关联云端项目
  • 完整证据链:返回请求内容、响应状态、DOM 变化、console 日志,以及需要修复的具体文件和行号
  • 安全设计:公开的安全评分(SecurityScorecards 可见),数据收集范围文档化,用户可控

使用方法

安装(一键脚本,macOS / Linux)

curl -fsSL https://raw.githubusercontent.com/reticlehq/reticle/main/install/install.sh | sh

Windows:

irm https://raw.githubusercontent.com/reticlehq/reticle/main/install/install.ps1 | iex

连接项目

在 app 目录下运行:

reticle connect --project "My App"

这会安装 dev SDK、启动 dev server、连接浏览器、关联云端项目(可选)。

在 Claude Code 中使用

/plugin marketplace add reticlehq/reticle
/plugin install reticle@reticlehq

重启 Claude Code 后,Reticle 工具自动加载。

验证示例

在 Claude Code 中输入:

“Verify the checkout flow with Reticle”

Reticle 会:启动浏览器 → 访问结账页 → 模拟完整结账操作 → 读取网络请求和页面状态 → 返回 pass/fail + 证据

使用场景与人群

适用场景:
– AI coding agent 修 bug 后的自动化验证
– CI/CD pipeline 中的 AI 生成代码回归检查
– 安全敏感功能(权限、认证、支付)的自动化审计
– 多 Agent 协作流程中,某个 agent 声称完成后其它 agent 的独立验证

目标用户:
– 深度使用 Claude Code / Codex / Cursor 的开发者
– 搭建 AI coding agent 平台的技术团队
– 需要对 AI 生成代码做质量把关的工程团队

输入与输出案例

案例 1:结账流程验证

输入(对 Claude Code):

“I changed checkout. Verify it with Reticle before you tell me it’s done.”

Reticle 返回:

✅ PASS
Evidence:
  POST /api/checkout → 200 OK
  Cart cleared after payment
  Confirmation email triggered (1 request to mail API)

案例 2:安全权限检查

输入:

“Verify that non-admin users get 403 when accessing /admin/api”

Reticle 返回:

✅ PASS
Evidence:
  GET /admin/api (as user role) → 403 Forbidden
  No admin data returned in response body
  Audit log entry created correctly

案例 3:Agent 自己修 bug 后的双重验证

输入:

“Reproduce the bug with Reticle, fix it, then prove the fix with the same steps.”

Reticle 跑两轮:第一轮 fail(证明 bug 存在),agent 修复代码,第二轮 pass(证明修好了)。整个过程有完整的证据记录。


Reticle 解决的是 AI coding 落地最核心的一个问题:agent 说”修好了”,你怎么信?答案是让它在真实环境里跑一遍,用证据说话。对于已经在用 Claude Code 类工具的开发者,这是值得加入工作流的验证层。


GitHub: https://github.com/reticlehq/reticle

评论区

0 条评论

登录后可评论。

Skill超级捕获手 74 阅读