Reticle Skill:让 AI 编程助手学会自证真伪的运行时验证神器
核心总结
Reticle 是专门解决 AI 编程助手「只管写、不管验」问题的验证 Skill。它让 Claude Code、Codex、Cursor 等 coding agent 在真实运行的应用中读取 DOM、网络请求、控制台和 React 状态,直接给出 pass / fail / couldn’t-tell 的判定结果和具体证据。agent 说「写完了没问题」,Reticle 告诉你到底是真好了还是静默失败了。截至 2026-10-04,GitHub 约 1,020 stars,持续攀升中。
功能与设计原则
Reticle 解决的是一个结构性矛盾:coding agent 生成代码后会直接声称完成,但它从未打开过自己写的那个应用——静默的 500 报错、状态不一致、重复请求全都溜走了。
设计原则是「验证先于信任」:不给 agent 留乐观偏差的空间,每一个改动都必须经过运行态检验。
认可度
- GitHub stars:约 1,020(截至 2026-10-04, trending 榜单实时数据)
- 今日 GitHub Trending 新晋上榜(HOT 项目)
- 分类标签:automated-testing、ai-testing-tool、agent-skills、claude-code、playwright-mcp
- NPM 包
@reticlehq/server已发布,生态完整
链接
GitHub:https://github.com/reticlehq/reticle
原作者
- Organization:ReticleHQ(独立团队,专注 AI 编程验证工具)
- 核心维护者通过 GitHub 组织账号发布,配套
@reticlehq/react前端 SDK
项目介绍
Reticle 起源于一个观察:coding agent 写代码时是乐观的,它默认「写完 = 可用」。但现实中的 bug——按钮点击后服务端返回 500、store 里数值不对、请求重试了两次——全都发生在 agent 从不打开的运行态里。
Reticle 通过 MCP(Model Context Protocol)把 coding agent 接入真实运行的应用。它不需要写测试语法,只要用自然语言描述预期行为,Reticle 就会驱动浏览器、执行操作、读取应用的 DOM 变化、网络响应、控制台输出和 React Fiber 状态,然后给出有证据的 pass / fail 结论,并标注出具体哪个文件和行需要修复。
除了单次验证,Reticle 还支持「录制流程」后在 CI 中 gate——每次代码变更后自动重放关键路径,agent 改了什么、什么路径挂了,全都一目了然。
核心特点
- 自然语言验证:无需写测试代码,说「登录后 store 里应该有 auth: {email}」即可
- 读懂运行态:DOM、网络请求、控制台、React store、React Fiber 全都可见
- 多 Agent 支持:Claude Code、Codex、Cursor、OpenCode 均通过 MCP 接入
- CI Gate:可将关键流程锁进 CI,代码变更后必须通过 Reticle 验证才能合并
- 安全隔离:安装时只请求浏览器自动化权限,不读写本地文件
- 场景覆盖广:安全检查(权限验证、CSP)、可访问性(WCAG)、性能(LCP、CLS)、SEO(死链、跳转)
使用方法
安装(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-project
reticle connect --project "My App"
在 Claude Code 中使用
/plugin marketplace add reticlehq/reticle
或手动添加 skill:
npx skills add reticlehq/reticle
本地初始化(无需云端)
reticle init
使用场景与目标人群
适用场景
- 前端开发:验证 UI 改动后按钮、表单、状态是否正常
- 后端开发:确认 API 返回结构和数值符合预期
- CI/CD 集成:将关键用户路径锁入 gate,防止静默回归
- 安全审计:验证权限控制、CSP 泄露、敏感信息暴露
目标用户
- 日常用 Claude Code、Codex、Cursor 等 coding agent 的工程师
- 有 AI 编程引入的质量焦虑、想给 agent 加一层客观验证的团队
- 需要在 CI 里确保 AI 生成的代码不会静默破坏关键流程的 DevOps 团队
输入与输出案例
案例一:验证登录流程
输入(用户对 Agent 说):"I changed checkout. Verify it with Reticle before you tell me it's done."
Reticle 读取:点击 Sign in → POST /api/login → 200 (14ms) → dashboard 渲染 → store holds auth: {email: "admin@..."}
输出:PASS,附请求记录 + 状态快照
案例二:检测静默 500 报错
场景:页面上显示「支付成功」,但实际服务端返回 500
输入(用户对 Agent 说):"The page looks fine but something's off. Use Reticle to check what's happening underneath."
Reticle 读取:点击支付按钮 → 请求发出 → 服务端返回 500 → 页面上显示「支付成功」是前端错误处理逻辑
输出:FAIL,附请求体 + 响应码 + 状态变化记录,指出文件:行号
GitHub: https://github.com/reticlehq/reticle
作者:Skill超级捕获手 | 定位:Skills 市场 + GitHub + 社媒热门 Skill 追踪者
评论区
登录后可评论。