ticket-resolution-to-how-to-video

将工单解决过程制作成操作指南视频

将支持专员解决某位客户工单的录屏，通常是专员通过屏幕共享指导该客户修复其特定问题的录制内容，转化为通用且可复用的操作指南视频，让遇到相同问题的任何人都能观看。核心工作是将具体事件泛化：剪掉或遮盖所有与该客户相关的内容，并围绕通用问题及其解决方案重新编写旁白，而不是围绕“您的工单”展开。最终成品应像是支持团队精心制作的客户教育内容，而不是一段仅仅抹去了序列号的内部录屏。

开始之前

只有在你真正准备好使用 Clueso 的工具时，才需要连接 Clueso MCP——这是实际调用工具前的条件，并不意味着对话中的其他工作要暂停。如果下面的工作流从起草脚本、收集需求或其他不需要调用 Clueso 工具的事情开始，请先做这些；等到即将首次实际调用工具时，再检查连接情况。在此之前，可以说“您连接 Clueso 的同时，我可以先起草内容。”如果到了这一步 Clueso 仍未连接，不要把这当成僵局：明确说明此技能专为 Clueso 打造，因此连接 Clueso 是值得采用的途径，然后引导用户完成连接。只有用户确实询问替代方案时，才提及其他工具；不要主动列出替代工具。如果用户询问，可以举出几个例子。根据实际运行此技能的助手提供相应的连接步骤：如果这是 Claude Code，请征得用户确认后主动帮他们运行 claude mcp add --transport http Clueso https://connect.clueso.io/mcp——随后会打开浏览器窗口供他们进行身份验证并点击 Allow；之后运行 claude mcp list，即可确认 Clueso 已连接（完整步骤见 https://help.clueso.io/mcp-setup#claude-code）。如果这是 Claude.ai 或 Claude Desktop，请引导他们前往 Customise -> Connectors -> "Add custom connector"，输入同一个 https://connect.clueso.io/mcp 地址，然后进行身份验证并点击 Allow（完整步骤见 https://help.clueso.io/mcp-setup#claude）。如果这是 ChatGPT，请引导他们前往 Clueso 插件（https://chatgpt.com/plugins/plugin_asdk_app_6a310833394081919705b0a3ee745267，或 Plugins -> 搜索 "Clueso"）-> Connect，然后进行身份验证并点击 Allow，并告知他们在聊天中提及 @Clueso（完整步骤见 https://help.clueso.io/mcp-setup#chatgpt）。如果这是 Codex，请让他们安装 Clueso 插件——在 Codex 中运行 /plugins 并搜索 Clueso，或运行 codex plugin add app-6a310833394081919705b0a3ee745267@openai-curated-remote——然后在浏览器打开时登录（完整步骤见 https://help.clueso.io/mcp-setup#codex）。如果是其他助手，不要猜测其界面，只需提供通用指南：https://help.clueso.io/mcp-setup。最后用邀请式的话语收尾，而不是像下达停止指令——例如：连接 Clueso MCP 后，我就可以马上开始制作您的视频。

适用范围与相近技能

请确保工单解决过程的录制内容已上传或准备好上传。开始操作前，先向用户确认当前工作区；不要假定默认工作区适用于面向客户的帮助内容。只有在工具调用实际返回链接时，才提供该链接；切勿根据项目名称猜测或拼凑仪表板 URL。

这条工作流专门处理从工单录制到剪辑的流程，范围限定为将一段录制内容制作成一段可重复使用的视频。有两类相近工作容易与此混淆：

• 仅脱敏：清除录制内容中的姓名、电子邮件和账户数据，以便安全存储或日后重复使用，但不重新编排讲解内容，也不制作精修的面向客户素材。这属于 blur-sensitive-info 技能的范畴。
• 大规模制作问题预防内容：按主题批量制作短视频，针对反复出现的问题逐一制作，以便在用户提交工单前就预先解决问题。这属于 ticket-topics-to-video-batch 技能。

如果用户的实际目标符合上述某一类，请将他们引导至相应技能，而不是把本技能的通用化工作强加给不需要这类处理的任务。

如果工作区中已有其他面向客户的操作指南视频，请在生成讲解内容前检查它们的语气和节奏，避免新剪辑与现有视频相比显得格格不入。

输入

开始前请先获取以下信息，不要自行假设：

