Reticle Skill:让 AI 代理的”修好了”变成可证明的 verdict

AI 编程代理说”修好了”,你真的信吗?Reticle 给你的答案不是截图,而是一个带着证据的 verdict:pass / fail / couldn’t tell,以及具体到 file:line 的修复位置。这是 2026 年 GitHub trending 上最值得关注的新型 Skill 之一,解决的是 AI 编程最核心的信任问题——AI 生成的代码到底跑没跑对。

功能与原则

Reticle 的核心定位是AI 编程代理的运行时验证层。它不是截图工具,不是浏览器自动化库,而是从运行中的应用内部读取真相:网络请求、应用状态(Redux/信号量/自定义状态)、React 提交流、路由、console 错误、动画帧。它让 AI 代理在每次”我认为修好了”之后,得到一个客观的 pass/fail verdict,而不是继续凭感觉往前走。

核心原则:你说修好了,Reticle 来证明。

认可度

  • GitHub Star 数:截至 2026-10-03 约 1,020 星(来源:trending-claude-skills 实时榜单),过去 7 天增速 7.5%,仍处于上升通道
  • 2026 年 9 月底曾出现单日 +98 星的增长脉冲
  • 多次出现在 GitHub trending 的 agent-skills 类目
  • Agent Skills Hub 收录,Quality Score 64/100,Security 审计通过(🟢 Audited safe)

链接

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

原作者

reticlehq(GitHub 组织)—— 专注于 AI 编程代理验证工具的初创团队,核心维护者公开,GitHub Security Scorecard 已在 securityscorecards.dev 上公开可查。

介绍

AI 代理能生成代码,但有一个天然的弱点:它不知道自己的代码到底跑没跑对。常见的场景是:代理说”修好了”,实际上按钮根本没绑定 handler、POST 请求返回 500、状态管理写错了变量名。截图看起来完美,但程序内部早已千疮百孔。

Reticle 的思路是从运行中的应用内部读取真相。它在本地监听网络请求、应用状态变化、React commit 事件、console 错误和路由跳转,然后把这些信号组织成一个 verdict 返回给 AI 代理。与 Playwright 或截图工具不同,Reticle 读取的是程序”脑子里在想什么”,而不是”屏幕上长什么样”。

它支持 macOS 和 Linux 安装(Windows 通过 PowerShell),通过 npm 包 @reticlehq/server 分发,同时提供 MCP Server 和 Claude Code Skill 两套接入方式。安装后只需要在项目目录运行 reticle connect --project "My App",就能把当前开发中的 Web 应用接入验证网络。

特点

  • 读取内部状态:不仅看 DOM,还看网络请求、应用 store(Redux/信号量/Zustand)、React commit 流、console 日志
  • pass/fail verdict + 证据:返回具体是哪个请求失败、哪个状态没更新,以及应该打开哪个文件的哪一行
  • 零测试语法:不需要写任何测试代码,直接用自然语言描述”应该发生什么”,Reticle 来验证
  • 多场景覆盖:安全检查(权限验证、CSP 违规)、无障碍/UX(焦点管理、键盘事件)、性能(LCP/CLS)、SEO(标题/链接/重定向)
  • CI 集成:npx @reticlehq/server gate --since HEAD~1 可强制在 CI 中锁住 regression,让 AI 代理无法在未验证的情况下声称完成

使用方法

安装(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

连接项目:

cd your-app-directory
reticle connect --project "My App"

Claude Code 中使用:
安装后直接对 Claude 说:

“Verify the checkout flow with Reticle before you tell me it’s done.”

验证结果示例:
– "支付按钮点击后,API 返回 200 但金额被重复扣除两次" → Reticle 读取网络日志,发现 double charge
– "结账完成后购物车应该清空" → Reticle 读取应用 store,发现 store.items.length = 0 但 badge 显示 12

使用场景与人群

适用场景:
– AI 编程代理(Claude Code、Codex、Cursor、OpenCode 等)开发迭代时的实时验证
– CI 中 regression 检查,防止 AI 修改文件后跳过验证直接声称完成
– 安全漏洞验证(权限控制、CSP、secret 外泄)
– SEO 验证和 dead link 检查
– 性能指标验证(LCP、CLS、React render 次数)

目标用户:
– 使用 AI 编程代理的全栈工程师,尤其是 TypeScript/React 团队
– 希望在 AI 工作流中引入更严格质量门的开发团队
– 关注 AI 生成代码可验证性的技术负责人

输入与输出案例

案例 1:验证修复是否生效

用户对 AI 代理说:

“我修改了结账流程。用 Reticle 验证一下支付流程是否正常工作。”

Reticle 驱动真实应用,读取内部信号后返回:

✅ verified: true
  请求: POST /api/checkout → 200
  状态: order.confirmed = true, cart.items.length = 0
  文件: CheckoutPage.tsx:47

案例 2:捕获隐藏 bug

AI 代理声称”修复了购物车 badge 不更新的问题”,但 Reticle 读取 store 后发现:

❌ verified: false
  期望: badge 显示 0
  实际: store.cartBadge = 12(与 UI 显示的 0 不一致,状态同步存在 bug)
  文件: CartBadge.tsx:23

AI 编程的效率问题已经被解决了,但质量验证依然是痛点。Reticle 正在填补这个空白,让 AI 代理从”说修好了”进化到”能证明修好了”。


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

评论区

0 条评论

登录后可评论。

Skill超级捕获手 625 阅读