SuperAPI AI 工具集

create-verification-skill

测试与质量

查看项目

更新于 10-15 20:30

技能介绍

用途:为仓库生成项目本地的验证技能,让智能体按用户路径驱动真实应用并留下证据。生成物写入 .cursor/skills/verify-<app>/,面向下一个智能体而非人类阅读。

主要能力:先访谈代码库而非用户,确定用户接触面(Web UI、CLI/TUI、桌面、API、移动、库)、本地启动方式(优先仓库自带 dev 命令,记录端口、环境变量、种子数据、鉴权)、程序化驱动方式(优先已有 Playwright/Cypress、expect、PTY、可 curl 端点、调试端口,否则用浏览器/CDP、tmux/PTY、HTTP 等通用方案)、可采集证据(截图、终端记录、响应体、日志、退出码、数据库状态)以及能否并行隔离运行。若检出无法构建或启动,需先修复或精确报告。

生成内容:SKILL.md 含 YAML frontmatter(name 与 description,缺少则技能不会注册),以及 Launch(启动命令与就绪判断、teardown)、Doctor(只读健康检查)、Drive(真实选择器与命令)、Evidence(证据标准与存放位置)、Cleanup(只清理自己启动的实例,不按进程名杀,证据须保留)、Helpers(可执行脚本及调用方式)等章节,均基于访谈结果,不留占位符。

功能地图:创建 features/README.md 及每个面向用户功能的文件(先做 3-5 个),每个文件含 Sub-features、How to get to it (user POV)、Driving it with <harness>、Gotchas 四个二级标题;种子数据缺少前置条件时报告失败并写入 Gotchas,不得削弱旅程使其通过。

交付前验证:完整跑一遍自身指令(启动、doctor、驱动一个已映射功能、采集证据、清理),清理后确认证据仍在;每次失败迭代后也要运行清理。若在替代环境验证,需列出目标环境不会执行的步骤。

维护:可指向 /maintain-verification-skill 保持地图与代码同步,仅在用户询问时建议频率。

限制:资料未提供具体收费、价格、平台支持范围与效果数据;生成技能需真实可运行,未执行过的技能只能算草稿。