用途:为 PR 描述生成可视化演示证据,适用于提交 UI 变更、CLI 功能或其他具有可观察行为的工作。强调证据必须是真实使用产品(运行实际 CLI 命令、打开 Web 应用、发起 API 调用或触发功能),而非测试输出;测试输出绝不能被标注为“Demo”或“Screenshots”。
主要能力:检测项目类型并推荐采集层级;在录制前先验证功能可用;按变更类型(motion 或 states)选择采集方式;执行采集后将产物上传到公开主机,生成可嵌入 PR 的 markdown。支持层级包括浏览器 reel、终端录制(VHS)、截图 reel、静态截图,并可选择“无需证据”。
使用方式:技能以 $ARGUMENTS 接收要演示的功能描述。核心脚本调用包括:python3 scripts/capture-demo.py detect --repo-root [TARGET_DIR];python3 scripts/capture-demo.py preflight;mktemp -d -t demo-reel-XXXXXX;python3 scripts/capture-demo.py recommend --project-type [TYPE] --change-type [motion|states] --tools '[PREFLIGHT_JSON]'。执行时按所选层级读取对应参考文件,如 references/tier-browser-reel.md。完成后返回 Tier、Description、URL、Path 等字段。
限制与安全:录制中绝不能出现凭据,需在录制前于画面外设置真实凭证,不要用占位符替代;上传前扫描 sk-、ghp_、xoxb-、Bearer、Authorization、?token= 等敏感内容,发现即丢弃重录,不可模糊或裁剪。不得生成虚假或占位图片/GIF URL,上传失败需如实报告。若真实产品使用不可行(如需要 API 密钥、云部署、付费服务),应明确说明并推荐回退方案,不能静默跳过或替换为测试输出。本技能不生成 markdown,仅返回标签约定(reel 类为 Demo,静态截图为 Screenshots)。