# Video To Issue > 将应用或网站的缺陷录屏整理为可提交的 Bug/Issue，提取复现步骤、预期与实际结果、环境和时间戳证据，并在用户要求提交且指定平台后创建问题。用户要录屏转 Bug、写缺陷单或提交视频里的问题时使用；实际复现与修复复测走 defect-verification，服务端根因分析走 log-analysis。 - Skill: `winhok/video-to-issue` (Agent Skill, multi-file: 5 files) - Install (CLI): `npx skillmds@latest add winhok/video-to-issue` - Raw SKILL.md: https://api.skillmd.com/api/skills/winhok/video-to-issue/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - License: MIT - Author: winhok (https://skillmd.com/u/winhok) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/winhok/video-to-issue --- # 缺陷录屏转 Bug / Issue 交付目标是测试人员可以提交和跟进的缺陷单。先确定用户问题、视频来源与时长，读取 [video-review.md](references/video-review.md)；编写或提交时读取 [issue-contract.md](references/issue-contract.md)。只生成抽帧文件不算审阅完成。 1. 使用当前可用的媒体读取工具核对视频时长、帧率/时间基准和是否有音轨。工具缺失或无法观察画面就明确报告，不臆测内容。 2. 对短视频完整审阅；长视频先粗定位再加密异常前后区间。记录已审阅区间、采样间隔和未审阅范围。 3. 建立时间线：用户可见操作、页面/系统状态、异常起止、恢复情况。引用具体时间戳和帧。 4. 将观察组织成 issue-draft.md：标题、环境与构建、前置条件、编号复现步骤、预期结果及其来源、实际结果、时间戳证据、影响和待补充信息。复现步骤只写视频可见或用户明确补充的动作；一次录像不代表已独立复现。 5. 预期没有需求或用户依据时标记待确认，仍交付有用草稿。区分建议严重程度与平台优先级，不编造复现率、根因、设备版本或问题 ID。视频时间与日志墙钟时间必须另行校准。 6. 用户只要草稿时交付草稿；用户明确要求提交时，核对平台/项目和必填字段，使用已连接工具创建 Issue，复用已有授权。提交成功后返回平台实际生成的 ID/链接；缺少工具、目标或必填信息时保留草稿并说明具体缺口。附件上传遵守目标平台权限与当前授权。 7. 后续需要独立复现/修复复测时交给 defect-verification；需要证据登记时读取 [共享执行契约](../_test-run-shared/references/execution-contract.md)。 环境已有 ffmpeg/ffprobe 时，可运行 `python scripts/sample_video.py --input