烁皓 AI 短剧完整流水线（shuohao-workflow）
> ⚠️ 这个 skill 不是要直接帮你跑流水线——它只做一件事：确认你已装好整个 7-skill 工作流包，并指引你下一步去用 shuohao-pipeline 总编排 skill 开跑。
何时用这个 skill
- 用户说「装 shuohao 工作流包」「给我完整的小说转短剧 skill」「shuohao 全套装上」
- 用户不确定本机有没有 shuohao 环境，想先确认/装好
- 用户拿到
shuohao-workflow.zip（分发包），问我怎么装
安装
前置
- Node.js ≥ 18（六个底层 skill 的脚本只用标准库，无 npm 依赖）
- 前 5 个 skill 是 prompt 层：零 API key，用当前会话额度
character-refs出真图需配置模型（四选一：qwen / codex / openai / custom），不配置也能跑自检（白图占位）
安装步骤
# 1. 解压分发包
unzip shuohao-workflow.zip -d ~/my-skills # macOS/Linux
# 或双击 .zip 解压到任意目录，Windows 自带解压
# 2. 一键安装
python ~/my-skills/shuohao-workflow/install.py
# 3. 重启会话（关键！）
# 技能目录在会话启动时加载，新装完必须重启
安装目录约定：默认装到 ~/.workbuddy/skills/，也可 python install.py --target <dir>。
验证安装
ls ~/.workbuddy/skills/
# 应看到：shuohao-pipeline novel-outline novel-characters
# novel-art novel-script novel-storyboard
# character-refs
自检（不调模型、不花额度）
node ~/.workbuddy/skills/<name>/scripts/selftest.mjs
逐个 skill 跑一遍即可确认安装完好。
Windows 特别提示
Windows 上如果脚本因换行符报错，参考上游 docs 中的 Windows 说明处理。自检命令在 Git Bash 里跑更稳。
安装后的用法
装好后，不要再用本 skill 调用——直接在原会话里对 AI 说：
- 「用 shuohao 流水线把这本小说做成短剧」
- 「跑一下小说转短剧的完整流程」
AI 会自动调用 shuohao-pipeline 总编排 skill（它调度 6 个底层 skill：outline → characters → art → script → storyboard → character-refs）。
为什么这样设计
SkillHub 只收录「单个 skill」。shuohao-workflow 的定位是分发包的入口 skill：
- 它的唯一职责是确认安装环境 + 指引用户去用真正的编排 skill
- 真正的逻辑在
shuohao-pipeline（单独发布的编排 skill，已在 SkillHub） - 下游 6 个 skill（outline/characters/art/script/storyboard/character-refs）也是独立 skill，单独发布过
这种分层的好处：你可以只装某一个 skill（比如只要 outline），也可以一键装全 7 个走完整流水线。
数据来源与许可证
- 底层 6 skill 来自 eternityspring/shuohao-skills
- 本包整体遵循 Apache-2.0 License（见根目录 LICENSE / NOTICE）
- 总编排层
shuohao-pipeline由 WorkBuddy 编写，是此包的调度骨架
升级
重新拉取上游更新后，重跑：
python install.py --force # 强制覆盖已安装版本
然后逐个 node <name>/scripts/selftest.mjs 自检。
