Skip to content
BranchesTags

Repository files navigation

中文 · English

Auto Viral Article Writer

Auto Viral Article Writer：面向 Agent 的内容生产与分发系统，把热点研究、爆款结构、文章起草、多平台改写、评分预测复盘、封面与插图串成一个稳定工作流。

License Skills Platforms

支持平台： OpenCode、Codex、Claude Code、OpenClaw、Hermes

这是什么

这是 Auto Viral Article Writer。它不是单一工具，也不是纯 prompt 集合，而是一套可以被 Agent 直接加载、安装和复用的内容生产与分发系统。

它不是在回答“怎么多写一点”，而是在回答另一件更重要的事：

怎么让一个 Agent 按稳定流程持续产出、分发、复盘和进化内容。

它要解决的是这件事：

  • 先找到值得写的话题
  • 再复用高信号的爆款结构
  • 然后产出可继续加工的文章草稿
  • 再改写为多平台原生版本
  • 最后补齐评分、预测、复盘，以及封面和插图

如果你想让 Agent 按稳定流程做内容，而不是每次从零开始，这个包就是为这个场景设计的。

和普通 AI 内容工具相比，它更像一条完整流水线：

  • 不只是生成草稿
  • 还包括分发改写
  • 还包括发布前判断
  • 还包括发布后复盘
  • 以及平台级标准的持续收紧

适合谁

  • 写公众号长文的人
  • 做 AI / SaaS / 内容研究的人
  • 想把选题、结构、成稿、配图串成一个流程的人
  • 想把内容生产沉淀成可安装工作流的团队

不适合谁

  • 只想要一个独立画图工具的人
  • 不需要热点研究、只想随便写点博客的人
  • 不接受本地 output/、config/、data/viralkb/ 文件结构的人
  • 想要云端托管产品而不是本地 Auto Viral Article Writer 安装的人

Skills

Skill 一句话说明 触发示例
setup 首次配置、依赖检查、连接验证 setup, 配置, 设置
hot-topics 多源抓取今日热点 今日热榜, AI热榜, 热门话题
research-brief 把可写的话题整理成更强的结构化 brief 先研究一下, 帮我先梳理这个题, research brief
viral-patterns 从 ViralKB 里取爆款标题和结构模式 爆款模式, 找标题公式, 参考爆款
viral-mining 从外部发现高信号内容并入库 ViralKB 挖掘爆款, 发现爆款, viral mining
write-article 从研究到草稿的完整写作流程 写文章, 生成文章, 公众号文章
repurpose-content 把公众号母稿改写成多平台原生版本 改写成 X 版本, 改成小红书, repurpose this article
article-score-retro 对平台稿做发布前评分、盲预测、发布后复盘 score this post, predict this, retro this post
platform-rubric-manager 维护各平台 scoring rubric，并根据 retro 更新 update wechat rubric, review x rubric
multi-platform-content 编排母稿、改写、评分、预测、复盘的整套工作流 做一套多平台内容包, run the multi-platform workflow
article-audit 审计单篇文章的 brief、draft、cover 和 inline images 是否齐全 检查这篇文章是否齐全, 审计这篇文章, article audit
article-illustrate 给现有文章自动插图 生成插图, 文章配图
cover-image 生成文章封面图 生成封面, 文章封面
image-generation 独立图片生成 生成图片, create image, draw
baoyu-imagine image-generation 的兼容别名 baoyu-imagine
package-neat 同步 skill 包文档、索引、清单和发布元数据 整理一下, 同步文档, release audit

完整技能总览见 skills/index.md。

单 skill 展示页见 docs/skills/README.md。

典型流程

setup
  -> hot-topics
  -> research-brief
  -> viral-patterns
  -> write-article
       -> cover-image
       -> repurpose-content
            -> article-score-retro
                 -> platform-rubric-manager
       -> article-illustrate

典型产物：

  • 按平台归类的热点清单
  • 区分“讨论热度”和“行业重要性”的热点排序
  • output/briefs/ 下的结构化 article brief
  • 本地 ViralKB 模式结果
  • output/wechat/{slug}-article.md 形式的文章草稿
  • output/content/{slug}/ 下的多平台 ledger
  • output/images/wechat/{slug}-01.png 这类 inline images
  • output/images/wechat/{slug}-cover-final.png 形式的封面图
  • 可审计的 article artifact family 状态

安装方式

依赖安装

pip install python-dotenv requests feedparser numpy

配置 API Key

cp config/.env.example config/.env

至少填一个图片生成 provider：

