用途:当 GitHub 或 Linear 的 issue、PR、评论附带屏幕录制,或附件指向 uploads.linear.app、GitHub 附件、Screencastify 观看页时,用该技能把视频转写为带时间戳的文本证据,而非模糊摘要。
主要能力:通过脚本 scripts/generate_video_transcript.sh 处理本地文件路径或远程 URL,输出固定 XML 结构,每个观察到的动作或系统响应一行 [MM:SS] (...),可引用清晰可见的 UI 文本,只描述可见动作、屏幕变化和可听语音,不臆造隐藏状态或实现细节。默认使用 gemini-3.1-flash-lite-preview,输出异常时回退到 gemini-3-flash-preview;Gemini 3 模型强制最小思考。可用 VIDEO_TRANSCRIPTS_MODEL 环境变量或 --model 参数覆盖模型。
使用方式:每次针对一个相关视频运行一次,并给出简短、聚焦 bug 的 --title。例如:bash <skill>/scripts/generate_video_transcript.sh "https://uploads.linear.app/.../screen-recording.mov" --title "PDF preview hyperlinks trigger leave-page modal"。本地文件传绝对路径。Linear 上传会自动尝试本地 Linear 桌面应用 cookie;私有 GitHub 资源会尝试 GITHUB_TOKEN、GH_TOKEN 或 gh auth token。Screencastify 支持需要 ffmpeg。需要 GEMINI_API_KEY 或 GOOGLE_API_KEY。可用 --debug-dir 保存请求与响应产物。
缓存与发布:跟踪类工作的共享缓存应放在 tracker 中证据旁;缓存正文以 [Transcript] 开头,后接时间戳行,缓存时去掉 XML 包装行。Linear 签名 URL 应去掉查询串,Screencastify 用稳定 watch URL。重新转写前先按来源容器匹配缓存,只转写缺失或新增视频。不要用 docs/ 存放原始 tracker 转写缓存。公开可读的评论需明确发布授权,未授权时仅在本地准备或返回转写。
限制:仅依据资料,未提供收费、价格、平台支持范围等更多信息;Screencastify 需 ffmpeg;无 API key 时会尝试 ~/.bash_profile 后失败。