| name | wechat-skill |
|---|---|
| description | 微信公众号文章排版、同主题原生信息模块与多账号发布工具，将已有 Markdown、DOCX、PDF 或纯文本转换为可直接粘贴或通过官方 API 写入草稿箱/提交发布的 HTML。用于用户明确要求“公众号排版”“微信排版”“转公众号 HTML”“自动排版”“一键排版”、生成公众号主题、上传草稿、发布已有文章或配置多账号发布时。单独要求撰写文章时使用 wechat-tech-insight-writer；要求从选题一路完成写作、排版和草稿发布时使用 wechat-content-pipeline。不用于普通网页、落地页或 PPT；发布能力不等同于向粉丝群发。 |
公众号文章排版 Skill
把一篇 Markdown 文章转换为可直接复制粘贴进微信公众号编辑器、且粘贴后样式不丢失的 HTML。
核心资产是 references/ 下的主题组件库（每套一个主题：设计变量 + 各组件完整 HTML + 模板骨架 + 映射规则）外加 1 套通用增量库（代码块 / 图片·GIF / 小标签标题，所有主题共用）。主题清单以 references/theme-index.md 为单一来源。本 SKILL.md 只负责流程与决策，具体 HTML 代码一律从组件库取，不要凭记忆手写。
能力边界与协作
- 只需要写作时转交
wechat-tech-insight-writer，不要在本 Skill 中代写正文。 - 需要从选题到草稿箱的一条龙任务时转交
wechat-content-pipeline，并严格使用其pipeline_runtime.py begin/prepare/finish；固定运行器必须使用注册主题的完整骨架和组件，不得把主题降级为通用模板换色，也不得在根 Skill 中另写排版或封面实现。 - 流水线排障：先读
work/<account>/current/job.json与pipeline-failure-triage.md。字数 1500—4000；写前 rotation+shape；写后 humanize。正文图：baoyu 分析 + 自有后端出图；封面：品牌名+品牌色+场景（不默认画完整 Logo，不做视觉审图）。写作须有读者带走物（反白看一场），见wechat-tech-insight-writer。 - 审计流水线草稿恢复时，以
run_id为幂等边界：同时核对 job 阶段、draft-result.json的账号、动作、run_id和draft_media_id；running/uncertain禁止自动重发。当前流水线不使用来源文件、预览、leaf count 或文件哈希 checkpoint。 - 被流水线调用时使用其账号临时工作区和账号档案，全自动执行；主题由编排器随机选定后直接使用，不再按题材推荐或询问。没有真实作者信息时省略署名组件，不保留作者占位符。
工作流
0. 输入与格式归一化
用户可能给：Markdown 文本或 .md 路径（直接进第 1 步）、.docx、.pdf、.txt/无标记纯文本、网页富文本。非 Markdown 输入必须先读 references/format-normalize.md 按其规则转成 Markdown 草稿并做结构确认（docx 用 scripts/extract_docx.py，PDF 用 Read 分页读取+清噪，纯文本按标题启发式推断结构）。什么都没给时，向用户索要。
用户说「直接排 / 自动排 / 一键 / 不用问」时进全自动模式：跳过结构确认与选主题提问，自动推断结构、按题材自选主题、排版校验，交付时附决策说明（章节结构、自拟标题、选题理由）。
1. 选主题（自动推荐制）
读 references/theme-index.md（主题信息的单一来源）。据文章题材主动推荐最契合的主题，再让用户一步确认——推荐但不擅自定死：
- 用户已在请求里指定主题 → 直接用，不问。
- 由
wechat-content-pipeline调用 → 使用编排器已随机选定的注册主题，不重新推荐、不再随机、不询问。 - 题材有明确契合 → 单问确认：「建议用 XX（理由），确认还是换一套？」选项给推荐项 + 1~2 个备选 + "看全部"。题材→主题契合参考 theme-index"适用场景"列：
- 教程 / 测评 / 清单 / 工具盘点 / 知识整理 / 方法论拆解（信息密度高）→ 摸鱼绿
- 深度分析 / 观点 / 力量感话题 → 红白色系
- 工具对比 / 创意评测（票据视觉隐喻）→ 摸鱼票据风
- 内刊手记 / 深度评测 / 案例复盘 → 橄榄手记
- 无明显倾向 → 默认首选 theme-index 第一行（摸鱼绿）作为推荐项放第一位，用 AskUserQuestion 让用户在几套里选（主题多于 4 套时先按气质分组问，再问该组下主题）。
- 全自动模式（用户明说「直接排 / 一键 / 不用问」）→ 不提问，自动选题材最契合主题或默认第一行，交付时说明选择理由。
- 用户对现有主题都不满意 / 想要新风格 → 走「自定义主题生成」流程（见下节），生成并登记后再回到本步选用。
- theme-index 为空 → 停止排版，告知用户需要先添加主题风格（可走「自定义主题生成」）。
用户定下主题后，才进入该主题内部的组件匹配（第 3、4 步：判定文章类型 → 按该主题的配方表选组件组合）。
2. 读组件库（两份）
(1) 据 theme-index 中该主题的"组件库文件"列，Read 该主题专属组件库 references/theme-{标识}.md（含引言卡、章节标题、正文标记、签名等主题专属组件）。
(2) 同时 Read 通用增量库 references/common-components.md——代码块、图片/GIF、小标签标题这三类所有主题共用，套用当前主题主色即可。
后续生成完全依据这两份组件库，HTML 一律从中取、不要手写。
3. 解析 Markdown 结构
| 元素 | 识别规则 |
|---|---|
| 文章标题 | # 标题 或 frontmatter title |
| 开头引言 | 文章最开头的 > 引用 块 |
| 章节标题 | ## 标题 |
| 子章节 | ### 标题 |
| 加粗 / 高亮 / 下划线 | **文字** / ==文字== / <u>文字</u> 或 ++文字++ |
| 引用段落 | 非开头的 > 文字 |
| 图片 / GIF | 、（GIF 与图片同样处理） |
| 代码 / 命令 / Prompt | ``` 围栏代码块 ```、行内 `code` |
| 分割线 / 列表 | ---、*** / - 项 或 1. 项 |
| 表格 | \| 分隔的 Markdown 表格（常来自 docx 转换）→ 优先用主题库的表格/卡片组件（主题库映射规则为准） |
解析完结构后，判定文章类型（取主导类型，可复合）：教程/操作指南、盘点/工具清单、观点/深度分析、访谈/人物特稿、数据复盘/报告、生活/情感随笔、案例实战。判定依据：步骤和命令多→教程；并列条目多→盘点；引语和人物叙事多→访谈；数字和对比多→数据；论证推演多→观点。
4. 按配方选组件组合 → 装配 HTML
先查所选主题库的「文章类型 → 组件组合配方」表，按文章类型确定本篇的核心组件组合与点缀组件——不要拿到组件库就逐段随机选组件，配方保证同类文章的排版气质稳定。配方之外的元素再按主题库映射规则表补充。
然后依主题库的**"完整文章模板骨架"章节**装配，把每个 Markdown 元素替换为对应组件：
- 骨架顺序以主题库为准，不同主题骨架可能不同，不要套用其它主题的骨架。
- 行内标记按语义到所选组件库里找对应组件（组件编号各库不统一，一律以语义为准、不要套固定编号）：
**加粗**→主色加粗；==高亮==→渐变背景高亮；<u>文字</u>或++文字++→下划线；~~文字~~→荧光笔（底部半高亮）；>引用→引用高亮块。 - 来自通用增量库的组件：
``` 代码块 ```→ 1a 深色 / 1b 浅色代码块，行内`code`→ 1c；→ 2a 图片（有说明才加说明组件）、.gif→ 2b GIF；需要突出的小标题/强调→ 3a 左竖条小标题或 3b 药丸标签，金句→ 3d、提示旁注→ 3e。优先级：先查主题库映射规则表——该主题有等价语义组件（如自己的金句/提示块）就用主题库版本保持气质一致；主题库没有对应组件时才用通用库 3x 并按其换色规则换成主题色。 - 一篇文章只用所选主题的那一套组件，不跨主题混用。
- 强调与小标题用"小标签/左竖条"，不要用虚线框：要突出一个小标题或一段内容时，用左竖条小标题（3a）、药丸标签（3b）、左竖条金句/提示块（3d/3e）；不要用四周虚线框（
dashedborder）套一个标题，那样笨重抢戏。
5. 提取并插入同主题原生信息模块
基础排版完成后读取 .agents/skills/wechat-inline-visuals/SKILL.md。只从最终正文和已核验来源中提取适合结构化表达的观点、比较、流程或数据，并复用当前主题组件库插入 article.html：
- 每篇插入 0—3 个模块；内容不适合时不强行添加。
- 模块只能强化原文信息层级，不能替代、删除或改写正文段落。
- 使用
references/theme-component-map.md指定的当前主题组件，不跨主题混用，不手写新的风格。 - 不生成正文 PNG、SVG 或截图，不调用浏览器、生图模型、图片上传或 AI 视觉检测。
- 插入前必须生成并校验
inline-visuals.json；锚点、证据和数据必须能在正文中精确定位。
单独排版任务也执行此步；用户明确要求“只转换原文、不增加信息模块”时才跳过。流水线模式由编排 Skill 负责保存计划和阶段状态。
6. 校验合规（强制）
把生成的 HTML 写入目标文件后，必须运行校验脚本，ERROR 清零才算完成：
# 用脚本所在 skill 的绝对路径调用，HTML 参数也用其实际路径（两者目录通常不同）
<SKILL_ROOT>/scripts/validate_gzh_html.py <生成的.html 的实际路径>
它确定性地检查平台禁用项和 <span leaf> 包裹。报 ERROR 就回到第 4 步修；半角标点 WARNING 同样要修复到 0 再交付（这是实际使用中最高频的返工点）。
7. 输出
产物格式：纯 <section>…</section> 正文片段，从全局容器开始，不要包 <!DOCTYPE>/<html>/<head>/<body>——公众号编辑器只接受正文片段，多余的文档外壳会被丢弃或干扰粘贴。
干净正文文件：HTML 保存到当前工作目录，文件名
{原文件名}_排版_{主题中文名}({英文标识}).html（英文标识 = theme-index 组件库文件名去掉theme-前缀与.md后缀）。这份用于校验和手动粘贴兜底。带「复制」按钮的预览页（让用户一键复制，免去手动全选）：
<SKILL_ROOT>/scripts/wrap_preview.py <上面的干净正文.html>产出
{...}_预览.html——浏览器打开后右上角有「复制到公众号」按钮，点一下即把渲染后的富文本复制到剪贴板（等价 Ctrl+A/Ctrl+C），再到公众号编辑器 Ctrl/⌘+V 粘贴。按钮和脚本只在预览外壳里、不在被复制的 section 内，所以粘到公众号的仍是干净合规正文。告知用户：打开
{...}_预览.html→ 点右上角「复制」→ 公众号编辑器粘贴；并给出干净正文文件路径作为兜底。附校验脚本结论（已通过 / 剩余 warning）。
8. 可选：多账号草稿与发布
用户要求上传草稿、提交发布或配置多公众号时，先读 references/multi-account-publishing.md。用 scripts/wechat_publish.py 执行确定性 API 流程，不手写临时请求：
- 让用户复制
assets/wechat-accounts.example.json，每个账号用别名注册；AppID/AppSecret 只从各自环境变量读取。 - 首次先用
--dry-run，再分别对每个账号执行--action draft并人工验收。 - 只有用户明确要求公开发布时，才用
publish --media-id <已审核草稿ID>发布现有草稿。不要在审核后再次用send --action publish创建第二份草稿。说明它是“发布”而非“群发给粉丝”。 - 外部 Agent 的定时任务仅负责触发并传入
--account和可选主题；本 Skill 不创建定时器。原文图片按账号分别上传；wechat-content-pipeline可生成 0—3 张正文图并在失败时无图继续。封面素材仍必须属于目标账号。
生成时的智能处理（这些是本 skill 的特色，必须做）
- 章节自动编号：按
##出现顺序分配01/02/03…；末章若为结语/总结类，用主题库指定的结语编号变体（如∞），主题库未指定时沿用数字编号。 - 英文标签：据中文章节标题生成英文标签（实测→TEST、教程→TUTORIAL、总结→SUMMARY、思考→THOUGHTS…），主题库有对应槽位时使用。
- 正文关键词下划线（核心特色）：对每个正文段落主动找出 1–3 个最重要的短语，用该主题的下划线 CSS（见 theme-index）标记。优先标核心观点、结论、关键数据、专有名词；短语 4–15 字；整段无要点可不标。即使原文没有任何加粗也要主动加下划线——它是出现频率最高的基础标记。
- 引言关键词高亮：识别开头金句里的核心词，用高亮组件标记。
- 目录提取：从所有
##取前 3 个作为导读/目录要点（主题库有目录组件时）。 - 信息模块提取：基础排版后只提取能被原文直接支持的观点、比较、流程或已核验数据，并按当前主题组件呈现。模块不重复整段正文，同类模块不重复，多个模块不相邻。
- 开头引言卡署名：按文章的作者或主题而定——文章有署名就写"—— 作者名"，没有明确作者就用与主题相关的简短落款或直接省略。不要固定写"甲木"（尾部签名区同样用
{{作者名}}占位，见第 8 条）。 - 尾部作者签名区（作者自填，仅末尾一处）：默认不写死任何人名，用占位署名让用户替换成自己的。
- 第一句（作者介绍）：
我是 {{作者名}}，{{一句话简介，如：热衷于分享 AI 观察与干货}}——用户在请求/偏好里给了署名或简介就直接填入；没给就保留{{作者名}}/{{简介}}占位，并在交付时提示用户替换成自己的署名。 - 第二句（互动引导，通用可保留原样）：
如果你觉得今天这篇有收获，欢迎**点赞、在看、转发**三连，我们下篇见 - 原文末尾已有作者签名段（如"我是 XXX…"）→ 直接沿用原文的署名，不替换成占位。
- 流水线模式例外：优先使用账号档案或发布配置中的真实作者；仍无作者时删除整个署名组件，不得把
{{作者名}}、{{简介}}带入草稿箱。
- 第一句（作者介绍）：
- 列表转换：按主题库映射规则处理；无专属列表组件时转为带缩进的正文段落。
- 中文全角标点：正文标点一律用全角（，。！？：；""''（）—— …），不要用半角
, . ! ? :和英文直引号" '。生成 HTML 时就直接写弯引号""''，不要先写直引号再事后替换——原文里的直引号在转写时当场转换。例外：代码块、行内代码、英文专名/URL/代码标识符内部保持原样。
视觉层级（3 层递进，所有主题通用）
| 层级 | 作用 | 频率 | 手段 |
|---|---|---|---|
| 锚点层 | 最强锚点：产品名/步骤/CTA/核心金句 | 全文 ≤ 5 处 | 主色加粗、深色底白字引用 |
| 标记层 | 正文关键词，每段 1–3 处 | 高频 | 下划线标记 |
| 容器层 | 引用块、概念标签、长句强调 | 按需 | 浅底引用、荧光笔、徽章 |
平台红线（核心，完整检查交给校验脚本）
- 禁止：
<style>/<script>/<div>、class/id属性、position:fixed/absolute/sticky、float、@media/@keyframes、display:grid、CSS 变量、外部字体/CSS。 - 必须：样式全部内联
style；所有文字节点用<span leaf="">文字</span>包裹（否则粘贴后样式丢失）。 - 可用：
display:flex（有限）、linear-gradient、border-radius、box-shadow、<section>/<p>/<span>/<strong>/<img>/<h3>。
Gotchas（真实排版踩过的坑）
- 漏
<span leaf>包裹是最常见致命错——粘贴到公众号后样式整片丢失。靠第 5 步校验脚本兜底，别跳过。 - 下划线：逐段落实、每段 1–3 个短语。不要整段划线（失去焦点），也不要有的段标有的段漏；列表项里的关键描述同样要标。
- 章节编号错乱：严格按
##顺序，不要跳号；结语编号变体只用于末章，中间章节不能用。 - 签名区有且仅有末尾一个：用固定文案，不在中间或多处出现；原文末尾若已有作者签名/"点赞在看转发三连"类段落，识别并并入这唯一的签名区/CTA 卡片，不要保留原文段又再生成一个。
- 图片说明硬造：只有
里真有说明文字才生成说明组件；空 alt 不要编造说明。 - 图片自适应、不铺满：
<img>一律max-width:100%;height:auto;display:block;margin:0 auto——按图片自身尺寸显示、居中，大图缩到容器宽、小图保持原尺寸。不用width:100%（会把小图也拉伸变糊）；只有表格 / 封面卡 / 流程图这类布局元素才用width:100%。 - 跨主题混用组件：一篇文章只用所选主题 + 通用库的组件，不从其它主题借组件。
- 锚点层滥用：最强强调全文 ≤ 5 处，到处加粗等于没有重点。
- 原文内容遗漏：每个段落和原文已有图片都要转换，不得漏；信息模块只是新增视觉层级，不能取代原文内容。
- 占位图残留：签名区/CTA 组件里若带名片图占位（如
<img src="...名片或引导图URL">），没有真实图片 URL 时整行删掉，不要把占位符留在产物里。 - 目录是精选不是全量：前言导读/目录组件展示精选的 3 个核心看点，不是完整章节列表；章节多于 3 个时挑最重要的 3 个，不要硬塞或误导读者以为只有 3 章。
- 不用虚线框：突出标题/强调用小标签或左竖条（通用库 3a–3e），不要用
border:…dashed四周虚线框包标题。例外：主题库明确定义的虚线组件（如摸鱼绿的 quote-box 引用框、oneliner-card 亮点卡）是该主题的风格特征，按主题库用法正常使用。 - 标点别混半角：正文出现半角逗号句号、英文直引号
"'都要改成全角；但代码块/行内代码内的半角符号保持原样，不要"全角化"代码。 - 代码/Prompt 必须用代码块：文章里的代码、命令、提示词用通用库代码块组件（1a/1b），不要塞进普通段落或引用块，否则缩进和等宽会丢失。
- 代码块要紧凑、忌大空白：用通用库 1a/1b 的"每行一个
<p style=\"margin:0\">"写法，绝不用white-space:pre——它会把 HTML 源码里 span 前的缩进和行间换行原样渲染成大左缩进 + 空行；缩进只用全角空格line-height:1.6。 - 待补素材居中：
【插入…】、待录屏 / GIF / 视频 / 成果图等占位，用通用库 2c 居中素材占位板块（浅底柔虚线框 + 居中图标与说明），不要用左对齐的提示块。
自定义主题生成（第二条工作流）
用户想要内置主题之外的新风格（说「生成一套新主题 / 自定义风格 / 按这张参考图做一套组件库」，或对现有主题都不满意）时，读 references/theme-generator.md 并严格按其流程执行：
- 收集偏好：主题描述必填（或参考图），名称/ID/五色/字体/三类 TAG/圆角/阴影可空则自动补全；一次问全，不逐字段追问。
- 生成区块库 HTML：用 theme-generator.md 末尾的【生成提示词】原样执行，产出 45~75 个 Block 的完整区块库，保存到
assets/theme-previews/{theme-id}.html——全部区块在同一页面连续排布，用户浏览器打开整页一次浏览确认风格，不逐块展示确认。 - 转换 + 登记：用户确认风格后，转换为标准
references/theme-{标识}.md（必须补<span leaf="">包裹、去掉预览用 id、补齐五章节，规则详见 theme-generator.md 第三步），登记 theme-index.md，跑component_lint.py到 0 ERROR。 - 交付后该主题即成为常驻可选主题，后续排版与内置主题完全同权。
生成阶段以提示词规则为准；转换进主题库阶段以本文件「平台红线」和「添加新主题的规范」为准（两者冲突时后者优先，因为主题库直接决定排版产物）。
添加新主题的规范
新主题以 references/theme-{英文标识}.md 命名，内容必须包含：
- 设计变量速查表（主色/浅底/深字/标题色/正文色/分割线色等）
- 各组件完整 HTML（内联样式 +
<span leaf="">包裹，遵守上面"平台红线"） - 完整文章模板骨架（组件装配顺序；若有目录/导航组件，明确其相对封面/引言的位置）
- 文章类型 → 组件组合配方表（每种文章类型的核心组件组合 + 点缀组件，配方是排版气质稳定的关键）
- Markdown → 组件映射规则表
- 原生信息模块映射：同步更新
.agents/skills/wechat-inline-visuals/references/theme-component-map.md，为观点、比较、流程和数据类型登记可复用组件。
添加后在 references/theme-index.md 登记一行（主题名 / 主色 / 适用场景 / 组件库文件 / 正文下划线 CSS），并跑 python3 scripts/component_lint.py . 确认组件库无反模式（0 ERROR）。
触发与主题选择的回归用例见
references/eval-cases.md（维护时用于回归核对，不影响单次生成）。