WeWrite

公众号文章全流程 AI Skill —— 从热点抓取到草稿箱推送，一句话搞定。

兼容 Claude Code 和 OpenClaw 的 skill 格式。安装后说「写一篇公众号文章」即可触发完整流程。

它能做什么

"写一篇公众号文章"
  → 抓热点 → 选题评分 → 素材采集 → 框架选择
  → 写作（真实信息锚定 + 3层反检测 + 编辑锚点）
  → SEO优化 → AI配图 → 微信排版 → 推送草稿箱

首次使用时会引导你设置公众号风格，之后每次只需一句话。生成的文章带有 2-3 个编辑锚点——花 3-5 分钟加入你自己的话，文章就会从"AI 初稿"变成"你的作品"。

核心能力

能力	说明	实现
热点抓取	微博 + 头条 + 百度实时热搜	scripts/fetch_hotspots.py
SEO 评分	百度 + 360 搜索量化评分	scripts/seo_keywords.py
选题生成	10 选题 × 3 维度评分 + 历史去重	references/topic-selection.md
素材采集	WebSearch 真实数据/引述/案例	SKILL.md Step 3b
框架生成	5 套写作骨架（痛点/故事/清单/对比/热点）	references/frameworks.md
文章写作	真实信息锚定 + 3 层反检测 + 编辑锚点	references/writing-guide.md
SEO 优化	标题策略 / 摘要 / 关键词 / 标签	references/seo-rules.md
视觉 AI	封面 3 创意 + 内文 3-6 配图	toolkit/image_gen.py
排版发布	16 主题 + 微信兼容修复 + 暗黑模式	toolkit/cli.py
效果复盘	微信数据分析 API 回填阅读数据	references/effect-review.md
风格飞轮	学习你的修改，越用越像你	references/learn-edits.md

写作人格

像选排版主题一样选写作风格。在 style.yaml 里一行配置：

writing_persona: "midnight-friend"

人格	适合	朱雀实测
midnight-friend	个人号/自媒体	39% 人工 / 10% AI
warm-editor	生活/文化/情感	10% 人工 / 33% AI
industry-observer	行业媒体/分析	10% 人工 / 40% AI
sharp-journalist	新闻/评论	28% 疑似AI / 72% AI
cold-analyst	财经/投研	26% 疑似AI / 74% AI

每个人格定义了语气浓度、数据呈现方式、情绪弧线、不确定性表达模板等参数。详见 personas/ 目录。

关于 AI 检测

WeWrite 生成的是高质量初稿。我们用朱雀 AI 实测了从无优化到完整 pipeline 的效果：

100% AI（无优化）→ 52% AI（加 WebSearch 素材）→ 10% AI（midnight-friend 人格）

策略是让你的编辑成本最低：

1. 写作人格：选择个人声音浓度高的人格，开箱即用就能降低 AI 特征
2. 素材采集：自动 WebSearch 真实数据/引述/案例，锚定在文章中（不编造）
3. 编辑锚点：在 2-3 个关键位置标记"在这里加一句你自己的话"
4. 学习飞轮：每次你编辑后说"学习我的修改"，下次初稿更接近你的风格

个人声音越强的人格，AI 检测通过率越高。专业/客观风格的人格（journalist、analyst）建议配合编辑锚点使用。

排版引擎

16 个主题

# 浏览器内预览所有主题（并排对比 + 一键复制）
python3 toolkit/cli.py gallery

# 列出主题名称
python3 toolkit/cli.py themes

类别	主题
通用	professional-clean（默认）、minimal、newspaper
科技	tech-modern、bytedance、github
文艺	warm-editorial、sspai、ink、elegant-rose
商务	bold-navy、minimal-gold、bold-green
风格	bauhaus、focus-red、midnight

所有主题均支持微信暗黑模式。

微信兼容性自动修复

问题	自动修复
外链被屏蔽	转为上标编号脚注 + 文末参考链接
中英混排无间距	CJK-Latin 自动加空格
加粗标点渲染异常	标点移到 </strong> 外
原生列表不稳定	<ul>/<ol> 转样式化 <section>
暗黑模式颜色反转	注入 data-darkmode-* 属性
<style> 被剥离	所有 CSS 内联注入

容器语法

:::dialogue
你好，请问这个功能怎么用？
> 很简单，直接在 Markdown 里写就行。
:::

:::timeline
**2024 Q1** 立项启动
**2024 Q3** MVP 上线
:::

:::callout tip
提示框，支持 tip / warning / info / danger。
:::

:::quote
好的排版不是让读者注意到设计，而是让读者忘记设计。
:::

安装

Claude Code：

git clone --depth 1 https://github.com/oaker-io/wewrite.git ~/.claude/skills/wewrite
cd ~/.claude/skills/wewrite && pip install -r requirements.txt

OpenClaw：

git clone --depth 1 https://github.com/oaker-io/wewrite.git ~/.openclaw/skills/wewrite
cd ~/.openclaw/skills/wewrite && pip install -r requirements.txt

安装后 skill 会在每次运行时自动检查新版本。有更新时说"更新"即可升级。

配置（可选）

cp config.example.yaml config.yaml

填入微信公众号 appid/secret（推送需要）和图片 API key（生图需要）。不配也能用——自动降级为本地 HTML + 输出图片提示词。

快速开始

