Menu
制作"从夯到拉"排行榜锐评视频。当用户想制作排行榜锐评视频、给事物打分排名、或从话题生成带动画的排行榜 MP4 时使用。负责协调 search-images、generate-tts 和 assemble_tierlist 脚本。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
使用 edge-tts（免费）、OpenAI TTS 或 Fish Audio TTS 将旁白文案转换为音频文件。当片段缺少 audio 字段、用户要求生成配音、或需要将脚本合成语音时使用。
读取 project.yaml，将排行榜图片和音频合成为最终 MP4 视频。当所有选手的图片和音频均已就绪、或用户要求渲染/导出/完成视频时使用。
使用 DuckDuckGo 搜索并下载视频幻灯片所需的图片素材（无需 API Key）。当视频项目缺少 image 字段、某个片段没有图片、或用户要求根据关键词搜图时使用。
| name | make-tierlist |
| description | 制作"从夯到拉"排行榜锐评视频。当用户想制作排行榜锐评视频、给事物打分排名、或从话题生成带动画的排行榜 MP4 时使用。负责协调 search-images、generate-tts 和 assemble_tierlist 脚本。 |
端到端"从夯到拉"排行榜视频生成流水线。
在开始任何步骤之前，若用户是第一次运行，先确认以下条件满足：
uv sync # 推荐，使用 uv（快速）
# 或
pip install moviepy edge-tts pillow pyyaml pydantic requests aiohttp aiofiles openai numpy
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# 验证安装
ffmpeg -version
cp config.template.yaml config.yaml
# 最少只需填写（可选）：
# pexels_api_key — 若要使用 Pexels 搜图
# openai_api_key — 若要使用 OpenAI TTS
# 默认使用 DuckDuckGo 搜图 + edge-tts 配音，无需任何 API Key
如果用户报告脚本报错，先对照各 skill 末尾的"常见错误与修复"表排查，再寻求其他解法。
这是一种流行的互联网排行榜视频形式：
project.yaml 是整个项目的单一事实来源，支持 agent 自动生成、人工手写、或两者混合：
materials/ 是素材来源目录：每个选手有独立子文件夹，可放图片（.jpg/.png）、文字描述（.txt）、或 agent 搜图后自动保存的 search_results.json。text、audio、image），让 agent 重跑对应步骤。projects/{项目名}/
├── project.yaml ← 蓝图，人机共同维护
├── materials/ ← 所有原始素材（图片 + 文字描述 + 搜索元数据）
│ ├── intro/
│ │ └── photo_00.jpg
│ ├── contestant_01/ ← 每个选手一个文件夹
│ │ ├── photo_00.jpg ← 搜到或手动放入的图片
│ │ ├── photo_01.jpg
│ │ ├── desc.txt ← 可选：人工放入的文字说明
│ │ └── search_results.json ← 搜图时自动保存的标题/URL 元数据
│ └── outro/
├── audio/ ← TTS 生成的音频文件
│ ├── intro.mp3
│ └── contestant_01.mp3
└── output/ ← 最终合成的视频
创建目录和 project.yaml：
mkdir -p projects/{项目名}/materials projects/{项目名}/audio projects/{项目名}/output
初始 project.yaml 模板：
name: "{项目名}"
type: "tierlist"
topic: "{话题}，从夯到拉排名"
language: zh
resolution: "1920x1080"
fps: 24
# tts_voice 留空即可继承 config.yaml 中的 tts_provider / tts_voices 配置
# 仅当需要覆盖音色时才填写，例如：tts_voice: zh-CN-YunxiNeural
tierlist:
background: "skills/assemble-video/assets/tierlist_bg.png"
label_width_ratio: 0.127 # 标签列占视频宽度比例，无需修改
tiers:
- id: "hang"
label: "夯"
- id: "top"
label: "顶级"
- id: "rsr"
label: "人上人"
- id: "npc"
label: "NPC"
- id: "la"
label: "拉完了"
# 风格提示：几个字到一句话，agent 写文案时参考（可选）
style: "幽默犀利，互联网口语，多用比较和类比"
intro:
text: "{片头导语，约 20–40 字}"
audio: "audio/intro.mp3"
contestants: [] # 第 1 步填写
outro:
text: "你有不同意见吗？咱们下期再见。"
audio: "audio/outro.mp3"
index 决定解说顺序，不是档位顺序。
规划 contestants 列表时，不要把相同档位的选手排在一起，也不要按"夯→顶级→人上人→NPC→拉完了"的强弱顺序排列。这会让观众提前猜到后续走势，大幅降低趣味性。
正确做法：打乱各档位，制造悬念。参考以下排布策略：
npc → hang → la → rsr → top → npc → hang → la对每个选手，执行以下决策：
text 字段存在？
✅ 已有 → 跳过
❌ 缺失 → 查看 materials/contestant_XX/：
有 desc.txt？→ 读取作为参考
有 search_results.json？→ 读取图片标题作为参考
→ 结合 name / tier / topic / style，写点评文案（100–400 字）
→ 填写 text 字段
文案风格要求：口语化、幽默、有共情，参考 style 字段。参考时长：约 120 汉字 ≈ 8–10 秒音频。
在 project.yaml 中填写 contestants（注意 tier 交错分布）：
contestants:
- index: 1
name: "高砂"
keywords: "灌篮高手 高砂"
tier: "npc" # ← 第一个出场的是 NPC，不是最强的
text: |
开场先来个垫底热个身...
- index: 2
name: "帝王牧绅一"
keywords: "灌篮高手 牧绅一"
tier: "hang" # ← 紧接着出现最强的，形成对比
text: |
刚才那个还没坐热，帝王就来了...
- index: 3
name: "木暮公延"
keywords: "灌篮高手 木暮"
tier: "la" # ← 落差感，拉完了
text: |
眼镜兄木暮，对不起了...
对每个选手，执行以下决策：
image 字段存在？
✅ 已有 → 跳过
❌ 缺失 → 查看 materials/contestant_XX/：
有图片文件（*.jpg / *.png）？
✅ 有 → 读取 search_results.json 中的标题，选最相关的图片路径 → 填写 image
❌ 无 → 用 keywords 搜图（见下方命令）→ 选最相关的图片 → 填写 image
搜图命令（仅在素材目录无图时使用）：
python skills/search-images/scripts/search_images.py \
--keywords "{contestant.keywords}" \
--output "projects/{name}/materials/contestant_{index:02d}/" \
--count 5 \
--config config.yaml
脚本会下载多张图片并在目录下保存 search_results.json（含标题、URL）。agent 根据 title 选择最相关的一张，填入 image 字段。
选手图片将在视频中大图展示（约 720×720），建议优先选构图清晰、主体明显的图片。
对每个片段，执行以下决策：
audio + duration 字段均存在？
✅ 均有 → 跳过
❌ 任一缺失 → 用 text 字段跑 TTS → 填写 audio 和 duration
音色优先级（高 → 低）：片段级 tts_voice → 项目级 tts_voice → config.yaml 中的 tts_voices[language]。
通常只需传 --config，provider 和音色均由 config.yaml 决定，不要额外加 --voice 或 --provider 参数。
python skills/generate-tts/scripts/tts.py \
--text "{text}" \
--output "projects/{name}/audio/{segment}.mp3" \
--config config.yaml
若文案含换行（多行 YAML block scalar），请将文本写入临时文件再传入，避免 shell 截断：
echo '{text}' > /tmp/seg.txt python skills/generate-tts/scripts/tts.py --text "$(cat /tmp/seg.txt)" --output ... --config config.yaml
对 intro、每位 contestant、outro 分别执行，更新 project.yaml。
所有 image、audio、duration 就绪后：
python skills/assemble-video/scripts/assemble_tierlist.py \
--project "projects/{name}/project.yaml" \
--output "projects/{name}/output/{name}.mp4" \
--config config.yaml
输出 JSON：
{"path": "projects/myvideo/output/myvideo.mp4", "duration_seconds": 245.7}
| 场景 | 操作 |
|---|---|
| 对某段文案不满意 | 删除该选手的 text、audio、duration → 让 agent 重跑步骤 1→3→4 |
| 对某段图片不满意 | 删除 image，修改 keywords（可选）→ 让 agent 重跑步骤 2→4；或手动将新图放入 materials/contestant_XX/ 并更新 image 后重跑步骤 4 |
| 自己提供图片 | 把图片放入 materials/contestant_XX/，填写 image 字段路径 → 直接运行步骤 4 |
| 自己提供文案资料 | 把说明写入 materials/contestant_XX/desc.txt → 删除 text 让 agent 读取后重写 |
| 重新录制配音 | 替换 audio/ 下对应 mp3，删除 duration 字段 → 让 agent 重新探测时长后重跑步骤 4 |
| 全部重做 | 保留 name/tier/keywords，清空其他字段 → 让 agent 从步骤 1 开始 |
| 字段 | 说明 |
|---|---|
type | 必须为 "tierlist" |
style | 文案风格提示，几个字到一句话，agent 写文案时参考（可选） |
tierlist.background | 排行榜背景图路径（使用内置资产即可） |
tierlist.label_width_ratio | 左侧标签列宽比例，默认 0.127 |
tiers[].id | 档位 ID（程序内部使用） |
tiers[].label | 档位显示名称（仅供参考，背景图已含标签） |
intro.text / outro.text | 片头片尾旁白文案 |
contestants[].tier | 选手档位 ID，必须匹配 tiers[].id |
contestants[].keywords | 搜图关键词，优先使用中文（如 "灌篮高手 流川枫"） |
contestants[].text | 点评旁白文案；缺失时 agent 参考 materials/ 下的素材重新生成 |
contestants[].image | 图片路径（相对于项目目录）；缺失时 agent 先查 materials/，无图才搜索 |
contestants[].audio | 音频路径（相对于项目目录）；缺失时重跑 TTS |
contestants[].duration | 音频时长（秒）；由 TTS 脚本自动填入 |
- [ ] 第 0 步：project.yaml 已创建，type = "tierlist"，materials/ 目录已建
- [ ] 第 1 步：所有选手均有 text（keywords 中文优先）、tier；intro/outro 有 text
- [ ] 第 2 步：所有选手均有 image（优先使用 materials/ 已有图片，无图才搜索）
- [ ] 第 3 步：intro、contestants、outro 均有 audio 和 duration
- [ ] 第 4 步：视频合成完毕，路径已告知用户
hang 对应第一行（最顶），la 对应第五行（最底）。project.yaml，防止进度丢失。出处：原创内容，作者猫叔。以下为格式化参考版本。
湘北对海南，从"夯"到"拉"排名。 本次排名将结合比赛表现，以及井上手稿综合判定。 没看过的朋友请自行暂停观看。
首先是帝王牧绅一，30分且三双达成。
整场比赛，阿牧的表现无可挑剔，进攻端所向披靡，单防根本没人拦得住他。 即使湘北派出赤木樱木两大内线，肌肉牧照样能将球打进。 不仅自己能得分，还能带动队友拿分，10次以上的助攻数据就是最好的证明。 逼得安西只好使出整部漫画里最夸张的四盯一大法，全力压制帝王牧。
而阿牧在防守端的贡献，完全不亚于进攻端。 他能从一号位防到五号位，湘北五虎都受到过他的"关照"。 协防也非常积极，哪里有漏洞他就堵哪里。 10个篮板以上的数据，甚至可能超过了队里的中锋高砂。
凭借攻防两端的完美表现，阿牧给个"夯"，一点毛病没有。
接下来是湘北队长赤木，33分、15板、2助攻、4盖帽。海南战是其个人生涯最高光的一战。
可以说这一战将赤木积压多年的情绪彻底宣泄了出来。 哪怕是在受伤下场的情况下，赤木依然拿到了全场最高分。 不敢想象要是赤木正常打满全场，他能拿到多少分。
而在受伤后赤木所展现出来的斗志，更是令人肃然起敬。 比赛最后时刻，赤木吃阿牧假动作起跳，在忍受剧烈疼痛的情况下， 他竟然能连续起跳，成功干扰阿牧的射篮，紧接着还能抢下防守篮板。 这份意志力，让场边的晴子掩面痛哭，鱼住更是忍不住呐喊助威。
其实安西早在下半场还有18分钟的时候，看出赤木可能撑不下去，让木暮去热身。 结果他愣是撑到了最后一秒。 就像安西说的，赤木的精神已经超越肉体极限了。
就凭这份意志和完美的数据，赤木当之无愧给到一个"夯"。
说完赤木，接下来聊聊和他对位的高砂。数据6分。
相比起斗志高昂的大猩猩，这只小猩猩就显得有些唯唯诺诺了。 面对脚伤严重的赤木，高砂防不住就算了，教练高头让他硬闯， 他却连跟赤木正面PK的勇气都没有，气得高头破口大骂。 阿牧无奈只能让他去盯樱木，自己这个控卫来防赤木。
作为海南的正选中锋，高砂的篮板也被爆得不要不要的，整场比赛几乎毫无存在感。 也就是最后几秒，有个还算亮眼的卡位，以及靠着长相莫名其妙拿到了关键球。
勉勉强强给个NPC吧。
最后强调一点，垫脚赤木的是阿牧不是他。 注意看鞋子和腿的肤色，觉得是高砂的，是因为动画中间给他切了个镜头所造成的误导，别再冤枉他了。
再来是新人王流川，31分、5板、5助攻、3盖帽。
本场比赛，流川枫展现了强大的攻防能力， 尤其是赤木受伤下场期间，流川仿佛化身"神明"， 硬是靠着个人能力，帮助湘北抹平了11分的分差。 海南几乎倾尽所有，就是没法挡住他。 光上半场流川就拿了25分，气得高头把他的宝贝扇子都折断了。
如果只看半场球，流川肯定夯爆了。 只可惜这种爆种打法，没有超人般的体力根本没法延续。 下半场流川仅得到6分，在湘北最需要他的时候倒下了。 赛后他也承认，比赛失利自己有一定责任。
综合来看可以给到顶级到夯之间。
接着聊和他对位的清田。数据18分。
比赛刚开始的隔扣，清田给了不少人惊喜。 然而随着流川爆发，清田被各种吊打，两人间的差距显而易见。
好在他身上有股不服输的劲，加上其耐力惊人， 下半场限制流川枫，清田功不可没。 最后时刻敏锐察觉湘北战术，对三井进行的关键封盖，也是海南制胜的重要原因之一。
因此野猴子可以给到个人上人。
下面是红毛猴樱木，6分、17板、2助攻、2封盖。
相比起翔阳战靠宫城助攻的2分，这次打海南樱木几乎凭自己， 足足翻了3倍，已经跟高砂一样分数了，成长速度有目共睹。
当然最厉害的还得是篮板球。 17个篮板全场封王，其中还有好几次关键的前场篮板，逼得帝王牧只能亲自出手。 全场三次犯规，全都犯在了樱木身上。
只是莫名其妙被宫益限制，以及最后的误传失误，让樱木的评级有所下降。 整体可以给到一个顶级。
同样是大前锋，武藤的表现可就差远了，数据只有5分，比菜鸟樱木还少。 要知道这还是给了他放投机会的情况下，整场比赛几乎隐形，不是被盖就是传球失误。
有人说武藤完美限制了三井，被误导了。 他只有阿神不在的9分钟左右，才是跟三井对位，其它时候防三井的都是阿神。 而且这几分钟，三井本就没什么球权，防守压力并不大。
无论攻防两端，武藤的贡献微乎其微，只能给到一个拉完了。
接下来是社会我三哥，8分、2板、6助攻。
本场比赛三井的得分排在湘北正选倒数第二，仅比樱木多了两分，这个数据显然非常不理想。 归根结底是被阿神算计了。 在之前几次的观察中，阿神就发现三井跟他很像，属于越投越有的类型。 因此他的防守策略主要就是防投。 你突破不要紧，反正内线有其它人协防，但初期一定不能让你找到投篮节奏。 这也就是为什么比赛中后段，三井好几次空位都投不进的原因。
鉴于个人情怀，我勉强给到三哥一个NPC，当然你给他拉我也觉得没什么大毛病。
相较而言，阿神的表现就好多了。数据22分，海南第二，其中绝大部分都来自下半场。
凭借对射手深刻的理解能力，阿神给三井制定的防守策略非常奏效。 而在进攻端他时常给出妙传，并且没有浪费任何一次出手机会，这一点确实很"神"。
可惜运动能力不及樱木，即便形成突破，还是遭到了逆天大帽。
整体可以给到一个顶级。
下面是五虎最后一位宫城，10分，16次助攻，湘北唯二拿到两双的球员。
不仅助攻数据非常亮眼，能在跟阿牧的对位中拿到10分，已经超越了平日水准。 另外井上没有统计抢断数据，本场比赛宫城有好几次精彩抢断， 抢断高砂，更是强行为湘北续命。
把这些都算上的话，宫城的数据可不比樱木差，他值得一个顶级。
最后是两队替补。宫益义范，数据9分。
不管符不符合现实，至少在漫画里，宫益的确克制了樱木。 他的三分球同样弹无虚发，属于绝对不能放空的存在。 偶尔灵光一闪，还能贡献几记妙传。
尽管本身的缺陷很明显——长得矮，运动能力差， 但就凭他1米6的个头，敢给樱木放狠话的勇气，他就够得上一个"人上人"。
眼镜兄木暮相较而言，就显得黯淡太多了。
上半场上场9分多钟，除了给清田贡献一个盖帽数据，对球队毫无建树。 最后时刻临危受命，接替体能不济的流川。 结果面对阿牧的霸王色霸气，只能勉强站稳，连动作都不敢做。 唯一亮点也就一个飞身救球。
但依旧无法掩盖本场拉胯的表现。
你有不同意见吗？我是猫叔，咱们下期视频再见。