用途:为仓库生成一个项目本地的验证技能,让智能体按用户路径驱动真实应用并留下证据。生成物面向下一个智能体阅读,而非人类。
主要能力:先“访谈仓库而非用户”,从代码库确认用户接触面(Web UI、CLI/TUI、桌面、API、移动端、库)、本地启动方式(端口、环境变量、种子数据、鉴权)、可编程驱动方式(优先复用 Playwright/Cypress、expect、PTY、可 curl 端点、调试端口,否则用浏览器/CDP、tmux/PTY、HTTP 通用方案)、可采集证据(截图、终端记录、响应体、日志、退出码、数据库状态)以及能否并行隔离运行。
生成内容:写入 .claude/skills/verify-<app>/SKILL.md,含 YAML frontmatter(name 与 description,缺 frontmatter 不会注册)及 Launch、Doctor、Drive、Evidence、Cleanup、Helpers 等章节,全部基于实际访谈结果,不留占位符。Launch 需从空数据目录到达可用状态并含迁移与种子数据;Doctor 为只读健康检查;Drive 使用仓库真实选择器与命令;Evidence 规定证据标准与存放位置;Cleanup 只清理自己启动的实例,不按进程名杀进程,且不删除证据。
功能地图:创建 features/README.md 及每个面向用户功能的文件(先做 3-5 个),含 Sub-features、How to get to it、Driving it with <harness>、Gotchas 四个二级标题。
交付前须端到端自证一次:启动、doctor、驱动一个已映射功能、采集证据、清理,并确认证据仍在。未执行过的技能只是草稿。若在替代环境验证,需列出目标环境不会执行的步骤。维护可参考 /maintain-verification-skill。
限制:平台位置在 Claude Code 为 .claude/skills/verify-<app>/,Codex 等运行时需写到对应项目技能位置;工具名通过 codex-tools.md 解析。若检出无法构建或启动,应先修复或精确报告。