用途:在浏览器中驱动真实的 Course Video Manager(CVM)应用,为改动留下人类可读的证据,用于开 PR 前验证或复现报告的问题。
主要能力:每次运行克隆本地模板数据库 cvm_verify_template(cvm-local-postgres 容器,端口 5433)到本次运行专属的 cvm_verify_<id> 库,启动服务器并在 cleanup 时删除;自动应用 worktree 中缺失的迁移;启动同克隆上的后台 Sidecar;生成 Write Ledger,逐条记录 insert、update、delete、truncate,并区分服务器、其他连接与 sidecar 的写入;提供 doctor 只读诊断、forensics 取证、截图与快照等。
使用方式:先 pnpm install,再通过 .claude/skills/verify-cvm/scripts/verify.sh 的各动词操作,如 $V launch、$V doctor <run>、$V ab <run>、$V shot、$V snap、$V guard <run> baseline/check、$V cvm <run>。每个动词都需传入 run id,无默认运行。浏览器驱动经 $AB($V ab <run>)进行,按角色与文本定位,快照需限定范围。
适用场景:验证写路径、复现问题、检查 cvm 命令、在开 PR 前确认改动。
限制:外部服务凭据均为无效值,外部调用默认失败;生产环境只读,仅可查看较新数据,禁止写入;不得自行运行 pnpm db:verify-snapshot 或 setup-verify-db.sh;模板缺失或过旧时需停止并请 Matt 处理;Stream Deck 与 OBS 行为无法在此验证;克隆上不要对真实 Course 执行 Publish、Export 或编码。