SuperAPI AI 工具集

maintain-verification-skill

测试与质量

查看项目

更新于 10-16 16:27

技能介绍

用途

该技能是/create-verification-skill所生成验证技能的维护循环(upkeep loop),也适用于任何带有功能地图的项目本地验证技能。核心出发点是:功能地图在应用发生变化的那一刻就会腐化。维护的“严谨单位”是功能(feature),而非每一句话——要求对每个功能文件既做源码覆盖,也做一次实机演练,而无需把每一条要点都变成终端操作。

主要能力与运行流程

结果类别

运行前需选定并声明三类结果之一:

  • clean:每个功能都获得源码与实机覆盖,没有值得提交的内容,不建分支、不提PR。
  • changed:通过一个PR提交经过证明的文档、测试工装(harness)或地图修正。
  • blocked:覆盖无法完成,或已证明的修复无法安全提交,需明确说明阻塞原因。

编辑范围

仅可编辑验证技能自身的目录(其SKILL.md、features/以及它拥有的工装脚本)。运行期间绝不修改产品代码:地图所描述的某行为在应用中已不存在,要么属于文档漂移(修正地图),要么属于产品回归(上报,不得在文档中掩盖)。

运行步骤

  1. 定位目标:寻找带有启动/驱动章节和功能地图的项目本地验证技能(通常为verify-*/)。检查.agents/skills/、.claude/skills/、~/.agents/skills/和~/.claude/skills/,并将解析到同一真实路径的条目只计一次。若有多个候选则询问选择哪一个;若没有则停止,并指向/create-verification-skill,而非自行发明目标。
  2. 索引卫生:阅读功能地图README并对其同级文件做glob,修正缺失、多余、重复或失效的条目。此步轻量,不生成清单。
  3. 源码波次:为每个功能文件启动一个delegate_task子任务,以mode: "async"并发启动,标题命名该功能,每个功能子任务携带一个在波次内重试时保持稳定的clientRequestId,且不指定target,使其运行于父模型。子任务只获得其简报,简报需包含功能文件的绝对路径、"read-only: inspect only, no writes, no git commands"、下述返回结构以及"Do not delegate"。每个子任务从源码解释“这个用户可见功能如何工作?”,标注可能的文档漂移并附引用,返回一份简洁的实机验证配方。子任务从不驱动应用,也从不编辑文件。返回结构:功能摘要 / 源码入口点 / 可能的漂移或无 / 一份配方。结束该轮次,等待完成通知唤醒。
  4. 调和:确认每个功能文件都有返回摘要;将重叠配方合并为尽可能少的应用状态;抽查被引用的漂移,不重复验证干净声明;扫描近期变更中地图缺失的用户可见界面——在判定遗漏前必须给出具体源码路径。
  5. 实机验证:即使源码看起来干净也必需。协调者负责全部驱动;遵循验证技能自身的启动模型——服务器和UI使用一个长期存活实例串行驱动,短生命周期CLI则每次驱动使用全新的隔离会话(由该技能的Launch章节决定)。每个功能至少演练一次,全程保持三项不变量:(1) 在实例上次出现异常行为之后,未重新体检前绝不驱动——首次驱动前体检,以会话为单位的每次新会话体检,任何失败驱动后再次体检;当体检看不到失败(健康进程上的UI卡死状态)时,重置到已知状态或重新启动,而非侥幸;(2) 已捕获的证据在每次清理中都要保留,并在其指定位置核查,不能假设;(3) 驱动所启动的任何东西都不得超出该驱动的有用期——无论会话是卡住、退出还是共享(共享实例清理残留而非实例),失败迭代的残留都要清理。由技能漂移导致的体检失败属于漂移:在编辑范围内修复并重试一次——只重启该修复所失效的东西,不多做——之后再判定为blocked。无法到达的功能只有在给出具体前置条件(认证、权限、操作系统、外部状态)和尝试过的路径时,才能标记为已验证不可达;若地图遗漏该前置条件,即为漂移。来自分诊的任何工装修复在提交前都要重新实机驱动。最终拆除发生在本次运行最后一次驱动之后——包括那些重新证明——因此没有任何东西超出本次运行(证据保留)。
  6. 分诊:用户视角描述错误或缺失 → 文档漂移,修正它。可工作的行为工装无法驱动 → 工装缺口,修复它;工装修复遵循与生成相同的helpers规则(脚本可执行,调用方式记录在技能正文中)。应用行为确实损坏 → 产品缺口;为用户记录,排除在本PR之外。
  7. 提交或停止:changed时,提交一个只含已证明修正的PR,先重读每个更改文件,用gh pr create打开,并立即link_pull_request其URL。clean或blocked时,不提PR,如实报告结果与覆盖情况。

运行笔记

在临时位置保留简洁的运行笔记(覆盖的功能、不可达的前置条件、确认的漂移、结果),不要提交。

适用场景

适用于由/create-verification-skill生成或任何带有功能地图的项目本地验证技能,用于周期性巡检,保持验证技能与功能地图随应用变化而保持准确。

限制

技能提到多数pstack技能为用户专用,技能工具无法加载它们;运行期间严格禁止编辑产品代码;PR仅限验证技能目录内的修正。关于具体收费、价格、平台等信息,资料暂未提供。