OPENAI_COMPATIBLE_API_KEY=your_key_here
OPENAI_COMPATIBLE_BASE_URL=https://your-openai-compatible-base-url
# OR
OPENAI_API_KEY=your_openai_key_here
# OR
GOOGLE_AI_API_KEY=your_google_key_here

JINA_API_KEY=your_jina_key_here

创建输出目录

mkdir -p output/briefs output/wechat output/images/wechat data/viralkb

首次运行 setup

可以直接对 Agent 说 配置、设置、setup，也可以手动执行：

python scripts/setup.py

验证配置

python tools/config_loader.py
python tools/opencli_fetcher.py --check

平台安装

平台化安装说明见：docs/install/README.md

包括：

  • OpenCode
  • Claude Code
  • Codex
  • OpenClaw
  • Hermes

last30days 说明

skills/last30days/ 作为 Git submodule 引入，上游仓库是：

https://github.com/mvanhorn/last30days-skill.git

首次克隆本仓库后，如果你需要这个 skill，请运行：

git submodule update --init --recursive

仓库结构

skill-packaging/
├── README.md
├── README.en.md
├── MANIFEST.txt
├── docs/
│   ├── install/
│   └── overview/
├── skills/
│   ├── index.md
│   ├── setup/
│   ├── hot-topics/
│   ├── viral-patterns/
│   ├── viral-mining/
│   ├── write-article/
│   ├── repurpose-content/
│   ├── article-score-retro/
│   ├── platform-rubric-manager/
│   ├── multi-platform-content/
│   ├── article-illustrate/
│   ├── cover-image/
│   ├── image-generation/
│   └── baoyu-imagine/
├── rubrics/
├── tools/
├── config/
├── scripts/
├── templates/
└── data/

进一步阅读

  • 技能总览：skills/index.md
  • 技能展示页：docs/skills/README.md
  • 仓库总览：docs/overview/skill-package-overview.md
  • 平台标准说明：rubrics/README.md
  • 文章产物族规范：docs/overview/article-artifact-family.md
  • slug 命名规则：docs/overview/slug-rules.md
  • 多平台试跑 runbook：docs/runbooks/multi-platform-content-demo-runbook.md
  • 端到端工作流示例：docs/examples/article-workflow-example.md
  • 快速试跑 smoke test：docs/examples/smoke-test.md
  • 仓库一致性检查：python tools/repo_consistency.py
  • 版本变更记录：CHANGELOG.md
  • 发布流程：docs/release/release-process.md
  • 平台安装说明：docs/install/README.md
  • Article brief 模板：templates/article-brief.yaml
  • Article brief 示例：templates/article-brief.example.yaml

故障排查

没有 API key

检查 config/.env 是否至少配置了一个图片 provider。

viral-patterns 没有结果

先运行 viral-mining，或者先让 hot-topics 自动入库一批数据。

article_illustrate.py 没插入图片

确认文章在 --- 后包含 **加粗章节标题**。

opencli 无结果

确认：

  • Chrome 正在运行
  • 目标站点已登录
  • OpenCLI Browser Bridge 扩展已启用
  • python tools/opencli_fetcher.py --check 能通过

补充说明：

  • tools/opencli_fetcher.py 现在会在 Linux 和 macOS 上直接解析 opencli
  • 在 Windows 上会优先解析 opencli.cmd / opencli.exe / opencli.bat
  • 如果只有 opencli.ps1，会自动通过 PowerShell 调用，避免 Python 子进程找不到命令
  • Windows 控制台若不支持部分 Unicode 字符，脚本会回退到安全输出而不是直接崩溃

封面图缺少参考图

cover-image 默认期望用户提供 --ref 肖像或参考图路径。

Agent 使用方式

  1. 先运行 setup
  2. 查看 skills/index.md
  3. 用自然语言触发对应 skill
  4. 按 SKILL.md 和 references/ 执行
  5. 需要确定性执行时调用 tools/ 里的 Python 工具

About

Collect hot topics, research viral patterns, draft full articles with auto-illustrations, and generate YouTube-style cover images — all through skill files compatible with Codex, Claude Code, OpenCode, OpenClaw, and Hermes. Supports baoyu-imagine (aiberm/Gemini/OpenAI) for image generation.

Topics

agentaiskillviral-articleswriter

Resources

Readme
MIT license

Contributing

Contributing
Activity

Stars

6 stars

Watchers

0 watching

Forks

5 forks
Report repository

Releases

Packages

Used by

Contributors

Languages