前言¶
短剧、漫剧进入分镜与美术设定阶段时，制片和美术往往要手工从剧本、分场表、人物小传里摘场景、角色和道具，再整理成给原画、动画用的说明。资料分散在 Word、表格和聊天记录里，漏项、口径不一致很常见。下面介绍 SkillHub 上的 短剧资产清单生成（@ihangfeng/hf-drama-assets），把多源前期资料交给 Agent，按 Skill 约定输出严格 JSON 的资产清单，并附带面向制作的视觉描述。
这是什么¶
短剧资产清单生成 是航峰汇智在 SkillHub 发布的企业类 Skill（分类 design-media，版本 1.0.0）。坐标为 @ihangfeng/hf-drama-assets；官方入口为 SkillHub 技能页，API 标识为 https://api.skillhub.cn/ihangfeng/hf-drama-assets。
它面向「已有剧本与前期文档、尚未落成统一资产表」的团队：根据你提供的正文与参考资料，提取并整理短剧资产清单，而不是替代编剧或分镜创作本身。
核心功能¶
依据 SkillHub 公开简介，该 Skill 在核实范围内具备以下能力：
- 多类输入：短剧剧本正文、分剧集分场景镜头列表、人物小传、主要场景信息，以及其他参考资料。
- 三类资产输出：场景清单、角色清单、道具清单，统一为严格 JSON，便于下游脚本、表格或制片系统接入。
- 制作向描述：为原画师、动画师整理清晰的视觉描述，减少美术从散文式剧本里二次解读的成本。
- 适用体裁：漫剧、短剧、动画、动态漫画；也适用于分镜前期、美术设定与制片侧的资产拆解。
- 无需 API Key：标签标明
requires_api_key=false，不依赖额外密钥配置即可按 Skill 流程使用（仍取决于你所用 Agent 与模型能力）。
SkillHub 页面显示评分 100000，下载约 1004 次（统计以页面为准，会随时间变化）。
安装与启用¶
该 Skill 遵循通用 SKILL.md 格式。SkillHub 建议两种方式之一完成安装。
方式一：让 Agent 按官方指引安装¶
将 SkillHub 页面上的安装提示发给当前 AI，大意是：根据 SkillHub 安装文档，安装 @ihangfeng/hf-drama-assets。
方式二：使用 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
路径与参数以 skillhub.cn/install/skillhub.md 当前正文为准。
安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法识别：
skillhub install @ihangfeng/hf-drama-assets --dir <你的 skills 目录>
常见路径（摘自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
装到对应目录后，按你所用客户端要求刷新或重启 Agent，使新 Skill 生效。各客户端差异以官方文档为准；本文不展开 Cursor / Codex / Claude Code 的逐项菜单配置。
典型用法¶
公开页面未附带完整样例 JSON，典型流程可按 Skill 简介复现：
- 准备材料：剧本正文（可分集粘贴）、分场/分镜镜头列表、人物小传、主要场景说明；若有设定图说明、地点表等，可作为补充参考资料一并提供。
- 启用 Skill：确认
@ihangfeng/hf-drama-assets已出现在当前 Agent 的 skills 列表中。 - 明确任务：在对话中说明需要「短剧资产清单」、要求 严格 JSON，并列出希望覆盖的集数或场次范围（避免一次塞入超出模型上下文的全本，可按集拆分多次生成再合并）。
- 验收输出：对照剧本核对场景、角色、道具是否遗漏；检查 JSON 是否可被解析；将视觉描述交给原画/动画同事确认是否满足制作口径。
若输出字段名或嵌套结构与你们内部模板不一致，可在同一会话中要求按贵司 schema 重排，或在 Skill 对话里固定一份 JSON 模板作为约束（模板内容需由团队自行定义，官方简介未公开固定 schema）。
适用场景与注意¶
适合谁
- 制片、统筹：在项目早期拉出场景/角色/道具总表，对接预算与排期。
- 分镜与美术前期：需要一份带视觉描述的资产索引，而不是只看剧本文本。
- 漫剧、短剧、动画、动态漫画等流水线相近的团队。
使用注意
- 输入质量决定清单质量：镜头列表与人物小传越完整，漏项越少；仅给梗概时，输出只能作草案。
- 「严格 JSON」需在提示中反复强调，并在收到结果后用解析器校验；模型偶发会夹带说明文字，需人工或脚本清洗。
- 企业来源 Skill（
source: enterprise），合规与更新节奏以 SkillHub 与发布者为准；版本号当前为1.0.0，升级前可在技能页确认变更说明。 - 下载量与评分来自 SkillHub 展示，不代表对你具体项目的适配程度；上线前建议用一集试点剧验证字段与描述深度。
结尾¶
短剧资产清单生成 把分散的前期文档收敛为场景、角色、道具三类 JSON 清单，并强调原画与动画可用的视觉描述，适合从剧本走向美术拆资的阶段。安装与坐标：@ihangfeng/hf-drama-assets；说明与安装提示见 https://www.skillhub.cn/skills/ihangfeng/hf-drama-assets，API 标识 https://api.skillhub.cn/ihangfeng/hf-drama-assets。
