前言¶
数据分析做完之后，图表和结论往往还停在文档或静态图里。若要把同一套分析结果做成可播放的讲解视频，通常要单独写分镜、录旁白、再对齐时间轴，和前面的分析流程是两套工具链。byteplan-video 面向「已有分析数据、需要成片」这一步：在 Agent 里作为 Skill 使用，把分析输出转成可视化视频，并依赖 Remotion 完成渲染。
这是什么¶
byteplan-video 是 SkillHub 上由社区发布者 user_801e2aaa 维护的 Skill，坐标为 @user_801e2aaa/byteplan-video，当前版本 1.0.4，分类为 design-media，来源为 community。页面标注 requires_api_key=false，即按官方说明不依赖额外 API Key 配置。
它解决的问题可以概括为：根据已有的分析数据生成数据可视化视频，并支持自动分镜、语音合成与音画同步。官方说明明确要求：需要先使用 byteplan-analysis skill 完成数据分析，再在本 Skill 中消费分析结果做视频。
核心功能¶
以下能力均来自 SkillHub 官方简介，未在页面展开的细节不作延伸：
- 数据可视化视频：以既有分析数据为输入，生成可视化向的视频内容。
- 自动分镜：由 Skill 侧处理分镜逻辑，减轻手工切镜头。
- 语音合成与音画同步：生成旁白并与画面时间轴对齐。
- Remotion 渲染：使用 Remotion 作为渲染引擎输出成片。
安装与启用¶
通过 SkillHub CLI¶
若本机尚未安装 SkillHub CLI，可先检查版本：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（示例为官方推荐命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，必须用 --dir 指向当前 Agent 实际使用的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法识别。官方示例：
skillhub install @user_801e2aaa/byteplan-video --dir <skills 目录>
常用客户端的 skills 路径（摘自 SkillHub 安装文档，按你当前环境选用其一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后若 Agent 未立刻加载新 Skill，需按你所用客户端的说明刷新或重启后再试。
通过对话让 AI 安装¶
SkillHub 页面提供的安装提示为：让 AI 根据 SkillHub 安装说明 安装 @user_801e2aaa/byteplan-video。在 Cursor 等支持 Skills 的客户端中，可将该坐标与安装文档一并交给 Agent 执行。
典型用法¶
官方资料未给出逐步复制的命令行示例或配置文件字段。可复现的工作流仅能从简介归纳：
- 先安装并启用 byteplan-analysis，完成数据分析，得到本 Skill 所需的分析数据。
- 安装 byteplan-video 到当前 Agent 的 skills 目录。
- 在对话中说明要基于已有分析结果生成可视化视频，由 Agent 按 Skill 指引调用自动分镜、语音合成与 Remotion 渲染。
具体输入格式、输出路径与 Remotion 项目结构以 Skill 包内 SKILL.md 及随包说明为准；本文不编造未在官方页面出现的配置项。
适用场景与注意¶
适合谁：已经在用 Agent Skills 做数据分析流水线，且希望把 byteplan-analysis 的产物直接延伸为讲解类数据视频的团队或个人。
依赖与限制：
- 数据分析阶段依赖 byteplan-analysis，不能跳过。
- 渲染侧依赖 Remotion；本地或 CI 环境需满足 Remotion 运行与导出要求（细节见 Skill 包说明）。
- 社区来源（
community），使用前可在 SkillHub 页面查看版本与作者信息；评分与下载量以商店展示为准（抓取时页面约为评分 100000、下载 700、安装 10，会随时间变化）。
注意：不同 Agent 的 skills 目录不同，安装时 --dir 必须对准当前客户端路径，避免装错目录导致「已安装但不可用」。
结尾¶
byteplan-video 把「分析结果 → 分镜 → 旁白 → 音画同步 → Remotion 成片」收进一个 Skill，并与 byteplan-analysis 形成前后衔接。需要安装或查看更新时，可打开 SkillHub 页面：byteplan-video；API 坐标页为 https://api.skillhub.cn/user_801e2aaa/byteplan-video。
