GitHub 趋势 · 第 100 期
3,326 星的 AI 短剧 skill 库：24 条变更记录，GitHub 上 0 个 tag
#AI短剧#AgentSkills#开源观察#第100期
第 100 期，写一个我认为最值得拆开看的仓库。五个 skill 本身做得扎实，真正少见的是它处理自己正在变形这件事的方式：把一个 skill 迁出这个仓库，从设计方案到执行计划，两份文档 25,063 字节，全部提交在公开仓库里；而迁去的那一边，对外打不开。
收 skill 仓库常见的麻烦不是功能不够，是过两个月回来看不懂它现在是什么状态。目录少了一个、README 里的路径指向不存在的文件夹、版本号跟你本地那份对不上，而你手上没有任何一份文件能把这件事讲清楚。
项目是什么
shuohao-skills 是一个 AI 短剧制作的 skill 集合，作者是个人开发者 eternityspring。它做的事是把一本小说变成能直接喂生成管线的制作素材：拆角色、排大纲、出场景与道具设定、写剧本、切分镜。跑在 Claude Code 和 codex 上。
仓库描述把分工写得很清楚，原文是「改编大纲收敛结构，剧本、场景、角色三者同步迭代，分镜只做输出不做新决定」。分镜这一环被刻意设计成只输出、不做新决策，上游定了什么它就出什么。
核心能力
五个 skill，每个一个目录，自包含、可以单独拷走：
| Skill | 做什么 | 质量门 |
|---|---|---|
| novel-outline | 小说 → 短剧大纲五件套：改编说明、人物表、爽点表、分集梗概、资产清单 | 14 道 |
| novel-characters | 大纲定下的角色 → 角色设定集：画像、形象提示词、音色提示词、设定图 | README 未标 |
| novel-art | 场景 + 叙事道具的美术设定集 | 11 道 |
| novel-script | 剧本：场次 + 节拍流，逐集时长按语速确定性折算 | 10 道 |
| novel-storyboard | 分镜：段 → 分镜 → 分镜图，一键出投产包 | 17 道 |
五个 skill 里有四个把质量门数写进了 README，合计 52 道，全部由脚本检查。剩下那个是 novel-characters，它的脚本 92,503 字节、自测 44,244 字节，是五份里最重的两份。
报告支持中英双语界面，默认中文，render --lang en 出全英文报告。另外五份报告可以合成一张单页，有哪几段就出哪几个面板，只跑了一段也不报错。
上手
README 给的三条命令，原样抄：
git clone https://github.com/eternityspring/shuohao-skills.git cd shuohao-skills ./scripts/install.sh
安装脚本会先检测你装的是 Claude Code 还是 codex，然后把所有 skill 软链过去，git pull 之后立刻生效，不用重装。只想装一个，或者只装到 codex：
./scripts/install.sh novel-characters # 只装某一个 ./scripts/install.sh --codex # 只装到 codex ./scripts/install.sh --uninstall # 取消软链
前置条件只有一条硬的：Node ≥ 18。脚本只用标准库，没有 npm 依赖，不需要 install；模型额度用你当前会话的，不需要任何 API key。codex CLI 是可选项，只有出图才用得上，没有就跳过出图，其余产出照常。
观察一：它把自己拆了一次，证据留在公开文档里
2026-08-16 的 CHANGELOG 里有一条「新 skill：shot-recipes（镜头语汇卡库）」。现在去这个仓库找 skills/shot-recipes，返回 404。原因不在 CHANGELOG 里，在 docs/ 里：
| 文件 | 字节 | 内容 |
|---|---|---|
| specs/2026-08-21-shot-recipes-repository-migration-design.md | 4,453 | 设计方案 |
| plans/2026-08-21-shot-recipes-repository-migration.md | 20,610 | 执行计划 |
同一件事写了两份文档，计划是设计的 4.63 倍。设计方案里写着迁去的新仓库叫 eternityspring/shuohao-video-skills，并且明说「新仓库先保持私有」。这个仓库目前对匿名请求返回 404，不是没做，是设计里就这么定的。
文档还交代了迁出的方式，原文是「采用干净快照迁移，不搬运旧仓库的 Git 历史」，以及「两个仓库都可以独立安装、测试和维护」。那执行完之后，主仓这边剩下什么？
- ▪hands-tell.md — 184 字节
- ▪insert-beat.md — 191 字节
- ▪ots-shot-reverse.md — 217 字节
三个 fixture 加起来 592 字节，这就是这次拆仓在主仓留下的全部痕迹。它们的作用是让 novel-storyboard 的自测不再依赖那个被移走的 skill。
顺带一个能看出来的工作习惯：这套仓库把先写规格、再写计划、再实施做成了制度。文档目录直接叫 docs/superpowers，下面分 specs 与 plans 两级，文件名以日期开头。而这个仓库里唯一的一份实施文档，写的就是怎么把它自己拆开。
观察二：24 条变更记录，0 个 tag
CHANGELOG.md 是根目录最大的文本文件，50,923 字节，是 README 的 5.09 倍。24 条变更记录，时间跨度从 2026-08-06 到 2026-08-19。
其中 20 条带版本号，12 条属于同一个 skill：novel-characters 从 1.0.0 一路走到 1.11.0，占了记录的一半。它也确实是最重的那个，单个脚本 92,503 字节、自测 44,244 字节。
但打 GitHub 的三个端点，拿到的是：
| 端点 | 返回 |
|---|---|
| /tags | 空数组 |
| /releases | 空数组 |
| /releases/latest | 404 Not Found |
也就是说，你读得到它记了 24 条变更，但一个版本都取不到。git clone 拿到的永远是 main 上的最新一份；想回到 novel-characters 1.7.0 那天，没有 tag 也没有 Release 包可以指。
再看时间。CHANGELOG 文件最后一次被改动是 2026-08-19，而那份拆仓的设计方案是 08-21，删除 skills/shot-recipes/ 发生在这之后。仓库今天也就是 09-14 还在推提交，结构变了，CHANGELOG 里一条记录都没有。
观察三：同一个仓库里，三份文档写给三种人
| 文件 | 字节 | 写给谁 |
|---|---|---|
| CHANGELOG.md | 50,923 | 维护者自己 |
| README.md | 10,006 | 中文读者 |
| README.en.md | 9,044 | 英文读者 |
| CLAUDE.md | 1,452 | AI agent |
CLAUDE.md 的第一条规则不是技术规则：「中文文案（README、SKILL.md、报告界面标签）不用单字词」——它管的是中文别写单字，比如「安装」不许缩成「装」。
里面还有一条我觉得更少见。作者在给 agent 的常驻规则里写：「如果长期没人打开它，说明这个功能不该做，推广只会把错误复制五份」，紧接着一句「不要主动再提推广」。把一个功能的存废判据、以及别再提它这句话，写进了给 agent 的规则文件。
两份 README 也不是翻译关系：中文版 9 个小节，英文版 7 个。中文版独有一个付费交流社群段落，和一段 demo 工作目录约定；英文版顶部多了一整块「Open to work / collaboration」，写着作者正在找工作、接受远程或半合作，原文是 a few thousand RMB a month for living costs plus a profit share，附邮箱、简历站与 Ko-fi。这两块在对方的版本里都找不到。
英文版还多一句中文版没有的提醒：这些 skill 是中文优先的，novel-characters 就算源小说是英文，产出的角色档案也是中文，而且它的校验器会主动拒绝那些字段里的英文。
最后一组数字来自仓库接口本身：3,326 star、447 fork、6 个 watcher、0 个 open issue（has_issues 是开着的）。star 是 watcher 的 554 倍。
我的判断
适合谁：在做 AI 短剧或漫剧的人，以及想给 agent 写内容制作类 skill 的人。五个 skill 都是零依赖的 Node 脚本加自测，能单独拷走；质量门全部脚本化这条做法，比门数本身更值得抄。许可 Apache-2.0，商用没有额外限制，NOTICE 里还单独给样例小说《渡口》署了名。
不适合谁：想装完就出成片的人。它只做到喂给生成管线的素材为止，出图依赖 codex CLI，视频生成不在这个仓库里。另外 README 自曝「只在 macOS + Node 24 上验过」，Linux 和更低版本 Node 的官方口径是「理论上没问题，但没验」，而且「没有配 CI——自测足够快（1 秒）」。
坑：① 没有 tag 也没有 Release，要锁定某个版本只能自己记 commit。
② skills/shot-recipes 已经不在这个仓库，如果你的工作流引用过它，去看 docs/superpowers/specs 里那份设计方案，别在 README 里找。
③ 五个 skill 的 README 有四个是中文版更长，但 novel-characters 反过来，别默认中文文档一定更全。
④ NOTICE 里样例小说的署名路径 skills/storycast/examples/渡口.txt 已经取不到，它在 skills/novel-characters/examples/渡口.txt（2,349 字节）。许可效力不受影响，但照 NOTICE 去找会扑空。
仓库：eternityspring/shuohao-skills（https://github.com/eternityspring/shuohao-skills）
Star 3,326 · Fork 447 · watcher 6 · open issue 0 · 语言 JavaScript · 许可 Apache-2.0（LICENSE 11,359 字节，标准全文）· size 12,555 KB · 建仓 2026-08-06 · 最后推送 2026-09-14 · default_branch main
本期数据全部取自 GitHub REST API 与仓库原文（README.md / README.en.md / CLAUDE.md / NOTICE / CHANGELOG.md / docs 原文 / git tree）。抓取时间：2026-09-14 17:20（GMT+8）。
该项目未进入当日、本周、本月 Trending 榜，因此没有周期新增 star 数据，封面改用总 star、fork、watcher 与 tag 数。
无法核实：迁出目标 eternityspring/shuohao-video-skills 的内容。该仓库对匿名请求返回 404，只能确认它按设计文档被设成了 private。
一个值得留意的细节：这个仓库把怎么拆自己写成了公开文档，却把拆出去的那一半设成了私有。你觉得这种处理对读者是加分还是减分？
下期预告：继续往短视频和克隆语音方向找。已经连着几期遇到三榜与这十个方向几乎不重叠的情况，所以下期仍会用 created:>2026-01-01 的方向检索现场挖，并沿用替代判据——用总 star 与最近提交时间代替周期新增 star。另外更早预告过的开源替代 SaaS 合集不在给定的十个方向内，继续欠着。
#AI短剧#AgentSkills#开源观察#第100期