tk-video

通过视频进行说明

根据观察到的软件状态或明确标注的说明卡片，制作所选的 MP4 或 GIF。本技能不涵盖编辑现有视频和无关的电影制作。视频用于传达流程，不能证明应用程序的正确性、延迟、性能或读者是否理解。

规划和收集

确定受众、主张、所选格式和可用场景来源。如果动效本身不是要表达的主张，优先使用静态图。十秒左右的简短流程通常适合 GIF；较长的说明则适合 MP4。复用已提供的材料和已批准的选择，不要再进行常规确认。对于面向用户的教程，如果尚未选择旁白和光标／输入叠加效果，则应在同一项既有选择中结合格式一并确定。为字幕留出足够的阅读时间，并为经过测量的旁白至少留出 800ms 的缓冲时间。放大之前，先规划每个裁剪区域和高亮区域。

列出每个场景的来源、字幕、可选旁白，以及停留时间或观察时间戳。对于渲染出的卡片，使用受众语言在角落添加来源标签，并在每个带标签的帧中声明 source_in_picture: true；否则保留本地化的字幕标签。切勿重演无法获取的软件行为，也不要将示意图伪装成捕获画面。明确标注主张、来源版本和未经验证的时间区间。对于真实浏览器状态，如果演示或说明没有验收标准，则使用 phase: media-capture 调用 tk-browser-verify；如果明确要求验收检查，则保留其验证约定，并可选用动态证据补充。对于原生窗口，调用 tk-app-verify。这些工具的负责人会处理提供方、身份验证、测试数据、实际输入／捕获和资源生命周期。返回本技能时，提供按顺序排列且适合发布的帧路径及其来源信息。不要导入兄弟技能的脚本路径。如果无法使用相应负责人所需的工具，请报告缺少的捕获；不要臆造替代方案。

使用已有的渲染器制作卡片，并保留其创作源文件。HTML 卡片可使用已获批准的无头渲染边界；已安装的绘图／渲染工具也可以使用。选择视频不会导致安装依赖项或附加用户配置文件。

组装和检查

阅读 组装说明，了解场景／捕获清单、负责管理的路径和命令。使用 explainer 停留时间进行演示，并在 evidence 模式下保留实际时间戳。断言截图应保持原样，且独立于视频。使用捕获帧率（最高 30fps）的 H.264 MP4，可选配单声道 48kbps AAC；GIF 和说明视频静帧默认使用 10fps。MP4 默认使用 CRF 18；使用组装工具的质量／码率覆盖选项，并保留源分辨率。遇到不可用工具时，按照前置条件恢复流程处理。 如果通过已安装工具检查后仍缺少硬字幕支持，则在返回受阻结果前，先通过 tk-wizard 提出安装指导问题。不要采用帧合成的变通方案。

对于选用的生成式旁白，通过受支持的技能加载／交接调用 tk-tts；阅读 旁白说明，了解测量后的音频与场景对齐方式。如果选用了已提供的音频，则予以复用。组装工具使用普通 WAV 文件，不会导入 TTS 引擎。选择 TTS 后必须生成实际且已验收的非静音音频；合成缺失时，不应提供无声的旁白预览。

运行成品媒体检查，并检查生成的联系表和有代表性的解码帧，包括初始／最终状态以及每个重要字幕或场景切换。对于选用了旁白的情况，返回 human_action: listen，并提供需检查的名称／编号／术语及相关样本路径；在用户确认含义、发音和截断情况之前，将其保持为待处理状态。通过解码检查不等于完成视觉或发音检查。明确指出未检查的时间区间，并报告实际限制。修复有缺陷的剪辑并重新运行受影响的检查；绝不要修改回执来让视频通过检查。

返回

