{"id":"be970931-5081-4fd2-af69-d1c26340289a","slug":"viral-writer-skill","kind":"skill","name":"viral-writer-skill","summary":"多平台爆款内容生成器 AI Skill:一个主题,小红书图文/抖音配文视频/知乎长文一条龙。方法论+提示词模板库+卡片渲染+视频合成+移动端H5","owner":"laolaola278-dev","repoUrl":"https://github.com/laolaola278-dev/viral-writer-skill","license":"Apache-2.0","licenseTier":"permissive","trust":"community","stars":5,"match":null,"fewStars":false,"format":"skill","createdAt":"2026-08-28T06:11:59.000Z","addedAt":"2026-10-21T23:43:08.843Z","logoUrl":"https://avatars.githubusercontent.com/u/271696286?u=971f374757592c821146039af9470c2fc72284dc&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["writing"],"tags":[],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-25T22:27:10.316Z","sample":false,"url":"https://conduits.dev/tools/viral-writer-skill","language":"JavaScript","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# viral-writer-skill\n\n[![License](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)\n[![Platforms](https://img.shields.io/badge/平台-小红书%20%7C%20抖音%20%7C%20知乎-FF2442)]()\n[![Skill](https://img.shields.io/badge/类型-AI%20Skill-FFB800)]()\n\n**多平台爆款内容生成器 —— 一个主题,小红书图文 / 抖音配文视频 / 知乎长文,一条龙。**\n\n可装进 Claude Code / OpenClaw / DSH 等支持 Skills 的 agent。给一句自然语言(主题+素材),按平台语感产出全套可发布内容,配套图篇生成提示词库、卡片渲染与竖屏视频合成工具。\n\n> **与纯提示词类 Skill 的关键差异:不止教 AI 怎么写,还有可执行工具。** 卡片由 Pillow/浏览器 Canvas 确定性渲染成真实 PNG;视频自动 TTS 配音、按配音时长对齐字幕、加转场——产物是成品文件,不是\"请模型再画一遍\"。\n\n---\n\n## ✨ 能做什么\n\n- 📕 **小红书**:5 个标题候选(标注公式)+ 正文 + 8-10 标签 + 发布方案 + 6 张 1080×1440 素人感卡片(PNG)\n- 🎵 **抖音**:黄金 3 秒钩子脚本 + 配文 + 话题标签 + 竖屏成片(TTS 配音/字幕/转场;BGM 用你自己的音乐文件,默认纯口播)\n- 📖 **知乎**:1500-3000 字结构化长文(含实测表格与诚实声明段落)\n- 🖼️ **图篇资产**:gpt-image-2 提示词模板库(10 类版式),真实素材优先的图生图保真模板\n- 🔄 **一鱼多吃**:同一主题按平台重写,禁止一稿多发\n- 📱 **移动端 H5**:纯静态网页,浏览器直连 LLM API + Canvas 本地渲染卡片,手机打开即用(见 `web/`)\n\n## 🧭 三种用法\n\n| 你是谁 | 怎么用 |\n|---|---|\n| Agent 用户(Claude Code/OpenClaw 等) | 安装 Skill 后直接说:\"帮我做一套小红书笔记,主题是 X\" |\n| 命令行用户 | 直接跑 `scripts/render_cards.py`(出卡片)、`scripts/make_video.py`(出视频) |\n| 手机用户 | 部署 `web/` 到任意静态托管,打开网页填主题即可 |\n\n## 🆚 与社区方案对比\n\n本项目站在两个社区爆款项目的肩膀上,并把它们融合放大:\n\n| 维度 | [xhs-writer-skill](https://github.com/JuneYaooo/xhs-writer-skill) | [gpt-image2-ppt-skills](https://github.com/JuneYaooo/gpt-image2-ppt-skills) | **viral-writer-skill** |\n|---|---|---|---|\n| 平台覆盖 | 小红书单平台 | 无平台概念(图页) | 小红书/抖音/知乎三平台,各有独立规范 |\n| 文案方法论 | ✅ 5 种标题公式+卖点公式 | — | ✅ 完整继承 + 审核清单/落盘规范/一鱼多吃 |\n| 视觉资产 | — | ✅ 依赖 gpt-image-2 | ✅ 提示词模板库 + 确定性渲染 + 可选图生图 |\n| 视频 | — | — | ✅ storyboard→成片(配音/字幕/转场;BGM 自备) |\n| 可执行工具 | 纯提示词 | 纯提示词 | ✅ 2 个脚本 + H5 应用 |\n| 降级能力 | — | 无 API 即不可用 | 缺任何依赖都自动降级 |\n| 移动端 | — | — | ✅ H5 |\n\n视频方向另参考 [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo) 的管线思路,本项目做成参数化 storyboard 驱动、双 orientations。\n\n## 🚧 风格与能力边界(诚实声明)\n\n**视觉风格**:默认卡片语言是「素人感营销风」——奶油底、大红高亮、大 emoji、黑胶囊。它适合个人博主、好物种草、干货分享;**不适合**品牌官方、科技评测、编辑风/杂志风等克制排版场景。色板集中在 `render_cards.py` 顶部常量与 `web/app.js` 的 `C` 对象,改一处即可换肤,但版式语言本身目前是单一的。\n\n**视频能力**:画面 = 静图 KenBurns(推近/拉远)+ 转场,分镜脚本里的画面描述用于指导你选图/生图,**不会自动生成实拍素材**;没有素材库匹配、数字人、逐字字幕。要\"精致大片\"请结合 MoneyPrinterTurbo 等项目。\n\n**H5 能力**:`web/` 是轻量单次生成(一轮对话出 JSON),不含多轮澄清、对标搜索与落盘规范;完整 7 步工作流请用 Skill 本体。\n\n**演示数字**:examples/ 中的效率对比是修辞性演示(基线为假设值),当作模板时请替换为你的实测数据——这也是 SKILL.md 审核清单对生成内容的要求。\n\n## 🧠 方法论(装进 agent 的就是这套)\n\n```\n0 澄清需求 → 1 卖点分析(只留 Top2)→ 2 对标爆款拆解\n→ 3 平台适配决策 → 4 按平台规范生成 → 5 资产生成(4 条路径)\n→ 6 审核清单(6 项,不过不交付)→ 7 落盘交付\n```\n\n详见 [SKILL.md](SKILL.md)。\n\n## 🚀 安装\n\n### 方式一:让 AI 自己装(推荐)\n\n把下面这段丢给你的 AI 助手:\n\n```\n帮我安装 viral-writer-skill:\nhttps://raw.githubusercontent.com/laolaola278-dev/viral-writer-skill/main/docs/install.md\n```\n\n### 方式二:手动装\n\n```bash\ngit clone https://github.com/laolaola278-dev/viral-writer-skill.git\ncd viral-writer-skill\nbash install_as_skill.sh\n```\n\n### 可选依赖(缺了自动降级,文案生成永远可用)\n\n| 依赖 | 用途 | 安装 |\n|---|---|---|\n| Pillow | 卡片 JSON→PNG 渲染(零浏览器依赖) | `pip install pillow` |\n| edge-tts | 视频配音 | `pip install edge-tts`(或装 uv) |\n| ffmpeg | 视频合成 | 系统包管理器 / winget |\n| OPENAI_API_KEY(.env) | gpt-image-2 图生图 | 见 `.env.example` |\n\n## 🛠 工具脚本(也可脱离 agent 单独用)\n\n```bash\n# 卡片渲染:写一份卡片规格 JSON(6 种版式 schema 见脚本头注,样例见 templates/cards/demo-cards.json)\npython scripts/render_cards.py <cards.json> <out_dir>\n\n# 视频合成:写一份 storyboard.json(结构见脚本头部注释)\npython scripts/make_video.py <storyboard.json> --out video.mp4\n```\n\n> 卡片为什么用 JSON+Pillow 而不是 HTML+浏览器?无头浏览器在不同主机上行为不稳(本项目开发中就实测了 Edge headless 的静默失效),而卡片是强排版产物:Pillow 确定性渲染,版式零漂移、零外部依赖,中文与彩色 emoji 均实测可用。`templates/cards/` 下保留了 HTML 版模板作为设计参考,`web/app.js` 内还有同一套规格的浏览器 Canvas 移植。\n\n## 📱 移动端 H5(web/)\n\n纯静态三文件(index.html / style.css / app.js),任意静态托管即可部署:\n\n- 浏览器直连 OpenAI 兼容 API(默认 DeepSeek),密钥只存用户本机 localStorage\n- LLM 返回的 cards JSON 与 `render_cards.py` schema 完全一致,Canvas 本地渲染 1080×1440 PNG,长按存相册\n- 无 API Key 也能点\"先看演示\"体验完整渲染\n- 桌面端(≥900px)自动切换双栏布局\n\n详见 [web/README.md](web/README.md) 与 [web/DEPLOY.md](web/DEPLOY.md)。\n\n## 🎬 效果演示(examples/)\n\n**主题**:\"推广 viral-writer-skill 自身\"(对,演示内容就是本项目的宣传物料)\n\n| 产物 | 文件 | 规格 |\n|---|---|---|\n| 小红书卡片 ×6 | examples/xhs-cards/*.png | 1080×1440,素人感设计 |\n| 小红书笔记文案 | examples/xhs-note.md | 5 标题公式 + 正文 + 标签 + 发布方案 |\n| 抖音竖屏视频 | examples/douyin/video.mp4 | 1080×1920,25s,配音+字幕+BGM |\n| 抖音分镜脚本 | examples/douyin/storyboard.json | make_video.py 的直接输入 |\n| 知乎长文 | examples/zhihu/article.md | ~1500 字,含实测表与诚实声明 |\n\n## ❓ FAQ\n\n**Q: API Key 安全吗?**\nA:Skill 只从自己目录的 `.env` 读取,不碰全局环境变量;H5 的密钥只存用户浏览器 localStorage,不经任何第三方服务器。对外公开服务请自行加后端代理。\n\n**Q: 浏览器直连 API 报跨域(CORS)?**\nA:DeepSeek / OpenAI 官方接口均允许浏览器直连;部分中转接口不允许,此时需加一层代理。\n\n**Q: 没有任何可选依赖能用吗?**\nA:能。文案生成是核心,永远可用;卡片降级为交付 JSON 规格,视频降级为交付脚本+分镜。\n\n**Q: 视频为什么没有素材库匹配/数字人?**\nA:本项目定位是\"能出成片\"的轻量管线;需要素材库/数字人可结合 MoneyPrinterTurbo 等项目。\n\n**Q: 生成的内容能直接发吗?**\nA:必须人工审核。SKILL.md 内置 6 项审核清单(事实/违禁词/合规/人设等),AI 负责效率,人负责灵魂。\n\n## ⚠️ 立场:工具负责效率,人负责灵魂\n\n1. AI 产出**必须人工审核**再发布(审核清单见 SKILL.md 第 6 步)\n2. 按平台规范标注 AI 生成内容\n3. 爆款 = 选题 × 人设 × 信任,工具只解决生产,不解决经营\n\n## 📁 目录结构\n\n```\nviral-writer-skill/\n├── SKILL.md                 # 核心:注入 agent 的方法论\n├── install_as_skill.sh      # 安装脚本\n├── .env.example             # 图生图密钥模板\n├── docs/\n│   ├── install.md           # 给 AI 读的自安装指引\n│   ├── prompt-templates.md  # gpt-image-2 图篇提示词模板库(10 版式+图生图+一致性)\n│   └── platforms/           # 平台规范\n│       ├── xiaohongshu.md\n│       ├── douyin.md\n│       └── zhihu.md\n├── templates/cards/         # demo-cards.json(6 卡样例规格)+ HTML 版式设计参考\n│                            # 版式:cover/list/flow/compare/data/cta\n├── scripts/\n│   ├── render_cards.py      # 卡片 JSON→PNG(Pillow 确定性渲染)\n│   └── make_video.py        # storyboard→成片(TTS+字幕+转场+BGM)\n├── web/                     # 移动端 H5:纯静态,浏览器直连 LLM API + Canvas 渲染卡片\n└── examples/                # 真实产物示例\n```\n\n## 🗺 Roadmap\n\n- [ ] H5 后端代理模式(公开服务场景,密钥不进浏览器)——最高优先\n- [ ] 公众号 / 微博 / B站 平台规范\n- [ ] 卡片主题化(品牌/评测/编辑风色板与版式)\n- [ ] 逐字字幕(karaoke 样式)\n- [ ] 素材库匹配(视频方向)\n\n## License\n\nApache-2.0(与上游参考项目一致),详见 [LICENSE](LICENSE)。\n"}