sansheng-write · 中文长文写作引擎

把「选题 → 大纲 → 正文 → 改稿 → 排版 → 配图」跑完的 Claude Code skill。喂它你的语料，它长出你的声音。

中文 | English

先看产出，再决定装不装

↓ 20 秒手机实拍：一篇公众号长文从选题落定到成品排版，跑完整条链的样子。

https://github.com/user-attachments/assets/7b5d8a8c-7caf-41e3-957e-5c2428859c79

一句「帮我写一篇关于 X 的文章」，它跑完这条链，最后给你一份微信公众号能直接粘贴的 HTML：

选题快评 → 大纲（含开篇策略分流）→ 正文 → 改稿（去 AI 味三层过滤）
   → 标题（内联锻造 5 个候选）→ 排版（10 个组件 + 契约门）→ 配图 / 封面

排版组件都在 templates/，配色跟着你的主题走：

质量不靠自觉，靠契约门：作者审批绑定具体稿件摘要；本 Skill 的 visual planner 是唯一真实生产者，宝玉文章配图 / 信息图作为可复验的方法来源，最终像素只允许 baoyu-image-gen；封面与插图的全部内容文字必须和画面一次性原生生成，禁止 SVG 或本地字体后期补字。最终视觉、HTML 与微信草稿 media_id 用 receipt 逐层绑定。产出被改过，已完成下游会自动变成 dirty，不能拿旧绿灯继续发。

$ python scripts/format_layout.py 定稿.html --all --check
  ✅ 成功将 3 个原生 H2 转换为 PART 格式
  ✅ 表格品牌化完成（主题色表头 / 行分隔线 / 交替行色 / 圆角容器）
  ✅ 成功将 3 处重点标记转换为主题色文字
  ⚠️  2 个警告（非阻塞），无错误

门里检查半角标点、加粗密度、词性比例、套话黑名单、信息图数量、封面比例……

这是什么

一套中文长文的写作方法论 + 排版工程，封装成 Claude Code 的 skill。

它不是「输入标题、输出文章」的一键生成器。它是一条有纪律的流水线：
每个阶段有它该读的规则，每个产出有它该过的门。你在里面的角色是主笔，不是甲方。

它也不是通用写作助手。它为「中文、长文、要发出去给人读」这个场景做了很多取舍：
排版针对微信公众号的 HTML 限制做了大量妥协，去 AI 味的规则针对中文的套话习惯。

它到底帮你做什么

去 AI 味的七条核心

不是句式伪装，是内容层的要求：

1. 材料先承重 -- 每个核心章节都能指出真实材料；不够就补、缩或停
2. 来源不过界 -- 事实、自述、转述、推断和未知分开，先后不冒充因果，结果不冒充动机
3. 逐段有新增 -- 每段至少推进事实、动作、例子、区分或后果之一
4. So What 按需兑现 -- 读者后果没显现才追问，动作或案例已经说明白就停
5. 作者声来自知识路径 -- 写清为什么知道、什么改变了判断、哪里仍不确定，不强塞「我」
6. 可信细节会停笔 -- 只用有来源的动作、物件、数字或原话；情绪成立就删解释尾巴
7. 句间引力 -- 上句尾留钩子，下句头接住

诚实边界：机器只能硬拦部分表层指纹；句式体检也只是软提示。材料真伪、因果边界和段落新增信息仍靠材料账本、事实复核与异模型语义差分。

开箱效果 vs 喂料后效果

这一节比上面所有内容都重要。

不喂料时，产出接近通用 AI 写作 -- 这是设计，不是缺陷。

风格是你的语料长出来的，不是提示词变出来的。这个仓库里没有任何真实作者的风格手册：
那类手册要从别人受版权的作品里蒸馏，不该由我打包分发给你；何况模仿谁本来就该你自己挑。

取而代之的是：

• 一份 怎么自建作者风格手册 的 HOW-TO（三步，含可直接用的蒸馏提示词）
• 一份虚构作者的 示例手册，演示格式与颗粒度
• 一份 原创的人味示例集，没自备语料时自动注入做基础兜底

顺带一提：最该做的第一份手册是「你自己」的。把你写得最满意的 20 篇丢进去蒸馏，
出来的手册会告诉你一些你没意识到的自己的习惯 -- 有些值得保留，有些该改。

三条使用路径

按你愿意装多少东西分三档。每一档都能独立用；缺东西只降级那一个环节，不断整链。

① 纯方法论（零门槛）