返回可直接使用的媒体，并提供其绝对路径、模式／时长、来源、字幕／音频状态、媒体检查结果、 检查限制和发布选择。将受阻或未通过的质量检查与应用验证分开报告。缺少硬字幕支持时，应保留软字幕回退方案，不得声称已完成烧录字幕。保留输入和失败证据；只有用户确认所选结果且其解码／检查完成后，才清理已知且由本次运行拥有的临时文件。 在此之前，保留可复用的帧／音频／清单，并报告保留帧的字节数。 通过资源所属的验证器释放捕获资源。

生成并不代表获得发布授权。只有在另行获得上传授权时，才将手动选定的附件交给 tk-pr-media。 此技能不会更改任何应用源代码、Git 状态、全局设置或凭据。它只会创建用户请求的视频、场景源文件和本次运行拥有的证据，以及选定的音频产物。tk-tts 负责其另行批准的安装和模型缓存。

设计来源和有意省略的内容记录在来源中。

旁白选择

在制作任何视频或口播幻灯片之前，先询问创作者选择 TTS、提供音频还是不加旁白。沿用父级／用户已作出的选择；用户偏好视频或语音并不代表同意使用 TTS。合成／组装前，展示当前 tk-tts 的模型／语音／设备／设置选项。保留无旁白选项；如需 GIF 音效，可提供 MP4。静态 HTML／文本无需进行无关的语音偏好问询。安装／下载／发布各自都需要单独授权；播放静音／回退选项则相互独立。

产物路径

产物操作需要任务授权。写入／检出／传输／设置忽略规则之前，请阅读产物路径，了解 Git 排除规则／路径／所有权检查。复用上下文中完全相同的内容；存在不确定性时进行哈希检查，并重新读取变更／丢失的内容；始终重新检查安全性。除非明确指定目标位置，否则使用 .tigerkit/。仅聊天场景：跳过文件／忽略规则设置和此参考文档。这不授予任何无关的修改／发布权限。对于经授权的非敏感内容清理，优先使用新建目录和受支持的回收站；目标只能是记录在案的、字面明确且已解析为绝对路径的本次运行所属路径，绝不能使用 cd 加通配符／相对路径删除。

用户问题

调查事实；沿用已有授权。对于由用户决定的事项，请阅读 问题轮次；其他情况则继续处理。 纯聊天中，即使只有一个审批请求，也要先单独输出 ---，然后 每项按 ❓ **Q<n> · <title>**: <question> 和 ➡️ <recommendation> 的格式填写。 只询问前置条件已明确的问题；审批需单独处理。 问题放在最后；先写状态、风险和计划。

技能反馈

对于可复用的事件，在当前对话中保留最少量的非敏感证据， 并建议使用 tk-retro；除非用户要求，否则不要将其写入持久记忆。 调用、反馈产物、已安装技能的修改和发布，均需通过所属工作流单独授权；此处的说明不授予任何权限。

面向读者的结果摘要

简要说明结果，包括实际验证情况、重要限制 和可直接访问的交付物链接。区分计划／跳过的检查与已执行的工作； 保留未完成的手动检查以及实际的清理、阻塞或人工操作详情。 绝不声称未验证的工作已完成，也不声称已完成清理。保留所有者要求的产物、 发布预览、审批边界、机器返回内容、确切状态／页脚及最终问题区块；嵌套返回应保持简洁，并省略空白章节。

输出规范

使用 ASCII 编号（1. Item、(1) Item）和 - Item，不要使用带圈或键帽数字。 显示完整的绝对可点击文件路径，包括示例，不要使用省略号。 除非获准编辑，否则保留代码、命令、标识符、URL、引文和已核实的 UI 标签原样。

对于包含多个共同属性的聊天比较，使用窄版 GFM 管道表格（约四列，包含表头，单元格内容简短）；其他情况使用列表。不要使用框线字符、围栏式表格或空表格。特定所有者的预览优先；发布正文和文件产物保留各自的表格格式。

在渲染后的 Markdown 正文中，范围使用连字符，字面波浪号使用 \~ 转义；代码、引文和标识符保留原样。

对于获准使用的临时输入文件，创建和使用前请遵循 Artifact Paths；预填模板不算已完成的输入。这不授予任何写入权限。