一句话生成公众号文章
一句话：主题 → 成稿 → 配图 → 门禁 → 草稿箱 → 归档，每一步都有脚本和门禁兜底。
8 句可直接复制的开场白
复制任意一句给 AI，就能开工：
- 「用一句话主题帮我写一篇公众号文章并存草稿箱：主题是____」
- 「我有一批截图在_目录，围绕主题_写篇文章，截图全部用上」
- 「今天这篇的主题是____，按系列第 N 篇写，结尾预告下一篇」
- 「帮我把____目录里的截图逐张核实，写成图文稿，图注以截图为准」
- 「给主题____写文章，标题按爆款钩子给 6 个候选让我选」
- 「只走预演不要发：主题____，产出预览 HTML 给我看」
- 「检查现有稿子的素材门禁，列出问题并修」
- 「给这段旅行/项目截图配一套封面加 5:4 分享图」
- 「用这张参考图给文章配封面和分享图：文章主题_，参考图_」（没有参考图就说“用技能内置的”）
什么时候用我 / 什么时候别用我
用我：公众号连载或单篇成稿；截图素材变图文；封面 900×383 与分享图 1200×960 两件套；有参考图时直接生成整套视觉；发布前逐图验收；只预演不发布。
别用我：多源深度调研、带引用的研究报告、平面海报设计、视频号内容。纯排版发布（已有排版 HTML）可以直接用依赖技能 wechat-ai-publisher。
依赖（先装好再开工）
- wechat-ai-publisher 技能：
skillhub install wechat-ai-publisher。负责 Markdown→微信 HTML、上传素材、建草稿。公众号凭证配在它的.env（本 skill 不读取、不输出任何密钥）。 - wechat-ref-visual 技能：
skillhub install wechat-ref-visual。参考图视觉模式用它生成封面/分享图；只在generate出图时需要本机 ComfyUI + Qwen-Image 2.1，compose只需要 Chrome/Edge。 - Chrome 或 Edge（无头截屏用），以及 Python 3.8+（
pip install pillow markdown requests）。 - 在项目根目录运行本 skill 的脚本（相对路径
pic/、articles/、.build/都解析到当前目录）。
流程（六步，每步有门禁）
① 开稿脚手架 → ② 按一句话写正文 → ③ 素材逐图核实+回填清单
→ ④ 封面/分享图 → ⑤ 离线门禁+预演 → ⑥ 建草稿+归档
① 开稿（搭目录、骨架、清单，一步到位）：
python <本skill>/scripts/new_article.py --topic "旅行 App 越做越复杂，你还是用回了备忘录" --slug 20261101 --images E:\path\截图目录
② 写正文：AI 按骨架注释和 references/style-rules.md（四条文风规则）成稿。图片用绝对正斜杠路径插进正文；图注写在 ![ ] 里，必须与截图画面一致。
③ 逐图核实：每张截图必须亲眼看过原图再写图注。数字、日期、页面身份写进图注前，先在原图上看到。素材清单 <文章名>.assets.json 逐图登记 sha256/尺寸/来源/图注——缺一张、未引用、hash 不符、图注与正文不一致都会阻断（scripts/check_assets.py，13 项离线回归测试兜底）。
④ 配图两件套（优先走参考图视觉模式；没有参考图也能用内置默认图）：
参考图规则：用户给了新参考图就传 --ref；没给就省略，wechat-ref-visual 自动用内置 assets/reference/sapphire-queen-ref.png。先用 generate 出 3 张备选，逐张看原图挑一张，再 compose 成封面和分享图。
# 封面备选（横版 1344×768）
python <wechat-ref-visual>/scripts/visual.py generate --kind cover --ref E:\path\新参考图.png --out pic\<slug>\art-cover
# 分享图备选（竖版 768×1344；没有新参考图就删掉 --ref）
python <wechat-ref-visual>/scripts/visual.py generate --kind share --out pic\<slug>\art-share
# 挑图后合成
python <wechat-ref-visual>/scripts/visual.py compose --kind cover --art pic\<slug>\art-cover\cover-a-s20261221.png --out pic\<slug>\封面-900x383.png --h1 "标题第一行\n标题第二行" --sub "一句话副标题" --pill "封面" --manifest pic\<slug>\封面.manifest.json
python <wechat-ref-visual>/scripts/visual.py compose --kind share --art1 <图A> --art2 <图B> --art3 <图C> --out pic\<slug>\分享图-1200x960.png --h1 "标题第一行\n标题第二行" --badge "公众号 · 视觉套图" --manifest pic\<slug>\分享图.manifest.json
# 验收
python <wechat-ref-visual>/scripts/visual.py verify --kind cover --file pic\<slug>\封面-900x383.png
python <wechat-ref-visual>/scripts/visual.py verify --kind share --file pic\<slug>\分享图-1200x960.jpg
compose 默认超过 1000KB 自动转 JPEG；封面通常是 PNG，分享图可能是 .jpg，以命令输出和 manifest 为准。正文需要贴图时，把 --kind 换成 inline（1080×720）或 inline-portrait（1080×1440）。
生成后把封面路径与 sha256（compose --manifest 已记录）回填进素材清单的 cover 字段。
没有参考图 / 不想跑 ComfyUI 时：继续用本 skill 自带的 HTML 模板合成：
python <本skill>/scripts/build.py cover-shot --art1 a.png --art2 b.png --out pic/<slug>/封面-900x383.png --h1 "大标题" --badge "连载 · 第 N 篇"
python <本skill>/scripts/build.py share-poster --art1 a.png --art2 b.png --art3 c.png --out pic/<slug>/分享图-5x4.png --h1 "大标题" --serial N
⑤ 门禁 + 预演（不联网、不写归档）：
python <本skill>/scripts/check_assets.py --article <md 路径>
python <本skill>/scripts/run.py --article <md 路径> --slug <slug> --theme cyan --dry-run
⑥ 建草稿 + 归档（去掉 --dry-run）：草稿进公众号草稿箱，HTML+meta 归档到 articles/published/。群发必须在公众号后台人工确认。
参考图视觉模式（v1.1）
用户说“用这张参考图给文章配封面和分享图”时，直接调用 wechat-ref-visual，不要把参考图当普通截图处理：
- 有新参考图：
generate --ref <新图>，后续compose可加--ref <新图>写入 manifest。 - 没有新参考图：省略
--ref，自动用该技能内置的assets/reference/sapphire-queen-ref.png。 - 封面与分享图各生成 3 张备选，逐张看原图后再挑；不要直接用第一张。
- 封面 900×383、分享图 1200×960；正文需要时再加
inline（1080×720）或inline-portrait（1080×1440）。 compose --manifest产出的sha256回填素材清单cover字段；发布前照常走 ⑤ 门禁。
详细命令、挑图标准和排障见 references/ref-visual.md。
截图换新了怎么办
源截图是唯一真相。截图目录一变，所有引用它的图注视为失效：重新复制、重算 hash、逐张重看、回填清单，再走 ⑤⑥。已发布的草稿用依赖技能的 update_draft.py（建新→删旧）更新。
本地自检
python -m unittest discover -s <本skill>/scripts/tests -v # 13 项离线回归
目录结构
scripts/
new_article.py ① 开稿脚手架（目录+骨架+清单）
check_assets.py ③ 逐图素材门禁（离线）
build.py ④ 封面/分享图/插图合成（HTML→精确像素 PNG）
run.py ⑤⑥ 一条龙：门禁→排版→建草稿→归档
tools/shot.py Chrome 无头精确截屏
templates/ 9 套封面/分享图/插图 HTML 模板
tests/ 13 项离线回归测试
config.json 相对路径 + 尺寸 + 品牌信息（在项目根目录解析）
references/
style-rules.md 文风四规则与改写示例
assets-schema.md 素材清单逐字段说明
ref-visual.md 参考图视觉模式：调用、挑图、manifest 回填
