viral-writer-skill

viral-writer-skill

多平台爆款内容生成器 —— 一个主题,小红书图文 / 抖音配文视频 / 知乎长文,一条龙。

可装进 Claude Code / OpenClaw / DSH 等支持 Skills 的 agent。给一句自然语言(主题+素材),按平台语感产出全套可发布内容,配套图篇生成提示词库、卡片渲染与竖屏视频合成工具。

与纯提示词类 Skill 的关键差异:不止教 AI 怎么写,还有可执行工具。 卡片由 Pillow/浏览器 Canvas 确定性渲染成真实 PNG;视频自动 TTS 配音、按配音时长对齐字幕、加转场——产物是成品文件,不是"请模型再画一遍"。

✨ 能做什么

• 📕 小红书:5 个标题候选(标注公式)+ 正文 + 8-10 标签 + 发布方案 + 6 张 1080×1440 素人感卡片(PNG)
• 🎵 抖音:黄金 3 秒钩子脚本 + 配文 + 话题标签 + 竖屏成片(TTS 配音/字幕/转场;BGM 用你自己的音乐文件,默认纯口播)
• 📖 知乎:1500-3000 字结构化长文(含实测表格与诚实声明段落)
• 🖼️ 图篇资产:gpt-image-2 提示词模板库(10 类版式),真实素材优先的图生图保真模板
• 🔄 一鱼多吃:同一主题按平台重写,禁止一稿多发
• 📱 移动端 H5:纯静态网页,浏览器直连 LLM API + Canvas 本地渲染卡片,手机打开即用(见 web/)

🧭 三种用法

🆚 与社区方案对比

本项目站在两个社区爆款项目的肩膀上,并把它们融合放大:

视频方向另参考 MoneyPrinterTurbo 的管线思路,本项目做成参数化 storyboard 驱动、双 orientations。

🚧 风格与能力边界(诚实声明)

视觉风格:默认卡片语言是「素人感营销风」——奶油底、大红高亮、大 emoji、黑胶囊。它适合个人博主、好物种草、干货分享;不适合品牌官方、科技评测、编辑风/杂志风等克制排版场景。色板集中在 render_cards.py 顶部常量与 web/app.js 的 C 对象,改一处即可换肤,但版式语言本身目前是单一的。

视频能力:画面 = 静图 KenBurns(推近/拉远)+ 转场,分镜脚本里的画面描述用于指导你选图/生图,不会自动生成实拍素材;没有素材库匹配、数字人、逐字字幕。要"精致大片"请结合 MoneyPrinterTurbo 等项目。

H5 能力:web/ 是轻量单次生成(一轮对话出 JSON),不含多轮澄清、对标搜索与落盘规范;完整 7 步工作流请用 Skill 本体。

演示数字:examples/ 中的效率对比是修辞性演示(基线为假设值),当作模板时请替换为你的实测数据——这也是 SKILL.md 审核清单对生成内容的要求。

🧠 方法论(装进 agent 的就是这套)

0 澄清需求 → 1 卖点分析(只留 Top2)→ 2 对标爆款拆解
→ 3 平台适配决策 → 4 按平台规范生成 → 5 资产生成(4 条路径)
→ 6 审核清单(6 项,不过不交付)→ 7 落盘交付

详见 SKILL.md。

🚀 安装

方式一:让 AI 自己装(推荐)

把下面这段丢给你的 AI 助手:

帮我安装 viral-writer-skill:
https://raw.githubusercontent.com/laolaola278-dev/viral-writer-skill/main/docs/install.md

方式二:手动装

git clone https://github.com/laolaola278-dev/viral-writer-skill.git
cd viral-writer-skill
bash install_as_skill.sh

可选依赖(缺了自动降级,文案生成永远可用)

🛠 工具脚本(也可脱离 agent 单独用)

# 卡片渲染:写一份卡片规格 JSON(6 种版式 schema 见脚本头注,样例见 templates/cards/demo-cards.json)
python scripts/render_cards.py <cards.json> <out_dir>

