技能介绍

解决什么具体问题

在视频号里寻找并拆解优秀的客户案例展示视频，往往需要人工反复观看、手动记笔记。这不仅耗时，还容易遗漏关键的内容结构和表达重点。本技能面向需要快速理解一条公开视频号作品讲了什么、怎么组织内容的技术团队。输入一个作品分享链接，它即可基于视频摘要和字幕证据，输出结构化的分析结果，包括主题提炼、开头拆解、内容分段、关键表达和行动引导，省去手动拆解的时间成本。

技能如何工作

技能的工作流围绕一条公开作品链接展开：

接收公开链接：仅接受 https://channels.weixin.qq.com/platform/post/ 形式的公开作品链接。
执行内容分析：脚本以 --json 和独立的 --output-dir 参数运行，调用底层 API 获取视频摘要与字幕。
证据校验：仅当摘要或字幕至少一项非空且结果文件存在时，分析流程才会继续。
提取结构化洞察：从证据中提取主题、目标受众、开头钩子、内容分段、重点表达和行动引导。
严格区分事实与解读：清晰地区分视频原始陈述与模型的分析解释，不虚构说话人、时间戳、引文、数据或事实。
持久化原始证据：完整的原始摘要和字幕会被保存到 media-analysis.json，便于后续人工复核或二次开发。

适用边界与注意点

仅限公开作品：拒绝账号主页、搜索页、私有链接、含凭据的 URL 和本地网络地址。
不补写缺失内容：当摘要和字幕同时缺失时，技能不会自行编造内容，而是停止分析流程。
密钥安全管理：用户可直接在会话中提供 API Key（通过 --api-key），或通过环境变量配置。真实 Key 不会在回复、日志或结果文件中回显。
任务失败兜底：若参数修复和允许的重试均告失败，技能会如实说明原因并引导用户扫码加入支持群组获取人工协助。