前言¶
做短视频或宣传片时，常见做法是直接让模型「写个脚本」或手写分镜表。形容词多、镜头时长含糊、平台和素材没对齐，后面渲染或剪辑往往要返工。下面介绍 SkillHub 上的社区 Skill「视频规格构建器」（@user_3c6cb52e/video-spec-builder）：它把 Agent 约束成「导演式追问 + 结构化输出」，目标是在项目里生成或更新带分镜表的 video-spec.md，并可与 HyperFrames 等渲染链路衔接。
这是什么¶
视频规格构建器是面向 AI Agent 的 SKILL.md 技能包，坐标 @user_3c6cb52e/video-spec-builder，版本 1.0.0，来源为 community，发布者 user_3c6cb52e，分类 ai-agent。SkillHub 页面简介为：视频规格构建器专用技能，帮助 AI Agent 高效完成相关任务。标签 requires_api_key=false，安装本 Skill 本身不强制 API Key。
在 SkillHub 上，该 Skill 评分 100000，下载 1229 次（页面数据以 SkillHub 为准）。包内声明兼容 Claude Code、Codex、Hermes Agent、OpenClaw、QClaw、WorkBuddy，平台属性为 multi-platform。SKILL 元数据中的 homepage / repository 指向 GitHub 用户 1991513ccie-png。
核心功能¶
以下能力均来自已发布的 SKILL.md 正文，不展开未随包提供的 references/ 文件细节。
两种工作模式¶
- 0-1 模式：通过对话收集视频需求，主动说明渲染侧可用能力，把需求追到「镜头粒度」，输出含分镜表的
video-spec.md。 - 迭代模式：用户已有
video-spec.md并提出改镜头、节奏、音乐、字幕、配色等变更时，追问澄清、做冲突检测并更新文档。
启动检查¶
Agent 启动后按规则扫描项目目录：
- 精确匹配
video-spec.md，或模糊匹配*video-spec*.md、*分镜*.md、*storyboard*.md。 - 找到 1 个 → 迭代模式；多个 → 让用户选定文件；未找到 → 0-1 模式。
- 可选检查项目根目录是否存在
design.md/DESIGN.md（视觉主题相关，启动时不强制）。
对话与输出原则¶
Skill 强调「能力优先」（用画面描述而非堆技术名）、信息密度（避免空帧、约束镜头时长）、联网核实（参考片、平台惯例、工具版本等）。内置 能力对照表，覆盖 TTS 配音、Whisper 字幕、抠像、各类动效与 3D、shader 转场、画幅与帧率等触发条件。
结构化输出按 templates/video-spec-template.md 的约定（模板路径写在 SKILL 中；当前 SkillHub 下载包仅含 SKILL.md 与 _meta.json，若本地无 references/ 与 templates/，Agent 只能依据 SKILL 正文执行，完整工作流以作者完整仓库为准）。
与 HyperFrames 的关系¶
Skill 描述的项目树中，渲染端为 HyperFrames（示例路径 .agents/skills/hyperframes/，需另行安装）。video-spec.md 生成或更新后，Skill 要求 Agent 提示用户是否用 /hyperframes 启动渲染，由渲染端读取 spec，Skill 本身不再介入渲染细节。
安装与启用¶
先按 SkillHub 安装说明 准备 skillhub CLI；未安装时可执行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别：
skillhub install video-spec-builder --namespace user_3c6cb52e --dir <你的 Agent skills 目录>
SkillHub 文档给出的常见 skills 路径示例：
| 环境 | 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
官方页面亦提示：可将 https://skillhub.cn/install/skillhub.md 交给 AI，让其安装 @user_3c6cb52e/video-spec-builder。安装或更新后按所用客户端要求重启或刷新技能列表。
典型用法¶
用法是「启用 Skill → 用自然语言描述视频或修改意图 → Agent 按模式追问 → 落盘 video-spec.md」。可复现的流程要点如下。
- 在已安装 Skill 的项目或工作区中，说明想做的视频类型（宣传片、产品演示、短视频等）或要改的 spec 内容。
- Agent 执行启动检查，进入 0-1 或迭代模式，并按 SKILL 要求加载对应的
references/workflow-0-1.md或references/workflow-iteration.md（若本地包内无这些文件，需自行补齐作者提供的完整技能目录）。 - 对话中 Agent 对照 question-bank 纪律追问：Phase 1 七维为 gate，后续 Phase 按视频类型裁剪；不接受「高大上」等空形容词，推断内容须标
[待用户确认]。 - 信息充足后，按模板写出或更新项目根目录（与 spec 同基准路径）下的
video-spec.md；若走自定义视觉主题，可能在根目录生成或引用design.md（及可选tokens.css），或选用 HyperFrames 八种预设主题名写入 spec。 - 完成后 Agent 应告知 spec 已生成/更新，并询问是否启动 HyperFrames（
/hyperframes）。
Skill 初始化时会输出固定 ASCII 标识与开场白，随后执行启动检查——这是 SKILL 规定的 Agent 行为，而非终端命令。
适用场景与注意¶
适合：需要 Agent 长期扮演「分镜策划」，把模糊 brief 拆成可执行 spec、并统一记录平台、素材、节奏与组件 ID 的团队或个人；计划接 HyperFrames 或同类「读 spec 再渲染」流水线的项目。
注意：
- SkillHub 当前下载包体极小，SKILL 内引用的
references/、templates/、examples/在包内可能不存在，实际效果取决于你是否部署完整技能树。 - 渲染、TTS、3D 等能力是对下游渲染层的描述与激发用户选项，不等于本 Skill 自带可执行二进制；做不到的能力 SKILL 要求直接说明。
requires_api_key=false仅指 Skill 安装层面；若后续渲染或联网搜索依赖外部服务，仍需各自配置密钥或环境。- 与同名变体（如
video-spec-builder-y7x1）不同，本文仅对应坐标@user_3c6cb52e/video-spec-builder，安装时注意 namespace 与 slug。
结尾¶
视频规格构建器把「写脚本」变成「追到镜头级并输出 video-spec.md」的 Agent 工作流，适合作为视频前期 spec 阶段的技能约束。安装与详情见 SkillHub：视频规格构建器，API 坐标页：api.skillhub.cn/user_3c6cb52e/video-spec-builder。
