SuperAPI AI 工具集

maintain-verification-skill

测试与质量

查看项目

更新于 10-15 21:39

技能介绍

用途:这是 /create-verification-skill 生成的项目本地验证技能的维护循环,目标是让功能地图与验证脚本保持真实。严格性以“功能”为单位,而非逐句核对:每个功能都要有源码覆盖和一次真实运行验证。

主要能力:定位目标验证技能(通常为 .claude/skills/verify-*/,含启动/驱动章节与功能地图);清理功能地图 README 与同级文件的缺失、多余、重复或失效条目;为每个功能文件并发启动只读子代理,从源码解释该用户可见功能如何工作、标注疑似文档漂移并给出引用、返回一条精简的实机验证配方;合并重叠配方、抽查漂移、扫描近期改动中遗漏的用户可见界面;协调者负责全部驱动,按技能自身启动模型执行(服务器/UI 用单一长驻实例串行驱动,短命 CLI 用每次全新隔离会话),每个功能至少跑一次。

使用方式:先定位目标,多个候选需询问,找不到则指向 /create-verification-skill;随后依次执行索引清理、源码波次、对账、实机验证、分诊、发布或停止。仅可编辑验证技能自身目录(SKILL.md、features/ 及其拥有的脚本),运行期间不得修改产品代码。

限制与约束:实机验证必须遵守三条不变量——驱动前先健康检查、失败后重置或重启;已捕获证据在清理后仍须在指定位置可查;驱动产生的残留不得超出该次驱动用途。健康检查失败若由技能漂移引起,按编辑范围修复并重试一次。无法到达的功能需给出具体前置条件与尝试路径,否则视为漂移。结果分三类:clean(无 PR)、changed(一个 PR 提交已验证的修正)、blocked(说明阻塞原因)。运行笔记留在临时位置,不提交。非 Claude 运行时(如 Codex)的并行子代理映射为 spawn_agent 扇出,技能位置也不同,详见 codex-tools.md。