用途
agency-evidence-collector 是一个面向质量保证（QA）的智能体人格技能，其核心目标是用视觉证据和现实核查取代主观或夸大的质量汇报。它把“截图不会说谎”作为判断依据：无法在截图中看到正常工作的功能，即视为不可用；没有证据的声明被视为幻想。
主要能力
- 现实核查：技能要求先运行 Playwright 截图脚本（示例命令为
./qa-playwright-capture.sh http://localhost:8000 public/qa-screenshots），再检查实际构建出的视图或 HTML 文件，并通过 grep 检索“luxury”“premium”“glass”“morphism”等关键词，确认声称的高级特性是否真实存在。 - 视觉证据分析：对照原始规格中的确切文字，逐条比较截图所见与规格要求，记录布局、配色、排版和可见交互元素。
- 交互元素测试：覆盖手风琴展开与折叠、表单提交与校验及错误提示、平滑滚动导航、移动端汉堡菜单开关、明暗与系统主题切换。
- 多端与深色模式证据：要求提供桌面（1920x1080）、平板（768x1024）、移动（375x667）以及 dark-mode 系列截图，并读取 test-results.json 中的设备兼容性、交互与整页截图数据。
- 结构化报告：报告模板包含现实核查命令、截图清单、规格原文引用、逐条合规对比（✅/❌）、交互测试结果、至少 3 至 5 条问题（附证据截图与 Critical/Medium/Low 优先级）、诚实评级（如 C+/B-/B/B+，禁止 A+ 幻想）、设计等级（Basic/Good/Excellent）和上线就绪结论（FAILED/NEEDS WORK/READY，默认 FAILED）。
使用方式
该技能以智能体人格提示词的形式使用。用户按技能说明触发后，智能体应首先执行强制流程的第一步（截图、文件检查、关键词检索、读取测试结果），再分析截图、测试交互并输出报告。技能引用的详细 QA 方法论位于 ai/agents/qa.md。
适用场景
适用于网站或前端页面的验收测试、规格符合性审查、交互功能验证，以及防止“零问题”“生产就绪”等缺乏证据的汇报进入发布流程。
限制
技能提供的是人格设定与测试流程模板，实际截图依赖 Playwright 脚本与本地服务可用；报告中的评级、问题数量（默认 3 至 5 条）和默认失败结论属于该人格的倾向性规则，并非客观评分标准。具体项目的安装与部署方式暂未提供。