选题 / 大纲 / 正文 / 改稿 / 标题，全流程可用。

pip install pyyaml
python scripts/setup_check.py     # 体检：告诉你能跑到第几档

② + 排版出微信 HTML

加：一键排版、契约门、10 个组件模板。

# 再装：bun（跑 markdown→HTML 转换器）+ Node 18+
cd scripts && npm install         # jimp：给配图加水印

③ 全自动到发布

加：配图、封面、信息图、推送草稿箱。

cp .env.example .env              # 填你自己的 key

依赖矩阵

低档能力可以独立使用；一旦进入“定稿→草稿箱”机械链，配图、BGM、视觉 QA、发布预检和官方读回都是硬门，任一失败都会非零退出。封面文字、品牌色、粘土配图方法、必备文字恰好一次与 renderer 都有机器校验；错字只允许同 prompt 单张重渲，不提供 SVG/后期叠字、force、legacy、跳过预检、人工豁免或自定义生图命令。

可选功能（默认全关，不配也能用）

上面三档之外，还有一组一稿多投的延伸模块：把已发布的文章派生到别的平台。

这些默认全部关闭。 你不启用的话，它们不会出现在任何命令的输出里——不报错、不提示、不占用你的注意力。只想写文章的话，这一节可以直接跳过。

朋友圈文案写入 _moments-copy.md：文件首字符就是 emoji，无标题、代码围栏、前导空白或
附加说明。Agent 在聊天里交付时也必须把它作为独立最终消息原样发送，避免复制时带入杂字。

怎么启用：

python scripts/setup.py        # 交互式：问你要哪些，只收集那些模块需要的配置

它只会问你选中的模块所需的东西，已经配好的不会重复问；第二次运行是「改配置」而不是从头再来。检测到非交互环境（CI、管道）时只打印清单、不阻塞。

装了 ruamel.yaml（pip install ruamel.yaml）时会保留注释就地改写你的 profile；没装则不写盘，改为打印配置片段让你自己粘贴——不会默默抹掉你 profile 里的注释。

共同前提：小红书和微博只在你按篇明确点名时触发，不随正式链接自动执行；两端分别生图，
不复用同一套比例。模块把内容填进发布框后就停手，最后那下「发布」永远由你点。填错了还能改，发出去收不回来。

安装

# 方式一：Claude Code 插件市场
claude plugin marketplace add sanshengai/sansheng-write
claude plugin install sansheng-write

# 方式二：clone + 软链
git clone https://github.com/sanshengai/sansheng-write.git
ln -s "$(pwd)/sansheng-write" ~/.claude/skills/sansheng-write

国内加速下载

GitHub 直连不畅时，给 clone 地址前面加一层公共镜像即可（下载源码 zip 同理）：

# 加速 clone（把 gh-proxy.com 换成 ghfast.top 即备用镜像）
git clone https://gh-proxy.com/https://github.com/sanshengai/sansheng-write.git

插件市场方式暂无稳定国内镜像；网络不畅时用上面的加速 clone + 软链。

更新

升级到新版，取决于你当初怎么装的：

• 插件市场装的：claude plugin marketplace update 刷新市场，再 claude plugin update sansheng-write
• clone + 软链装的：进本仓目录 git pull（软链即时生效，不必重装、不必重连）

怎么知道有新版：看本仓 Releases；点仓库右上角 Watch → Custom → Releases，发新版时 GitHub 会通知你。每版改了什么见 CHANGELOG。

快速上手（从 clone 到第一篇）

python scripts/setup_check.py                       # 1. 体检：告诉你能跑到第几档、还缺什么
cp -r profile.example ~/my-writing-profile          # 2. 复制一份 profile
export SANSHENG_WRITE_PROFILE_DIR=~/my-writing-profile
export SANSHENG_WRITE_DATA_DIR=~/my-articles        # 3. 文章存哪
$EDITOR ~/my-writing-profile/context.md             # 4. 告诉它你是谁（写给谁、怎么说话）
$EDITOR ~/my-writing-profile/brand.yaml             # 5. 署名 + 主题 + 身份卡（发公众号才需要）

# 要出微信 HTML（②档）再补：装 bun + Node 18 + baoyu-skills 插件，然后
cd scripts && npm install                           # jimp 水印
# 要全自动配图/发布（③档）再补：
cp .env.example .env                                # 填生图 key；微信凭证配在 baoyu 侧（见依赖矩阵）

