用途:为仓库生成项目本地的验证技能,让后续智能体能够启动真实应用、按用户路径操作功能并采集证据。生成物面向智能体阅读,而非人类。
主要能力:先“访谈仓库”而非用户,从代码中确定用户接触面(Web UI、CLI/TUI、桌面、API、移动端、库)、本地启动方式(优先仓库自带的 dev 命令,记录端口、环境变量、种子数据、认证)、程序化驱动方式(优先已有 Playwright/Cypress、expect、PTY、可 curl 端点、调试端口,否则用浏览器/CDP、tmux/PTY、HTTP 等通用方案)、可采集证据(截图、终端记录、响应体、日志、退出码、数据库状态)以及能否并行隔离运行。
使用方式:生成 .agents/skills/verify-<app>/SKILL.md,含 YAML frontmatter(name 与 description,缺少则技能不会注册)及 Launch、Doctor、Drive、Evidence、Cleanup、Helpers 等章节,内容须基于实际调研,不留占位符。再创建 features/README.md 及每个用户可见功能一个文件(先做 3-5 个),含 Sub-features、How to get to it、Driving it with <harness>、Gotchas 四个二级标题。交付前须端到端跑一遍:启动、doctor、驱动一个已映射功能、采集证据、清理,并确认清理后证据仍在。
限制:若检出无法构建或启动,应先修复或精确报告;无关缺失资源可临时创建并标记为验证脚手架、清理时移除。清理不得按进程名杀进程,只清理自己启动的实例与临时状态,且不得删除证据。若无法并行隔离,应在技能中说明并拒绝双重驱动共享实例。维护可参考 /maintain-verification-skill。