SuperAPI AI 工具集

create-verification-skill

通用与其它

查看项目

更新于 10-16 05:43

技能介绍

用途:在项目内生成一个本地验证技能,用脚本化方式驱动真实应用并证明行为:启动应用、按用户路径操作某个功能、采集证据。生成物面向下一个从未见过该应用的智能体冷启动阅读,而非写给人看。

主要能力:先“访谈仓库而非用户”,从代码库中回答:用户实际接触的界面(Web UI、CLI/TUI、桌面、API、移动端、库,取主要者并记录其余)、本地启动方式(优先仓库自身文档的开发命令,记录端口、环境变量、种子数据、认证)、程序化驱动方式(优先已有测试脚手架如 Playwright/Cypress、expect、PTY、curl 端点、调试端口,否则选通用方案:Web/Electron 用浏览器/CDP,CLI/TUI 用 tmux/PTY,服务用原生 HTTP)、可采集的证据(截图、终端记录、响应体、日志、退出码、数据库状态)、隔离性(能否双实例并行,不能则需在技能中说明,拒绝共驱优于破坏用户会话)。若检出代码无法构建或启动,需先修复或精确报告。

用法:生成 skills/verify-<app>/SKILL.md(或当前宿主的项目本地技能根路径),带 YAML frontmatter(name: verify-<app> 与描述;无 frontmatter 技能不会注册),包含 Launch(精确启动命令与就绪判断、拆除)、Doctor(只读检查)、Drive(使用本仓库真实选择器/命令的驱动配方,优先稳定句柄)、Evidence(采集标准:走真实用户路径,采集动作与结果状态,验证副作用,脱敏边界)、Cleanup(只杀自己启动的实例,绝不按进程名杀;保留证据)、Helpers(随技能附带的脚本须可执行且展示调用方式)。同时生成 features/README.md 索引与每个用户可见功能一个文件(先做 3-5 个),含四个 H2:Sub-features、How to get to it (user POV)、Driving it with <harness>、Gotchas。

交付前需端到端跑通一遍:启动、Doctor、驱动一个已映射功能、采集证据、清理,并确认清理后证据仍在;每次失败迭代后也须执行清理。可指向姊妹技能 maintain-verification-skill 维护功能图。

限制:需在可构建运行的真实仓库上使用;双实例共享状态的场景不能并行驱动;未执行过的生成技能只是草稿;资料未提供具体价格、收费、支持平台清单等信息。