SuperAPI AI 工具集

record-pr-demo

通用与其它

查看项目

更新于 10-16 07:57

技能介绍

用途:当 Payload 的 Pull Request 需要一段简洁的可视化演示供评审者查看时使用。它面向功能演示,不用于提交截图回归基线。

主要能力与流程:先检查功能、相关 diff 和可用测试配置,选择能展示真实功能的最小现有 Payload 配置,必要时才创建临时配置。在 /tmp 写简短计划,包含初始状态、2–6 个可见操作和最终证明;默认只录当前状态演示,仅在要求时做 Before/After。启动相关开发服务器并固定初始状态,避免暴露凭据、个人数据、令牌或无关记录。读取 recording.md 并在 /tmp 创建临时场景模块,把确定性的录制专用数据放入可选的场景 setup 与 teardown 导出。使用带 take 标签的命令,例如从仓库根目录运行 node .agents/skills/record-pr-demo/scripts/prepare-demo.mjs candidate --scenario /tmp/payload-pr-demo-feature.mjs --label feature-take-1,该命令执行预检、快速校验、拟人节奏录制、转换、完整解码验证、生成联系表、哈希、创建清单并清理原始视频。演示需足够简短,控制在转换器默认 10 MB 预算内。

审核与上传限制:上传会消耗 GitHub 存储并修改外部 PR,因此渲染出本地 MP4 后必须停下,展示该确切文件并请求批准;笼统的“录制并发布演示”请求不豁免此检查点。展示前记录绝对路径和 SHA-256 摘要,批准上传前立即重新计算,若变化则重新展示并再次请求批准。不得上传预览、被拒 take、原始 WebM 或用户未审核的文件,也不得把演示媒体提交到仓库。只有明确批准后才读取 publishing.md 并校验清单,保留现有 PR 描述并在末尾追加 ## Preview 段落,仅在用户明确要求时使用 PR 评论。上传后验证渲染,清理临时场景、计划、原始录制和临时 fixture 变更,保留已批准 MP4 直到上传确认。

完成标准:录制讲述一个可理解的视觉故事并以可见证明结束;指针移动平滑、点击有可读停留、光标不跳变;批准产物为 H.264 .mp4 且在 GitHub 适用上传限制内;候选命令生成联系表和清单且上传前仍匹配;用户审核了实际上传的字节;现有 PR 描述保留并以 ## Preview 和已批准内联播放器结尾(除非明确要求评论);GitHub 不含被拒或取代的 take;工作树中不残留媒体或录制专用 fixture。用户对功能、场景、长度、目标或呈现的明确指示优先于本技能偏好,但上传仍需审核最终文件。