wewrite

--- 一个给 AI Agent（Claude Code / Codex / OpenClaw / Hermes 等）用的公众号内容 Skill。你说「写一篇公众号文章」，它会抓热点、评选题、搜真实素材、按你的人格风格出稿并完成编辑审稿。正文完成后，你可以直接交付，也可以再单独要求配图、排版预览或推送草稿箱。原始正文始终保留；配图会生成独立图片和带图副本。想改就按自己的意思改，再让它「学习我的修改」，下一篇会更像你。 ``` "写一篇公众号文章" → 抓热点 → 选题评分 → 文章任务书 → 主张与来源清单 → 安全内容增强 → 初稿（真实信息锚定 + 风格注入） → 编辑判断 → 必要时改稿并复审 → 交付成稿 完成后按需追加： ├─ 配封面 / 完整配图 → 图片 + 带图副本 ├─ 排版预览 → 微信兼容 HTML └─ 推到草稿箱 → 明确授权且条件满足后发布 ``` ## ✨ 核心特性 - **一句话完成正文**：选题、素材、写作和审稿连续完成；说「交互模式」可在选题或框架处暂停确认。 - **后续动作真正独立**：配图、排版、发布都能在文章完成后单独执行；排版和发布不会偷偷触发生图。 - **模块化，one step at a time**：主入口 + 9 个独立 skill，只要选题说 `/wewrite-topic`、只要封面说 `/wewrite-visual`，缺前置会自己补齐。 - **写出能直接用的文章**：先明确读者问题、核心判断与证据边界，再写初稿；审稿不通过就直接改稿并复审，禁止编造作者经历。 - **7 套写作人格**：像选主题一样选文风，从深夜老友到冷静分析师，一行配置切换。 - **越用越像你**：编辑飞轮（学习你的修改）+ 范文风格库（SICO 式 few-shot）+ 阅读数据回填反哺选题。 - **18 主题排版引擎**：样式全内联、微信兼容修复、暗黑模式；`learn-theme` 还能从任意公众号文章学习一套新主题。 - **一稿多发**：小红书图文 / 抖音口播稿，内容级真改，检查编辑质量和源稿相似度。 - **成本可控**：可选把正文出稿路由给独立写作模型，实际费用取决于所选服务、模型和文章长度。 ## 效果预览 同一篇示例文章（[docs/demo-article.md](https://github.com/imraywang/wewrite/blob/main/docs/demo-article.md)）× 6 个主题，`wewrite preview` 真实渲染长图（含 label 小标签、steps 步骤卡、callout / timeline / quote / summary 组件与 AIGC 声明脚注）：
professional-clean（默认）
sspai
warm-editorial
tech-modern
bauhaus
midnight > 全部 18 个主题：装好后 `wewrite gallery` 在浏览器里并排对比 + 一键复制。 ## ✅ 适合 / ❌ 不适合 **✅ 适合**：公众号创作者的日常出稿（热点文/干货文/故事文/测评文）· 只想要某个环节的人（选题灵感、封面配图、质量自检、排版发布）· 想把已有文章一稿多发到小红书/抖音 · 想让 AI 逐渐学会自己文风的长期使用者。 **❌ 不适合**：普通网页/落地页排版（用前端 skill）· PPT/邮件/blog · 非公众号生态的 SEO · 追求组件级设计定制的纯排版需求（可以只用 `wewrite-publish`，但更推荐专门的排版 skill）。 ## 快速开始 ### 方式一：一键安装（推荐） ```bash git clone --depth 1 https://github.com/imraywang/wewrite.git ~/wewrite cd ~/wewrite && bash install.sh ``` `install.sh` 做三件事：装 `wewrite` CLI（uv/pipx，无则回退 venv）、把 10 个 skill 链接到 `~/.claude/skills/` 与 `~/.agents/skills/`（检测到 OpenClaw / Codex 时一并链接其 skills 目录）、把旧版用户状态迁到 `~/.wewrite/`。 ### 方式二：skills.sh 按需挑模块 ```bash npx skills add imraywang/wewrite ``` skill 目录自包含、复制即用；CLI 另装一条：`uv tool install wewrite`（或 `pipx install wewrite`）。 ### 方式三：让 AI 自己装 对任意 Agent 说一句： > 请帮我安装 https://github.com/imraywang/wewrite 这个 skill（跑仓库里的 install.sh） 装好后直接开聊： ``` 你：写一篇公众号文章 → 审过的本地成稿（默认不生图、不发布） 你：完整制作一篇公众号文章 → 成稿 + 配图 + 本地预览 你：推到公众号草稿箱 → 明确授权后才发布 你：今天写什么 → 只要选题 你：检查一下 → 生成档案 + 质量自检 你：改写成小红书 → 多平台改写 你：学习我的修改 → 编辑飞轮 你：看看有什么主题 / 换成 sspai 主题 → 主题画廊 / 重排版 你：做一个小绿书 → 图片帖（横滑轮播） 你：更新 → 升级到最新版 ``` OpenClaw / Codex / Hermes（三家均原生支持 folder-per-skill，无需构建转换） **OpenClaw / Codex**：方式一的 `install.sh` 检测到 `~/.openclaw` / `~/.codex` 时已自动链接。手动装： ```bash for s in ~/wewrite/skills/wewrite*; do ln -sfn "$s" ~/.openclaw/skills/$(basename "$s"); done # Codex 同理，目标换成 ~/.codex/skills/ ``` **Hermes**（自带技能管理器）： ```bash hermes skills install imraywang/wewrite ``` 各家均需 CLI 在 PATH：`uv tool install wewrite`。 ### 配置（可选） ```bash cp config.example.yaml ~/.wewrite/config.yaml ``` 填入微信公众号 `appid`/`secret`（推送需要）和图片 API key（生图需要）。**写作不需要这些配置**；排版可以直接生成本地 HTML，请求配图但没有图片服务时会输出图片提示词。配了 `WEWRITE_WRITER_API_KEY` 则正文可交给独立写作模型；实际费用以你使用的服务为准。 ## 模块速查 管道的每一段都是独立 skill。每篇文章保存在 `~/.wewrite/runs/<任务编号>/`，进度可恢复， 多篇同时进行也不会互相覆盖。上午选完题，下午说“继续上次”就能接上。 | 你说 | 激活 | 产出 | |------|------|------| | 今天写什么 / 找几个选题 | `wewrite-topic` | 10 个评分排序的选题 | | 就这个选题写一篇 | `wewrite-write` | 文章任务书 + 主张与来源清单 + 初稿 | | 检查一下 / 这篇怎么样 | `wewrite-review` | 事实核对 + 必要改稿 + 通过后生成成稿与编辑报告 | | 给这篇配个封面 | `wewrite-visual` | 一张封面图；不改原始正文 | | 给这篇完整配图 | `wewrite-visual` | 封面 + 必要内文图 + 带图副本 | | 推到草稿箱 / 换个主题 | `wewrite-publish` | 条件满足时生成微信草稿，否则保留本地 HTML | | 改写成小红书 / 抖音版 | `wewrite-rewrite` | 内容级真改的平台版本 | | 学习我的修改 / 导入范文 | `wewrite-learn` | playbook 规则 / 风格库 | | 看看文章数据 | `wewrite-stats` | 阅读数据回填 + 选题建议 | | 重新设置风格 | `wewrite-style` | style.yaml | ## 架构：三层解耦 设计原则一句话：**prompt 负责判断，Python 负责确定性**。 | 层 | 位置 | 内容 | |----|------|------| | Prompt | `skills/`（10 个自包含 skill） | 选题、事实、观点、实用性和表达判断，每个 skill 自带 references/ | | Runtime | `wewrite` CLI（pip 包） | 打分、转 HTML、调微信 API、生图、成本路由——确定性操作 | | State | `~/.wewrite/`（`WEWRITE_HOME` 可覆盖） | 凭证、风格、历史、学习产物、输出文件——全部在仓库外 | skill 目录复制到哪都能用；CLI 与 skill 独立安装升级；换机器只需带走 `~/.wewrite/`。 ## 核心能力 | 能力 | 说明 | 所在 | |------|------|------| | 热点抓取 | 微博 + 头条 + 百度实时热搜 | `wewrite hotspots` | | 高频需求 | 搜狗微信搜索垂类近期文章，用同题密度观察内容需求，不虚构阅读量 | `wewrite search-articles` | | SEO 评分 | 百度 + 360 搜索量化评分 | `wewrite seo` | | 选题生成 | 10 选题 × 3 维度评分 + 历史去重 | wewrite-topic | | 素材采集 | WebSearch 核对数据/引述/案例，并为每篇文章保存来源账本 | wewrite-write / `wewrite sources` | | 框架生成 | 7 套写作骨架（痛点/故事/清单/对比/热点解读/纯观点/复盘） | wewrite-write | | 文章任务书 | 写前明确目标读者、问题、交付、核心判断、反方和边界 | wewrite-write | | 主张与证据 | 区分事实、推断、意见与用户经历，逐项关联来源 | wewrite-write / `wewrite sources` | | 内容增强 | 按框架补足可支持的新角度、行动条件、真实细节或决策标准 | wewrite-write | | 编辑成稿 | 准确、观点、有用、合声、好读五项判断；不通过就直接改稿并复审 | wewrite-review / `wewrite content-eval` | | 风险提示 | 11 项机械检查，定位套话、碎句、重复节奏等；不判断作者身份 | `wewrite score` | | SEO 优化 | 标题策略 / 摘要 / 关键词 / 标签 | wewrite-review | | 视觉 AI | 按任务设置生成封面/必要配图，生成前检查数量和预估费用 | `wewrite image-gen` | | 排版发布 | 18+ 主题 + 微信兼容修复 + 暗黑模式 | `wewrite preview/publish` | | 多平台改写 | 一稿 → 小红书/抖音，内容级真改 + 原创度门 | wewrite-rewrite | | 效果复盘 | 微信数据分析 API 回填阅读数据，反哺选题 | `wewrite stats` | | 范文风格库 | 从文章提取结构与节奏；第三方内容不提供观点和个人经历 | `wewrite exemplar` | | 风格飞轮 | 单次修改只参考，重复出现或明确确认后才成为同范围稳定规则 | `wewrite learn-edits` | | 排版学习 | 从任意公众号文章 URL 提取排版主题 | `wewrite learn-theme` | | 文章采集 | 从公众号 URL 提取正文为 Markdown，可导入范文库 | `wewrite fetch-article` | ## ✍️ 写作人格 像选排版主题一样选写作风格。在 `~/.wewrite/style.yaml` 里一行配置： ```yaml writing_persona: "midnight-friend" ``` | 人格 | 适合 | 风格特点 | |------|------|---------| | `midnight-friend` | 个人号/自媒体 | 口语化、保留自我质疑；无个人材料时不用虚构故事开场 | | `warm-editor` | 生活/文化/情感 | 温暖叙事、故事嵌套数据、柔和情绪弧 | | `industry-observer` | 行业媒体/分析 | 中性分析、数据先行、稳中带刺 | | `sharp-journalist` | 新闻/评论 | 犀利简洁、数据驱动、强观点 | | `cold-analyst` | 财经/投研 | 冷静克制、逻辑链条、风险意识强 | | `humor-storyteller` | 泛科技娱乐/热点辣评 | 包袱密集、荒诞解构、笑完有余味 | | `tech-coder` | 技术教程/开发者社区 | 代码先行、注释式行文、版本敏感 | 每个人格定义语气、数据呈现和节奏偏好，但不能覆盖事实和个人材料边界。只有用户在当前任务 明确提供的经历才能写成作者亲历。详见 `skills/wewrite-write/personas/`；自定义人格放 `~/.wewrite/personas/`。 ## 内容质量 WeWrite 的目标是**写出准确、有观点、对读者有用的文章**。核心机制： 1. **先定义再写**：任务书明确目标读者、真正问题、核心判断、新增价值、反方和适用边界 2. **主张对证据**：事实、推断、意见和用户经历分别记录；无法支持的具体主张不进入初稿 3. **安全增强**：热点文找有证据的新角度，干货文补行动条件，故事文只用真实材料，对比文给决策条件 4. **编辑门槛**：按准确、观点、有用、合声、好读判断；未通过就直接修改并复审，只有通过才生成成稿 5. **谨慎学习**：范文只校准结构与节奏；单次人工修改不自动升级为所有文章的硬规则 每篇任务保留 `brief.yaml`、`claims.yaml`、`draft.md`、`article.md` 和 `review-report.json`，方便追溯“为什么这样写”和初稿到成稿改了多少。完整标准见 [`docs/content-quality-rubric.md`](https://github.com/imraywang/wewrite/blob/main/docs/content-quality-rubric.md)。 ## 排版引擎 ```bash wewrite gallery # 浏览器内预览所有主题（并排对比 + 一键复制） wewrite 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` | | 专属 | `impeccable`、`lobster-notes` | 所有主题均支持微信暗黑模式。`wewrite learn-theme ` 学到的新主题存在 `~/.wewrite/themes/`，加载时优先于内置主题。 另有四个排版细节自动处理：**产物合规校验**（`wewrite validate`，preview/publish 自动跑，拦截会被微信过滤的写法）、**粘贴加固**（preview 产物自动做 `` 包裹，复制进编辑器不掉样式；API 发布路径无需）、**GIF 角标**（动图自动加右上角标签）、**H2 章节编号**（主题 YAML 设 `section_numbering: true` 启用）。 微信兼容性自动修复（converter 内置兜底） | 问题 | 自动修复 | |------|---------| | 外链被屏蔽 | 转为上标编号脚注 + 文末参考链接 | | 中英混排无间距 | CJK-Latin 自动加空格 | | 加粗标点渲染异常 | 标点移到 `` 外 | | 原生列表不稳定 | `

/
` 转样式化 `` | | 暗黑模式颜色反转 | 注入 `data-darkmode-*` 属性 | | `