然后在 Claude Code 里说一句「帮我写一篇关于 X 的文章」。
每一步缺了什么，setup_check.py 都会指出来；缺件只降级对应环节，不断整链。

配置

三层分离 -- 代码在仓里，你的东西在你自己的目录里：

不配 profile 也能跑 -- 自动回退到仓内 profile.example/（中性配色 + 占位署名）。
这是正常路径，不是错误。

换主题一行搞定（profile/brand.yaml）：

theme: "sage"      # slate 钢青（默认） | ink 近墨黑 | sage 草木绿 | jade 青玉绿 | amber 琥珀赭 | plum 梅子紫

模板里一个 hex 都不用改 -- 排版最后一步由 process_theme() 统一替换。

隐私

• 密钥只从 env / .env 读，从不打印，报错信息里自动打码。
• 运行观察日志（_skill-observations.jsonl）只写本地、不联网，
  文章名默认写哈希。整个日志可以关：SANSHENG_WRITE_TELEMETRY=off。
• 你的语料、草稿、密钥，不会被发送到任何地方。生图 / 发布是你显式调用时才打对应的 API。

配套文章 · Article

（讲这个 skill 怎么用、以及怎么脱敏开源的公众号文章 -- 写好后补链接）

关于作者 · About the author

🌐 网站 sanshengai.top · 🎧 小宇宙 · 微博 · 小红书 · ✉️ 邮箱

我是叁笙，一个用 AI 做内容、也用 AI 造工具的人。我做了个人站「叁笙早安 AI」--
每天清晨一份 AI 早报，加深度长文，还有一堆自己写来自己用的小东西：读书蒸馏、职业 AI 风险测评、
GitHub 宝藏精选、AI 羊毛铺……

这个仓里的 skill，就是我做这些内容时在真实工作流里一点点磨出来的。它写过的每一篇我都亲手改过，
改的地方又回头变成了它的规则。觉得好用，就清洗脱敏开源出来 -- 你可以直接用，也欢迎改成自己的。

如果这些东西对你有用，欢迎来网站逛逛，或扫码关注公众号「叁笙早安AI」
（公众号没有跳转链接，扫码最快）：

_{微信扫码关注 · 叁笙早安AI}

致谢与依赖 · Credits & Dependencies

致谢（借鉴来源）

• baoyu-skills by 宝玉（MIT）--
  排版链上游的 markdown→HTML 转换、信息图与发布工具链。本 skill 的排版后处理接在它的产出之后，
  skill 的组织方式也从中借鉴颇多。不捆绑分发，请自行安装。

• gzh-design-skill by 甲木 × 摸鱼小李（AGPL-3.0）--
  排版层的重要方法论参照：「文章类型 → 组件配方表」、视觉层级与全文用色配额、封面文案策略
  （两层标题分离 / 五视角）、「模板源头 lint + 产物 HTML 校验」双关卡、待补素材居中占位约定，
  这些设计思想均借鉴自该项目。仅借鉴思路：本仓的组件 HTML 与校验脚本均为独立实现，
  不含其代码或模板。不捆绑分发，两项目互不依赖。

• WeWrite by oaker-io（MIT）--
  「学习我的修改」闭环飞轮的整体设计（lessons → playbook 聚合、pattern 类型划分）、内容增强
  四策略框架（角度发现 / 密度强化 / 细节锚定 / 真实体感）与微信兼容微调思路源自该项目；
  脚本代码为独立实现。不捆绑分发。

• humanizer by blader（MIT）--
  反 AI 味过滤器中「四种高频 AI 句式」的识别框架来自该项目。

• human-writing by KKKKhazix（MIT）--
  材料承重、事实与推理分账、来源边界、逐段新增信息、结尾删除测试等方法给了本次改造启发。
  本仓只吸收方法思想并按自身流水线独立重写，未复制其代码或原文规则，不捆绑分发。

运行依赖（不捆绑，请自行安装）

画中文数据图需要中文字体。建议用 OFL 许可的
Noto Sans CJK / 思源黑体，
而不是 Windows 自带的微软雅黑（专有字体）。

License 兼容性

本仓以 MIT 分发。仓内不捆绑任何第三方源码（scripts/node_modules/ 已 gitignore，
由你 npm install 生成）。上表均为运行时依赖，其许可与本仓分发无关，已逐个核对并标注。

用着顺手的话，点个 ⭐ 吧 —— 这是我判断「要不要继续做下去」最直接的信号。

License

MIT © 2026 叁笙 (sansheng)