前言¶

中长视频影视解说要同时控字数、控节奏、还要留钩子。很多团队把规则写在文档里，交给 AI 写稿时却经常出现字数飘、节奏平、开头无力。把《精准控时 + 高完播爆款版》一类规范固化成 Agent Skill，可以让模型按同一套参数和结构出稿，而不是每次从零描述要求。

下面介绍 SkillHub 社区技能 @user_d0df6a6e/siyuzhuanshu（包内展示名：温情/爱情/家庭伦理/女性励志爆款影视解说生成器）的定位、能力与安装方式。

这是什么¶

siyuzhuanshu 是基于通用 SKILL.md 格式的 Agent Skill，坐标为 @user_d0df6a6e/siyuzhuanshu，当前版本 1.0.0，来源为 community，SkillHub 分类为 business-ops，由发布者 user_d0df6a6e 维护。

包内 SKILL.md 将技能定位为影视解说文案生成：遵循「精准控时 + 高完播」规则，面向温情、爱情、家庭伦理、女性励志四大赛道，并约定 310 字/分钟控时、固定节奏与结构化输出。SkillHub 页面标注 requires_api_key=false（安装与商店侧不要求 API Key）；若使用包内 main.py 直连大模型，仍需自行配置模型相关环境变量（见下文注意项）。

核心功能¶

以下能力均来自包内 SKILL.md 与 main.py 的公开说明，不含未核实扩展。

文案与节奏规范¶

• 按目标时长计算字数（约 310 字/分钟），电影目标时长 10–18 分钟、电视剧 5–15 分钟（默认电视剧 8 分钟）。
• 开头可选用 12 类标准化类型（如提问悬念式、警告避雷式、强冲突开头等），并强调「三句一小反转、五句一大反转」等节奏要求。
• 赛道限定为四类：家庭伦理 / 爱情情感 / 温情治愈 / 女性励志。
• 可选生成 5 个封面标题、3 句置顶金句；支持特殊场景：群像剧 / 老片新解 / 系列剧续集。

结构化输入与输出¶

Agent 或脚本侧按表格传入必填项 film_name、opening_type、track_type，其余为可选。成功时返回 JSON，字段包括 film_name、track_type、target_duration、actual_word_count、commentary_content 等（见包内 SKILL.md 示例结构）。

可选 Python 执行入口¶

技能包附带 main.py：用 Pydantic 校验入参、拼装提示词后，通过 HTTP 调用兼容 OpenAI Chat Completions 的接口生成全文。默认读取环境变量 DOUBAO_API_KEY、DOUBAO_BASE_URL（默认 https://ark.cn-beijing.volces.com/api/v3/chat/completions）、MODEL_NAME（默认 doubao-3.5-pro）。SKILL.md 写明适用平台包括豆包百炼、腾讯云 Hermes、阿里云百炼、Krowork 等；具体以你方账号与 endpoint 为准。

安装与启用¶

1、安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可按 SkillHub 官方说明执行（完整安装示例）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装流程与优先源策略见：https://skillhub.cn/install/skillhub.md

2、安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被客户端加载。

skillhub install siyuzhuanshu --namespace user_d0df6a6e --dir <你的 skills 目录>

SkillHub 技能页给出的等价表述为：根据上述 install 文档安装 @user_d0df6a6e/siyuzhuanshu。

常见客户端 skills 路径（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/
• Claude Code：~/.claude/skills/

安装后按所用客户端要求重启或刷新，使 SKILL.md 被 Agent 读取。

3、若本地跑 main.py¶

pip install -r requirements.txt

依赖包括 python-dotenv、requests、pydantic 等（见包内 requirements.txt）。调用前配置 DOUBAO_API_KEY 等变量；未配置时脚本无法完成大模型请求。

典型用法¶

在对话中交给 Agent¶

安装并启用后，用自然语言说明影片名、开头类型、赛道与目标时长即可；Agent 应按 SKILL.md 中的参数表与创作规则生成解说稿及可选封面标题、金句。

入参示例（与包内本地测试一致）¶

{
  "film_name": "我的前半生",
  "opening_type": "强冲突开头",
  "track_type": "女性励志",
  "duration_type": "电视剧",
  "target_duration": 8,
  "generate_cover_titles": true,
  "generate_golden_sentences": true
}

opening_type 须为 SKILL.md 列出的 12 类之一；track_type 须为四大赛道之一。

命令行本地验证（可选）¶

在技能目录下执行：

python main.py

将使用 main.py 末尾内置的测试入参调用 handler，stdout 打印与上文结构一致的 JSON。

适用场景与注意¶

适合谁：做中长视频影视解说、主攻温情/爱情/家庭伦理/女性励志内容，且希望把控时、开头模板、反转节奏写进 Agent 工作流的运营或编导团队。

限制与注意：

• 包内规则要求剧情解说贴合真实片源，模型仍可能 hallucinate，发布前需人工核对影片情节。
• SkillHub 标签为无需 API Key，仅指商店/安装侧；main.py 路径依赖 DOUBAO_API_KEY 与可访问的推理 endpoint。
• 社区来源（community），使用前请自行评估合规与平台内容规范。
• 商店统计（以脚本抓取为准）：评分 100000，下载约 812 次；与你方环境看到的数字可能因刷新时间不同而有差异。

结尾¶

siyuzhuanshu 把爆款影视解说的控时、开头类型、赛道规范与 JSON 化入参收进一个 Skill，便于在 Cursor 等客户端里重复调用同一套创作标准。

• SkillHub 页面：https://www.skillhub.cn/skills/user_d0df6a6e/siyuzhuanshu
• 官方 API 地址（资料中的登记链接）：https://api.skillhub.cn/user_d0df6a6e/siyuzhuanshu