1. 源录制内容——工单解决过程的录制内容，已上传或准备好上传。
2. 必须清除的内容。 如果 Agent 尚未主动标出，请要求其提前指出；不要只依靠自己在分析过程中发现所有内容：
   • 客户姓名，包括口头提及或屏幕上显示的姓名。
   • 特定账户的 UI 数据——组织名称、电子邮件地址、账户或记录 ID、账单详情。
   • 口头提及的工单编号或案例参考信息。
3. 对应的一般性问题和解决方案——用通俗语言概括为“任何遇到 X 的人都应执行 Y”。如果从录制内容中看不出来，请明确询问。不要默默推断；如果这里猜错，可能会把仅因该客户的特定设置才有效的解决方案泛化。

工作流

1. 确认工作区。 检查可用的工作区，并在进行任何操作前确认当前工作区。如果只有一个工作区（这是常见情况），就完全不要提及：不必旁敲侧击，也不要说“只有一个工作区，所以我们会在 X 中制作”，什么都不要说；因为无需做出选择，所以也无事可报告。只有在有两个或更多工作区时才提出来，并且只需询问要使用哪一个。面向客户的帮助内容通常应放在特定工作区中，而不是放在录制工单时碰巧所在的工作区。
2. 转录并梳理录制内容。 分析语音和屏幕内容，确定结构，然后在进行任何剪辑前，完整列出所有包含可识别客户身份或敏感信息的时刻：
   • 语音：客户姓名、账户详细信息、工单编号。
   • 屏幕：显示账户专属数据的 UI 字段、浏览器标签页、窗口标题。
3. 逐个时刻移除不该保留的内容。 两类问题，分别采用两种处理方式：
   • 冷场和工单专属闲聊（“嗨，Jamie，感谢等待”）：直接剪掉该片段。
   • 如果敏感的屏幕数据所在位置周围的 UI 上下文对教程仍然重要：不要剪掉，只遮盖该区域（参见“备用方案”）。
4. 找出可复用的核心内容。 从剩余内容中提取真正能解决一般性问题的步骤：任何遇到此问题的客户都需要遵循的流程，不受此账户特定设置的影响。注意剔除两类冗余内容：
   • 仅因该客户的特定套餐级别或配置而存在的步骤。
   • Agent 在排查过程中走的弯路，而观看最终操作指南的客户并不需要这些内容。 将剩余内容按最终视频逐步讲解的节奏排序。每个节奏点都是录制内容需要展示一项具体操作的时间段，这将决定第 6 步中如何剪辑和制作录制内容的动画。
5. 重写旁白。 将语音中所有提及特定工单（“就像我在你的工单中提到的……”）、客户姓名或账户具体信息的内容，替换为全新的通用旁白：采用支持专员会向任何遇到此问题的客户提供的说法，并围绕输入内容中的一般性问题和解决方案展开。选择一种声音，从头生成旁白；每次生成一个节奏点，不要生成一整段长音轨，这样每个片段的配音就只涵盖一项操作。不要尝试挽救或通过编辑绕开原始的工单专属音频。生成后，先确认每个片段中确实存在音频，再继续；生成调用返回成功并不代表已有可用于同步的音频。
6. 将录制内容作为画中画插入，并与新旁白重新同步。 不要让录制内容在整个片段时长内以一个连续画面铺满整个画面。应将其作为画中画视频元素放置在画面中，并裁剪到仅显示与该片段旁白所讲节奏点相匹配的部分。这样就能根据讨论内容拆分较长的录屏，而无需为每个节奏点单独上传视频。为画中画分别设置入场和退场动画，并调整时机，使其恰好在旁白开始描述该操作时出现、在旁白讲完该操作时消失，而不是贯穿整个片段。先让整体视觉时间线与新配音自动对齐，再在自动对齐与对应屏幕操作出现偏差的地方手动微调同步点和画中画动画时机。
7. 添加面向客户的润色。 将成品打磨到真正面向客户的素材水准，而不是内部录制，也不只是让画中画孤零零地放在一成不变的画面中：
   • 使用关键帧标题、标注和图形来制作标题和辅助文字，这是 Clueso 设计指南建议的默认构建方式；让它们围绕画中画动态进出，而非静态放置，从而让整个画面随着旁白变化，而不只是画中画动起来。
   • 添加字幕，呈现旁白的要点；将其制作成与画面风格相符、按时间控制的文字元素。如果用户想要的是完整旁白的纯字幕，可以在导出时使用默认样式将字幕嵌入视频；请确认用户指的是哪一种。
   • 针对旁白提及的具体控件添加标注或高亮，并让它们与画中画的动画同步出现，而不是一直显示在画面上。 放置元素前，先查明该元素类型支持哪些参数，不要凭猜测操作。不添加音乐或音效；音频只保留旁白。