# 视频合成:写一份 storyboard.json(结构见脚本头部注释)
python scripts/make_video.py <storyboard.json> --out video.mp4

卡片为什么用 JSON+Pillow 而不是 HTML+浏览器?无头浏览器在不同主机上行为不稳(本项目开发中就实测了 Edge headless 的静默失效),而卡片是强排版产物:Pillow 确定性渲染,版式零漂移、零外部依赖,中文与彩色 emoji 均实测可用。templates/cards/ 下保留了 HTML 版模板作为设计参考,web/app.js 内还有同一套规格的浏览器 Canvas 移植。

📱 移动端 H5(web/)

纯静态三文件(index.html / style.css / app.js),任意静态托管即可部署:

• 浏览器直连 OpenAI 兼容 API(默认 DeepSeek),密钥只存用户本机 localStorage
• LLM 返回的 cards JSON 与 render_cards.py schema 完全一致,Canvas 本地渲染 1080×1440 PNG,长按存相册
• 无 API Key 也能点"先看演示"体验完整渲染
• 桌面端(≥900px)自动切换双栏布局

详见 web/README.md 与 web/DEPLOY.md。

🎬 效果演示(examples/)

主题:"推广 viral-writer-skill 自身"(对,演示内容就是本项目的宣传物料)

❓ FAQ

Q: API Key 安全吗? A:Skill 只从自己目录的 .env 读取,不碰全局环境变量;H5 的密钥只存用户浏览器 localStorage,不经任何第三方服务器。对外公开服务请自行加后端代理。

Q: 浏览器直连 API 报跨域(CORS)? A:DeepSeek / OpenAI 官方接口均允许浏览器直连;部分中转接口不允许,此时需加一层代理。

Q: 没有任何可选依赖能用吗? A:能。文案生成是核心,永远可用;卡片降级为交付 JSON 规格,视频降级为交付脚本+分镜。

Q: 视频为什么没有素材库匹配/数字人? A:本项目定位是"能出成片"的轻量管线;需要素材库/数字人可结合 MoneyPrinterTurbo 等项目。

Q: 生成的内容能直接发吗? A:必须人工审核。SKILL.md 内置 6 项审核清单(事实/违禁词/合规/人设等),AI 负责效率,人负责灵魂。

⚠️ 立场:工具负责效率,人负责灵魂

1. AI 产出必须人工审核再发布(审核清单见 SKILL.md 第 6 步)
2. 按平台规范标注 AI 生成内容
3. 爆款 = 选题 × 人设 × 信任,工具只解决生产,不解决经营

📁 目录结构

viral-writer-skill/
├── SKILL.md                 # 核心:注入 agent 的方法论
├── install_as_skill.sh      # 安装脚本
├── .env.example             # 图生图密钥模板
├── docs/
│   ├── install.md           # 给 AI 读的自安装指引
│   ├── prompt-templates.md  # gpt-image-2 图篇提示词模板库(10 版式+图生图+一致性)
│   └── platforms/           # 平台规范
│       ├── xiaohongshu.md
│       ├── douyin.md
│       └── zhihu.md
├── templates/cards/         # demo-cards.json(6 卡样例规格)+ HTML 版式设计参考
│                            # 版式:cover/list/flow/compare/data/cta
├── scripts/
│   ├── render_cards.py      # 卡片 JSON→PNG(Pillow 确定性渲染)
│   └── make_video.py        # storyboard→成片(TTS+字幕+转场+BGM)
├── web/                     # 移动端 H5:纯静态,浏览器直连 LLM API + Canvas 渲染卡片
└── examples/                # 真实产物示例

🗺 Roadmap

• H5 后端代理模式(公开服务场景,密钥不进浏览器)——最高优先
• 公众号 / 微博 / B站 平台规范
• 卡片主题化(品牌/评测/编辑风色板与版式)
• 逐字字幕(karaoke 样式)
• 素材库匹配(视频方向)

License

Apache-2.0(与上游参考项目一致),详见 LICENSE。