ZooWork
ZooWork
acceptance给 Agent 用的验收测试

先看证据
再接受 AI 做出来的成果。

Agent 说做完了。Acceptance 把截图和录屏放在同一个链接上,无论它跑在哪里,团队都能打开看。

或者先查看报告示例 ↓
为什么用 Acceptance

“做完了”是 Agent 说的。
“接受”由你决定。

很多时候,要看到结果才知道自己要什么。Acceptance 把这一刻放进一份报告:随时打开,和团队一起看,你每退回一次,下一次就会更准。

无论跑在哪里,都能看到结果

后台任务、云端沙箱、没有屏幕的机器。Agent 把截图和录屏发到同一个链接。早上九点,你就能看它凌晨两点做完的东西。

你退回过的,它会记住

每一轮都会留下标准、失败的例子,以及改过什么。下次交付前 Agent 会先看这些,同样的问题不容易再交上来。

一起看

设计、产品和工程打开的是同一份报告。在截图上圈一块,在讨论里回复,接受你负责的检查项。每个决定都标着是谁做的。

验收报告示例

先看报告如何组织检查与证据。

展开示例检查项,了解观察与证据如何呈现。打开我的验收
交互示例

新用户引导验收

待人工确认

以下内容用于展示报告结构,不代表一次真实验收的结果。

窄屏下主操作完整可见 界面证据

检查时看什么

标题、输入区域与主操作应完整可见,页面不应横向溢出。

真实报告在这里展示 Agent 采集的截图与观察。

安装说明与命令一致 命令证据

示例检查:核对版本、安装命令和执行记录,并保留原始输出。

zoowork --version
键盘路径可以完成操作 交互证据

示例路径:Tab 移动焦点 → Enter 执行操作 → Esc 关闭浮层。实际结果由证据与人工审核决定。

你的 Agent 执行检查,由你作出判断。交互示例 · 不产生真实记录
它抓住什么

专找能通过 CI 的那些问题。

测试证明代码能跑。它看不见被裁切的菜单、暗色模式下消失的文字,或 320px 宽度上溢出的德语按钮。Acceptance 按人会看的方式去看,并把看到的东西给你。

指到具体的像素

在截图上画一个框,写明哪里不对。下一轮从这块区域开始,而不是一句“看起来不太对”。

动效也有记录

拖拽、过渡和加载都会被录下来,你可以拖到跳动的那一帧。

亮色和暗色并排

每种主题都按同一状态截下来,对比度问题藏不进没人打开的那个模式。

长单词,小屏幕

用真实的语言和真实的宽度。德语在 320px 时,按钮换行、文字溢出,往往最先出现。

不只是点击,还有键盘

Tab 顺序、焦点陷阱和 Esc 都按键逐个走一遍,每一步都有日志。

退回一项,其余保留

每个检查项有自己的轮次。没过的去改,你已经接受的保持接受。

怎么用

从“做完了”
到接受,一共三步。

你说清要达成什么。Agent 把它写成检查项,实际操作产品,再发布报告。你看证据,然后决定。

安装 Acceptance
  1. 01

    先说做完是什么样

    用平常的话说出结果。Agent 会先起草检查项,你改完再开始跑。

  2. 02

    Agent 去跑真正的产品

    它打开应用,点进去,改窗口大小,切换主题,并把每一步都记下来。

  3. 03

    最后由你决定

    证据旁边是 Agent 看到的东西。接受,或只退回这一项。你写的备注会成为下一次的教训。

开始安装

装到
工作本来就在的地方。

把 Skill 加到你要验收的项目里,然后让 Agent 去验。

acceptance / SKILL.md
阅读 https://zoowork.itong.cloud/acceptance/skill.md,并按说明在当前项目安装 Acceptance。完成后提醒我重新加载 Skills。

把这段话交给项目里的编程 Agent。需要登录时,请在浏览器中自行完成授权。

安装后重新加载 Skills,或新开一个 Agent 会话。安装指南 ↗

然后对 Agent 说:“用 Acceptance,按我的要求验收这个功能。”

安装之前,先看这几个问题。

Acceptance 是什么?

Acceptance 是项目中的 Agent Skill,与 ZooWork CLI 配合组织验收检查,发布观察和证据,交给人来判断交付结果。

它能抓住哪些问题?

适合检查需要实际操作才能发现的问题,例如菜单被裁切、暗色模式对比度不足、窄屏溢出、键盘焦点错误和动效跳动。

它会取代测试或代码审查吗?

测试和代码审查仍然需要保留。Acceptance 面向交付后的实际行为,补充用户可查看的观察记录和证据。

它能配哪些编程 Agent?

能够读取项目 Skills、执行命令并操作目标界面的编程 Agent 都可以使用。具体检查能力取决于 Agent 的工具、运行环境和权限。

已有的项目能用吗?

可以。在已有项目的根目录安装 Skill,重新加载 Skills 或开启新会话,再说明希望验收的目标与范围。

报告和证据存在哪里?

报告与证据发布到 ZooWork 服务,使用对应账号或工作区的存储空间。请以实际套餐、权限与可用空间为准。

Agent 跑在云端沙箱里,我也能看吗?

发布成功后,可以通过浏览器查看报告,无需连接 Agent 所在的机器。访问报告仍需符合其共享范围和权限。

我把一个检查项退回去之后呢?

把问题、预期和相关区域写清楚,让 Agent 修复受影响的检查项,并带回新的证据轮次。已有审核记录由验收流程保留。

Agent 会从以前的验收里学到东西吗?

Skill 会引导 Agent 读取项目中的验收标准和历史反馈。具体的退回原因与失败案例,有助于下一轮针对问题改进。

几个人能一起看同一次交付吗?

团队可以在合适的共享范围内围绕同一份报告讨论与审核。请按报告提供的访问权限和审核入口操作。

谁能看到我的报告?

分享前请检查报告的实际共享范围、证据内容和账号权限。不要上传凭据、无关窗口或其他不应公开的内容。

谁决定这次工作算不算接受?

由你决定。Agent 执行检查并记录观察,你查看证据后接受交付,或说明需要修改的地方。

截图或日志缺了怎么办?

缺少所需证据时,不能把结论当成已经验证。先补齐截图、录屏或日志,再交给人工判断。

先看证据,再接受这次交付。

Agent 跑检查项。你看报告,然后决定。

ZooWork · 用证据连接交付与验收。