Agent 交假前端、交没测过的接口:Webproof 规定没点过、没红过就不算完成

给 Claude Code、Cursor、Codex、Grok 用的前后端验收 Skill 包。不是又一个编码 Agent,是套在你现有 Agent 上的纪律。

仓库:https://github.com/Wanbinyu/webproof

为什么要做

现在的编码 Agent 很会改 JSX、很会写 handler,也很容易在两种地方翻车:

  1. 前端:改完组件就说「UI 好了」。截图、能编译、读过 JSX,都不等于用户点过。
  2. 后端:先写实现再补测试,或者只测登录后的 200。字段改了直接改页面,契约是空的。

Webproof 只管这件事:没点过、没红过,就不许说 done。

它和 Superpowers 不打架。Superpowers 管通用工程流程;Webproof 只管 Web 前端 + 后端的证明。

三条铁律

  1. 后端行为必须先看到测试红,再写实现。
  2. UI 必须按用户路径真的点过(含空状态 / 错误态;布局改了还要桌面 + 手机)。
  3. 没有本轮证明,不许说完成、修了、可以 PR。

没浏览器就报 blocked,不准假装验收过。

六个 Skill

Skill 什么时候用
using-webproof 开工先路由,禁止直接改文件
shape-the-change 先写页面、接口、空/错状态、视口,再编码
contract-before-ui 接口变了先锁契约和失败的消费测试
backend-red-green 后端先红后绿
frontend-click-through UI 真点击
done-means-proven 完成门禁

典型顺序:shape →(接口变了就 contract)→ backend red-green → 写 UI → 真点击 → 才允许说 done。

一句话安装

把下面这句话发给你的 Agent:

帮我安装 Webproof:https://raw.githubusercontent.com/Wanbinyu/webproof/main/docs/install.md

或在本机:

git clone https://github.com/Wanbinyu/webproof.git
python webproof/scripts/webproof.py install --harness all
python webproof/scripts/webproof.py doctor

默认只写 Skill 目录和 AGENTS.md,不联网、不装系统包、不碰密钥。支持 Claude Code / Cursor / Codex / Grok 插件或 skills 目录。

doctor 会识别 Next / React / Vue、FastAPI / Django / Express / Go 等,并指出这一单该走哪些 Skill。证明记在 .webproof/proof.md

它明确不做什么

  • 不替代你的编码 Agent
  • 不保证涨 GitHub 星
  • 不自动发抖音、不爬登录态、不带钱包
  • 截图不是验收

MIT 协议。问题直接提 Issue:https://github.com/Wanbinyu/webproof

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