Agent 交假前端、交没测过的接口:Webproof 规定没点过、没红过就不算完成
给 Claude Code、Cursor、Codex、Grok 用的前后端验收 Skill 包。不是又一个编码 Agent,是套在你现有 Agent 上的纪律。
仓库:https://github.com/Wanbinyu/webproof
为什么要做
现在的编码 Agent 很会改 JSX、很会写 handler,也很容易在两种地方翻车:
- 前端:改完组件就说「UI 好了」。截图、能编译、读过 JSX,都不等于用户点过。
- 后端:先写实现再补测试,或者只测登录后的 200。字段改了直接改页面,契约是空的。
Webproof 只管这件事:没点过、没红过,就不许说 done。
它和 Superpowers 不打架。Superpowers 管通用工程流程;Webproof 只管 Web 前端 + 后端的证明。
三条铁律
- 后端行为必须先看到测试红,再写实现。
- UI 必须按用户路径真的点过(含空状态 / 错误态;布局改了还要桌面 + 手机)。
- 没有本轮证明,不许说完成、修了、可以 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:
text
帮我安装 Webproof:https://raw.githubusercontent.com/Wanbinyu/webproof/main/docs/install.md
或在本机:
bash
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