关于 media-analysis
media-analysis 是指导 Agent 分析视频和图像的技能,优先使用本地帧与可见字幕回答视觉问题,并明确证据范围和音频局限。只有重要语音信息仍无法确认时,才按规定流程使用云端分析。
主要功能
- 01生成带时间戳的联系表
- 02检查本地视频帧与图像
- 03按需细化短镜头取样
- 04规定云端分析的使用条件
- 05保存结果并说明证据局限
适用场景
- 01从视频帧梳理场景顺序
- 02核对画面中的文字与产品
- 03字幕不足以回答时分析语音
- 04根据既有帧和报告回答后续问题
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ postplusai/ postplus-skills --skill media-analysis安装后在 Claude Code 中输入/media-analysis确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/ordered-image-evidence.mdsingle-video-report.mdvideo-analysis.mdvideo-frames.md详细介绍
原文在翻译后有更新,译文可能不是最新。
媒体分析
分析用户的链接、本地文件或可见图片,并给出可读的 发现结果,附上实际的视觉证据。在内部选择必要的工作。
对于多参考对比或要求提供详细的逐镜头证据,请阅读 多源镜头分析。这一分支 在综合之前保持各来源独立;普通分析会跳过它。
选择工作
- 视频理解: 使用
postplus media analyze video-analysis处理 动作、声音、对话以及随时间的发展。传入原始来源; 命令行负责获取和传输。阅读执行与恢复。 - 可读图片: 直接查看它们。对于已经可以在对话中或本地 访问的图片,无需下载、上传或 Gemini 调用。
- 原生图片帖子: 使用
postplus media prepare --source <url>,然后 检查按顺序排列的原图。阅读图片证据。 - 截图、文字、颜色或布局: 查看足够的图片或本地 视频帧,而无需购买完整视频分析。阅读视频帧。
由静止图像制作的 MP4 仍是具有真实时间线的视频。准备工作必须 返回实际的本地文件,然后才能将其视为已下载的证据。 将多个来源、失败和输出彼此分开。根据现有报告和证据回答 后续问题,而无需另一次付费分析。
视频命令
postplus media analyze video-analysis \
--video ./reference.mp4 \
--output ./result.md
遵循命令行的结构化结果和报告的下一步操作;不要从自由文本消息中推断恢复。 在要求时等待用户明确批准;某项操作并不授权支出、发布或覆盖。 通过其返回的检查点或操作恢复同一操作;切勿重新提交不确定的工作、重复已耗尽的恢复,或切换提供商以绕过失败。
省略 --prompt 以获得视频报告中描述的
默认镜头表和生产说明。针对用户
的具体问题或要求的格式提供它;不要附加无关的完整报告。
video-analysis 是命令行能力键,而不是另一个 Skill。
仅在构建或修复未知的托管媒体请求结构时使用 postplus media schema --json;对于
正常分析路径,保留上面生成的命令。
交付
在对话或 Markdown 中嵌入已检查的图片或真实截图, 并附上来源、原始页面索引或测得的视频时间戳,以及每项所支持的观察。 仅提供路径或文件夹链接不构成视觉交付。切勿用封面、生成图像或猜测的描述 替换缺失的证据。
对于长报告,在聊天中展示代表性帧,并链接完整的 Markdown。 保持返回的模型 Markdown 不变;在单独的证据说明中添加 Agent 查看过的截图和任何 更正。使用相对链接将附件保存在报告旁边,验证这些链接,并在临时清理后保留它们。 切勿删除用户文件或已交付的证据。
说明缺失的页面、无法读取的文字、不可用的音频以及已检查的子集。 少量帧不能证明完整的音频/视频覆盖。区分可见事实、 捕获的措辞、解释以及需要外部验证的说法。
恢复
在等待期间报告观察到的进度。让命令行执行有界恢复; 在断开连接的等待之后,对同一任务、账户和环境使用其输出的轮询或检查点命令。不要重启不确定的付费分析。 内容质量问题或改写请求不授权付费重做。
对于远程工作开始前明确的本地参数拒绝,使用该命令的 --help 和现有用户输入进行一次更正。如果提交可能已经开始,仅遵循其输出的恢复命令。在就绪失败后,使用 postplus doctor --skill media-analysis 进行就绪诊断。如果提交可能已经发生,保留任务身份。
在现有明确成本授权足够时,遵守报价质询;否则请求批准,然后使用提供的确认/重试命令。
对于终端失败,给出其阶段、原因、操作 id(如果存在)、成本状态和具体的下一步。未知结果不代表没有收费。交付有用的部分证据及其限制;绝不要声称分析了未见过的材料。