你：写一篇公众号文章
你：写一篇关于 AI Agent 的公众号文章
你：交互模式，写一篇关于效率工具的推文
你：帮我润色一下刚才那篇
你：学习我的修改                  → 飞轮学习
你：看看有什么主题                → 主题画廊
你：换成 sspai 主题               → 切换主题
你：看看文章数据怎么样            → 效果复盘
你：做一个小绿书                  → 图片帖（横滑轮播）
你：检查一下反 AI 配置              → 诊断报告
你：优化写作参数                    → 迭代调优 writing-config

目录结构

wewrite/
├── SKILL.md                  # 主管道（273行，Step 1-8）
├── config.example.yaml       # API 配置模板
├── style.example.yaml        # 风格配置模板
├── writing-config.example.yaml # 写作参数模板（说"优化参数"自动调优）
├── requirements.txt
│
├── dist/openclaw/            # OpenClaw 兼容版（CI 自动构建）
│
├── scripts/                  # 数据采集 + 诊断 + 构建
│   ├── fetch_hotspots.py       # 多平台热点抓取
│   ├── seo_keywords.py         # SEO 关键词分析
│   ├── fetch_stats.py          # 微信文章数据回填
│   ├── build_playbook.py       # 从历史文章生成 Playbook
│   ├── learn_edits.py          # 学习人工修改
│   ├── humanness_score.py      # 文章"人味"打分器（11 项检测 + 参数映射）
│   ├── diagnose.py             # 反 AI 配置诊断
│   └── build_openclaw.py       # SKILL.md → OpenClaw 格式转换
│
├── toolkit/                  # Markdown → 微信工具链
│   ├── cli.py                  # CLI（preview / publish / gallery / themes / image-post）
│   ├── converter.py            # Markdown → 内联样式 HTML + 微信兼容修复
│   ├── theme.py                # YAML 主题引擎
│   ├── publisher.py            # 微信草稿箱 API + 小绿书图片帖
│   ├── wechat_api.py           # access_token / 图片上传
│   ├── image_gen.py            # AI 图片生成（doubao / OpenAI）
│   └── themes/                 # 16 套排版主题（含暗黑模式）
│
├── personas/                 # 5 套写作人格预设（含朱雀实测数据）
│
├── references/               # Agent 按需加载
│   ├── writing-guide.md        # 写作规范 + 3 层反检测（统计/语言/内容）+ 14 项自检
│   ├── frameworks.md           # 5 种写作框架
│   ├── topic-selection.md      # 选题评估规则
│   ├── seo-rules.md            # 微信 SEO 规则
│   ├── visual-prompts.md       # 视觉 AI 提示词规范
│   ├── wechat-constraints.md   # 微信平台限制 + 自动修复
│   ├── style-template.md       # 风格配置字段 + 16 主题列表
│   ├── onboard.md              # 首次设置流程
│   ├── learn-edits.md          # 学习飞轮流程
│   └── effect-review.md        # 效果复盘流程
│
├── output/                   # 生成的文章
├── corpus/                   # 历史语料（可选）
└── lessons/                  # 修改记录（自动生成）

运行时自动生成（不入 git）：style.yaml、history.yaml、playbook.md、writing-config.yaml

工作流程

Step 1  环境检查 + 加载风格（不存在则 Onboard）
  ↓
Step 2  热点抓取 → 历史去重 + SEO → 选题
  ↓
Step 3  框架选择 → 素材采集（WebSearch 真实数据）
  ↓
Step 4  维度随机化 → 写作（3层反检测 + 真实素材锚定 + 编辑锚点）
  ↓
Step 5  SEO 优化 → 去 AI 逐层验证（14 项自检 + humanness_score 打分）
  ↓
Step 6  视觉 AI（封面 + 内文配图）
  ↓
Step 7  预检 + 排版 + 发布（16 主题 + 微信兼容修复）
  ↓
Step 8  写入历史 → 回复用户（含编辑建议 + 飞轮提示）

默认全自动。说"交互模式"可在选题/框架/配图处暂停确认。

写作参数优化

在对话中说「优化写作参数」或「优化参数」，Agent 会自动迭代调优你的 writing-config.yaml：

1. 用当前参数写测试短文
2. 用 humanness_score.py 打分（11 项检测，连续 0-1 分数）
3. 找到最低分维度，调整对应参数
4. 重复 N 轮（默认 3 轮）
5. 保留得分最好的参数组合

# 独立打分（不需要 Agent）
python3 scripts/humanness_score.py article.md --verbose

# JSON 输出（含每项分数 + 参数映射）
python3 scripts/humanness_score.py article.md --json

优化后的 writing-config.yaml 不入 git——每个用户跑出自己的最优参数。

Toolkit 独立使用

# Markdown → 微信 HTML
python3 toolkit/cli.py preview article.md --theme sspai

# 主题画廊
python3 toolkit/cli.py gallery

# 发布草稿箱
python3 toolkit/cli.py publish article.md --cover cover.png --title "标题"

# 小绿书/图片帖（横滑轮播，3:4 比例，最多 20 张）
python3 toolkit/cli.py image-post photo1.jpg photo2.jpg photo3.jpg -t "周末探店" -c "在望京发现的宝藏咖啡馆"

# 抓热点
python3 scripts/fetch_hotspots.py --limit 20

# SEO 分析
python3 scripts/seo_keywords.py --json "AI大模型" "科技股"

# 诊断反 AI 配置
python3 scripts/diagnose.py

License

MIT