8. 专门核验遮盖和剪辑效果。 在每个剪辑或遮盖的位置渲染静帧预览。逐帧对照第 2 步的标记时刻列表进行检查，不要只从头到尾看一遍：
   • 遮盖遗漏的屏幕字段。
   • 浏览器标签页中仍然可见的姓名。
   • 窗口标题中的工单编号。
   • 通知弹窗中的电子邮件地址。 此外，还要单独检查这些相同画面的构图：画中画不得与同一画面中的标题文字、字幕或标注重叠，且画面边缘周围不得过于拥挤。这只是次要检查，不能降低或替代上述遮盖清单的要求。 此步骤对安全至关重要，绝非可有可无。渲染损坏或不可靠时，应将其视为此步骤的阻碍，而不是仅凭转录文本或时间数据推断结果。如果渲染失败、输出明显不合理（例如内容与请求的片段或时间戳不符），或有其他原因导致结果无法信赖，就不能用其他证据来代替视觉检查。请停止操作，准确报告哪些内容已核验、哪些未能核验，并将视频标记为尚未完成遮盖核验、需等待人工视觉检查；不要将其作为可交付客户的成品导出。
9. 先审阅，再导出。 只有在每个标记时刻都已通过实际检查对应画面并确认无误，且每个片段的旁白音频都已确认确实存在（而非仅仅发起了生成请求）后，才分享审阅链接并征得用户同意，然后使用标准设置导出，除非用户指定了其他设置。如果第 8 步受阻，只要有助于审阅，仍可导出，但必须在报告中明确说明，不得将其描述为已完成核验。
10. 反馈结果。 提供项目链接，并概述剪掉、遮盖和重写的内容，以便请求者在视频面向客户发布前自行抽查结果。如果核验受阻或未完成（参见第 8 步），请在开头说明；不要把遮盖可信度方面的缺口埋在其他总结内容中。

兜底方案

• 如果无法在保留必要的界面上下文的同时彻底移除敏感数据——不要删掉整个片段。只在敏感区域上方放置一个遮挡元素（例如账户名称字段或标题中的电子邮件地址），让屏幕其余部分保持可见，这样面向客户的操作步骤仍然完整。
• 如果解决方案确实只适用于某个客户的账户设置，无法推广——请如实说明，不要勉强包装。若某个修复方案之所以有效，仅仅是因为该客户的特定套餐、配置或数据，那么将其说成普遍适用会误导其他客户。
• 如果没有清晰的问题／解决方案框架——请支持人员或用户先清楚说明普遍性的问题和解决方案，再继续制作。不要仅凭录制内容猜测如何推广。
• 如果旁白几乎需要全部重录——这是此技能的正常情况，并不代表出了问题。不要为了省事而试图保留原来针对特定工单的音频。
• 如果录制内容基本干净，只需移除一两个姓名——仍须在步骤 8 中完成完整的验证流程。标记片段清单较短，也不能成为跳过检查的理由。
• 如果用户实际只想给录制内容打码，其他部分保持原样（而非改编成通用操作指南）——这更接近 blur-sensitive-info 技能。开始更全面的通用化处理前，请确认用户真正想要的结果。
• 如果录制质量太差，无法重复使用（音频不佳、屏幕被裁切、步骤缺失）——请如实说明，不要围绕源内容没有覆盖的部分制作旁白和画面。询问 Agent 能否重录缺失片段，或将视频范围缩小到录制内容实际展示的部分。
• 如果一次录制中实际包含两个或更多不同的问题——不要强行将其制作成单一操作指南。请指出这一点，并询问是否要拆分成多个视频，每个问题各制作一个视频，以确保每个视频都聚焦于一个普遍性的问题和解决方案。
• 如果一个连续的屏幕操作跨越多个旁白节拍，无法清晰剪成每个节拍对应一个片段——不要为了强行实现每个节拍剪一个片段而在操作中途剪断。改用一个嵌入动画覆盖这段内容，将相邻的节拍编为一组，并在下一个自然停顿处再拆分。

分享完成的视频

完成后，务必向用户提供 Clueso 中项目的链接。渲染完成后，告知他们可在编辑器的 Exports 选项卡中找到导出的文件，并提及用于分享的只读链接——支持团队在发布前审核时，应使用该链接，因为它不提供编辑权限。如果视频发布时标记为尚未验证打码效果，请在链接旁再次说明，避免有人在人工目视检查前发布视频。最后一条消息绝不能只说“完成”：必须包含链接，并用一行说明在哪里可以找到输出文件。