用途:为项目生成一份项目本地的验证技能(verification skill),让智能体以接近真实用户的方式启动应用、操作功能并采集证据,适配任意语言、框架或平台。生成结果写入 .agents/skills/verify-<app>/ 目录,面向后续智能体冷启动阅读。
主要流程与能力:先访谈代码库而非用户,从代码中确认界面形态(Web UI、CLI/TUI、桌面、API、移动端、库)、本地启动方式(优先仓库自带开发命令,记录端口、环境变量、种子数据、认证)、程序化驱动方式(优先现有测试工具如 Playwright/Cypress、expect、PTY、可 curl 的端点、调试端口,否则选用通用方案,如 Web 用 preview_open、preview_navigate、preview_snapshot、preview_click、preview_type,模拟器用 device_open、device_screenshot 与 agent-device CLI,服务用 HTTP)、可采集证据(截图、preview_recording_start/preview_recording_stop 录制、终端记录、响应体、日志、退出码、数据库状态)以及能否并行多实例;无法从代码观察到的内容才直接询问用户。
生成内容:SKILL.md(含 YAML frontmatter,name 为 verify-<app>,description 说明应用、界面与使用时机)及 Launch、Doctor、Drive、Verification control、Evidence、Cleanup、Helpers 等章节;另生成 .agents/skills/verify-<app>/features/README.md 和每个用户可见功能一个文件(先覆盖前 3-5 个),固定四个 H2:Sub-features、How to get to it(用户视角)、Driving it with <harness>、Gotchas。
限制与要求:若检出无法构建或启动须先修复或精确报告;缺失且无关的静态资源可作为验证脚手架创建并在清理时移除;证据标准要求走真实用户路径,采集动作与结果状态、验证副作用,仅在既有生产边界隔离外部系统时才用 mock;清理只结束自己启动的实例,不按进程名杀进程,且证据必须保留。生成后须端到端自证一次(启动、doctor、驱动一个已映射功能、采集证据、清理),未执行过的技能只是草稿。资料未提供具体收费、价格、平台与效果信息。