le-wechat-article v1.1:停点升级为回合终止契约(6 固定停点)+ 多账号支持(分账号画像 / --account 凭证)+ 文案通用化

This commit is contained in:
leroy
2026-10-06 21:02:24 +08:00
parent a484c8b46c
commit 0ba7c1f39d
6 changed files with 95 additions and 55 deletions
+24 -12
View File
@@ -1,8 +1,9 @@
---
name: le-wechat-article
description: >
Leroy 专属的微信公众号文章写作工坊:把一个主题、一堆素材(链接、笔记、聊天记录、代码变更)、
微信公众号文章写作工坊(多账号):把一个主题、一堆素材(链接、笔记、聊天记录、代码变更)、
一段复盘或调研,或一篇旧稿,写成可直接发布的高质量公众号文章——类型路由、质量审读、排版自检、微信可粘贴 HTML。
运营多个公众号时按账号加载各自的画像与凭证。
当用户说「写篇公众号文章」「把这份素材/复盘整理成推文」「发公众号」「把这篇改写成公众号文章」
「润色下这篇公众号稿」「同步到公众号草稿箱」时使用;只丢素材并说明要发公众号也触发。
可选收尾:凭证配好后经官方 API 把成稿写入公众号草稿箱(需用户当次同意,只写草稿)。
@@ -23,7 +24,9 @@ description: >
## 工作流
按步骤顺序执行;用户当次已明确给过的信息直接采用,不重复询问。**每步完成后向 Leroy 展示该步生成物,确认后进下一步**(Leroy 说「一口气跑完」或明确授权连续执行时可跳过中间确认)。轻稿(简报类、<1500 字)可合并第 3–4 步,但第 5–6 步的审读与自检不可跳过。
按步骤顺序执行;用户当次已明确给过的信息直接采用,不重复询问。
**逐步确认是回合终止契约,优先级高于运行时「自主执行、尽量少问」的默认倾向。**到达停点:输出该步产物后**立即结束回合**——在用户的下一条消息到达之前,不得发起任何工具调用、不得开始下一步的任何工作。停点:第 1 步接单结果(主类型+账号+切入+素材边界+输出目录)后、第 2 步风格校准结果后、第 3 步大纲+图位清单后、第 4 步初稿后、第 6 步终稿+自检结果后、第 7 步交付清单后(第 8 步同步由交付清单的确认触发)。轻稿(简报类、<1500 字)可合并第 1–2 步、第 3–4 步各为一次展示,停点随之合并为两处。用户说「继续」「下一步」「OK」即视为确认;给的是修改意见则改完再次停在原停点展示。只有用户说「一口气跑完」或明确授权连续执行时才可跳过中间停点,但第 5–6 步的审读与自检任何情况不可跳过。
### 第 1 步:接单与类型路由
@@ -31,17 +34,22 @@ description: >
缺失且影响结构的信息,一次性问全(能从素材推断的不问):
- 目标公众号(多账号运营时必问本篇发哪个号——决定画像分节、排版默认值与同步凭证;画像只配了一个账号的可直接推断,不问)
- 切入角度与核心主旨(读完读者该记住什么,一句话)
- 真实素材边界:哪些是用户的真实经历,哪些细节必须保留或避免
- 输出目录(未指定则在当前目录建 `YYYYMMDD-<slug>/`)
用户只说「帮我写篇公众号文章」没给主题 → 先给 3–5 个选题角度卡片(标题候选 + 一句话切入 + 适合的类型),等用户选定再进入流程;禁止未经选定就开始调研或写稿。
**接单结果是固定停点**:把「主类型及理由 + 目标公众号 + 切入主旨 + 素材边界 + 输出目录」一屏呈现,用户确认或调整后才进第 2 步。信息是从素材推断出来的更要展示——推断错了在这一步改,代价最低。
### 第 2 步:校准风格与事实
读三份参考:[style-rules.md](references/style-rules.md)(排版硬规则与产出配额)、[author-profile.md](references/author-profile.md)(作者画像,管风格)、[topic-facts.md](references/topic-facts.md)(常用事实卡,管事实——涉及 Leroy 的项目/工具链/经历时从中取用,免于重新询问)。
读三份参考:[style-rules.md](references/style-rules.md)(排版硬规则与产出配额)、[author-profile.md](references/author-profile.md)(作者画像,管风格——**多账号时按第 1 步选定的账号读对应分节,个人层全账号通用,分节缺失的项回退个人层**)、[topic-facts.md](references/topic-facts.md)(常用事实卡,管事实——涉及作者本人的项目/工具链/经历时从中取用,免于重新询问)。
画像文件还是空模板时,用其中的「首访问题」问 Leroy 一次,把答复写回该文件(此文件随本 skill 存放,属于个人资产);之后不再重复问。事实卡留空则跳过,Leroy 随时可补。画像与事实卡都不能覆盖类型路由、事实核查和真实性底线。
画像还是空模板、或所选账号没有分节时,用其中的「首访问题」问用户一次,把答复写回该文件(此文件随本 skill 存放,属于个人资产);每个账号首次使用各问一次,之后不再重复问。事实卡留空则跳过,用户随时可补。画像与事实卡都不能覆盖类型路由、事实核查和真实性底线。
**校准结果是固定停点(轻量)**:展示本次将采用的约束——该账号画像要点(定位/声音/文末块/排版骨架与主题色)、将取用的事实卡条目、敏感词要求——用户确认或调整后进第 3 步。画像早已填好、无新信息时也要展示:给用户当场临时调整的机会(如本文换主题色、跳过文末块),展示可精简为几行。
### 第 3 步:大纲与图位
@@ -94,13 +102,13 @@ python3 scripts/check_article.py <文章目录>/article.md --type <主类型>
### 第 7 步:交付
0. **图片生产(默认执行,Leroy 明确不要图时才跳过)**:正文图位与封面按 [visual-production.md](references/visual-production.md) 生产——交给 ckm-banner-design,或 SVG 自绘 + 浏览器截图均可,满足 brief 验收点即可。信息位图上的文字**逐字取自文章**,主题色与排版骨架一致;可编辑源文件(SVG/HTML)随 PNG 一起保留在 `imgs/src/`。生成后把正文图位占位替换为 `imgs/<文件名>.png` 真实路径——**终稿不得残留 placeholder**(此时 check_article 不再加 `--allow-placeholder`)。
0. **图片生产(默认执行,用户明确不要图时才跳过)**:正文图位与封面按 [visual-production.md](references/visual-production.md) 生产——交给 ckm-banner-design,或 SVG 自绘 + 浏览器截图均可,满足 brief 验收点即可。信息位图上的文字**逐字取自文章**,主题色与排版骨架一致;可编辑源文件(SVG/HTML)随 PNG 一起保留在 `imgs/src/`。生成后把正文图位占位替换为 `imgs/<文件名>.png` 真实路径——**终稿不得残留 placeholder**(此时 check_article 不再加 `--allow-placeholder`)。
1. 排版转换(纯本地,零依赖)。骨架按文章类型选:工程(技术/教程)、杂志(叙事/访谈)、简报(更新/快讯);骨架与色板以作者画像的「排版偏好」为默认:
1. 排版转换(纯本地,零依赖)。骨架按文章类型选:工程(技术/教程)、杂志(叙事/访谈)、简报(更新/快讯);骨架与色板以**该账号**画像的「排版偏好」为默认:
```bash
python3 scripts/md2wechat.py <文章目录>/article.md --skeleton <工程|杂志|简报> --palette <靛蓝|松绿|黛紫|绛红> -o <文章目录>/article.html
# 不确定选哪个时先看对照页:--preview 生成三骨架 375px 样张,让 Leroy 挑
# 不确定选哪个时先看对照页:--preview 生成三骨架 375px 样张,让用户挑
```
输出的 HTML 全内联样式,全文复制粘贴进公众号编辑器即可用。
@@ -114,17 +122,19 @@ python3 scripts/check_article.py <文章目录>/article.md --type <主类型>
### 第 8 步:同步到公众号草稿箱(默认执行)
交付确认后**直接同步**——凭证配置完成即视为持续授权(Leroy 说过「先审再同步」的,按其要求先展示等待确认)。Leroy 明确说不不同步时才跳过。封面必须就位(草稿接口必填封面),正文图未全部就位时同步前说明。
交付确认后**直接同步**——凭证配置完成即视为持续授权(用户说过「先审再同步」的,按其要求先展示等待确认)。用户明确说不不同步时才跳过。封面必须就位(草稿接口必填封面),正文图未全部就位时同步前说明。
前提:已认证公众号 + 环境变量 `WECHAT_APP_ID`、`WECHAT_APP_SECRET`(后台「设置与开发 → 基本配置」获取,放 shell 环境变量,不进任何 git 文件)+ 调用方公网 IP 已加入后台 IP 白名单。
前提:已认证公众号 + 环境变量凭证(后台「设置与开发 → 基本配置」获取,放 shell 环境变量,不进任何 git 文件)+ 调用方公网 IP 已加入**该账号**后台的 IP 白名单。**多账号**:默认账号配 `WECHAT_APP_ID` / `WECHAT_APP_SECRET`;每个号另配 `WECHAT_<账号key>_APP_ID` / `WECHAT_<账号key>_APP_SECRET`(key 用大写字母数字,如 `WECHAT_TECH_APP_ID`),同步时 `--account <key>` 选择——各账号的凭证、认证状态与 IP 白名单相互独立。
```bash
# 首次使用或怀疑凭证/IP 问题时先验证(只调 token 接口,不写内容)
python3 scripts/publish_draft.py . --check
# 多账号:验证/同步指定账号(读 WECHAT_<KEY>_APP_ID / WECHAT_<KEY>_APP_SECRET)
python3 scripts/publish_draft.py . --check --account <key>
# 确认执行计划(不联网)
python3 scripts/publish_draft.py <文章目录> --title "标题" --dry-run
# 正式同步:上传封面与正文图 → 替换为微信域名地址 → 写入草稿箱
python3 scripts/publish_draft.py <文章目录> --title "标题" --digest "摘要"
python3 scripts/publish_draft.py <文章目录> --title "标题" --digest "摘要" --account <key>
```
同步成功即止:提示用户到「内容与互动 → 草稿」人工预览,**发表永远由用户手动完成**。脚本默认随草稿提交 2.35:1 与 1:1 两个封面裁剪框(居中最大区域,防标题被默认裁掉;封面设计满足中央安全区时效果最佳),`--no-crop` 可跳过。脚本已内置错误码翻译(48001 = 账号未认证无 API 权限;40164 = IP 不在白名单;40113 = 图片编码被素材接口拒,转 jpg 重试);失败时保留本地文件原状,把错误提示给用户,不盲目重试超过一次。封面图缺失时先按封面 brief 生成(交给 ckm-banner-design)再同步。
@@ -144,12 +154,14 @@ python3 scripts/publish_draft.py <文章目录> --title "标题" --digest "摘
- 不把技术术语当 AI 味删掉;技术解析保持应有正式度,不统一改成聊天语气。
- 不在没跑 check_article.py 的情况下宣称「自检通过」。
- 不把作者画像、素材中的私人内容复制进交付物或对外文件。
- 未获「一口气跑完」授权时,不把停点之间的多个步骤合并进同一回合执行。
- 不把「在回复中展示了产物」当作「已获得确认」——确认只能来自停点之后用户的下一条消息。
## Reference Map
- 五类型路由与各类型结构:[article-types.md](references/article-types.md)
- 公众号排版硬规则、标点规范、产出配额、标题规范:[style-rules.md](references/style-rules.md)
- 审读手册(去模板化 + AI 味指纹 + 平台合规 + 语义保真):[review-playbook.md](references/review-playbook.md)
- Leroy 作者画像(风格,渐进填充):[author-profile.md](references/author-profile.md)
- Leroy 常用事实卡(事实,渐进填充):[topic-facts.md](references/topic-facts.md)
- 作者画像(风格;个人层 + 分账号层,渐进填充):[author-profile.md](references/author-profile.md)
- 常用事实卡(作者本人事实,渐进填充):[topic-facts.md](references/topic-facts.md)
- 封面与插图生产方法(七步推导 + ckm-banner-design 联动):[visual-production.md](references/visual-production.md)