公众号图文 → Word 文档生成器
概述
将「公众号图文主题」转化为可直接用于公众号后台或二次编辑的 Word (.docx) 文档。
每份文档都包含以下必备要素，且版式（配色、章节色条、卡片、分割线）已按公众号阅读习惯统一设计：
- 封面图（16:9 横幅）
- 标题 + 公众号/日期导语（标签 + 元信息）
- 正文（含 2–3 个章节，章节带左侧主色色条）
- 两张文中插图（16:9）
- 金句框（tip）
- 互动结语卡片（callout）
- 关注导语
- 原创免责声明框
支持批量：用户一次给出若干个主题（或若干个公众号链接），为每个主题各生成一份
独立的 docx，互不干扰。
前置条件
- ImageGen 能力（生成封面图与文中插图，16:9）。通过
DeferExecuteTool调用
工具名ImageGen实现。 - WebFetch 能力（用户给的是公众号链接时，用于解析原文主题/结构/语气作参考）。
- Python 依赖（python-docx / Pillow / lxml）由
scripts/html_to_docx.py与
scripts/build_html.py首次运行时自动安装；也可先执行
scripts/setup_env.sh（Linux/macOS/Git Bash）或scripts/setup_env.ps1（Windows
PowerShell）预建虚拟环境。无需手动联网配置。
单篇生成流程（每篇主题执行一次）
第 1 步：明确输入并（可选）解析参考链接
- 若用户给的是公众号链接：用 WebFetch 提取「标题、公众号名、主题、核心观点、
文章结构、写作风格、互动引导、免责声明」等，作为本次创作的参考（仅供借鉴主题与
结构，不照搬原文）。 - 若用户给的是主题/关键词：直接进入创作。
- 记录本篇的
slug（英文短标识，用于输出目录与文件名，如parenting-edu）。
第 2 步：撰写结构化内容 → 写 content.json
在输出目录 output/<slug>/ 下创建 content.json，字段见
references/batch_workflow.md 的 JSON Schema。务必覆盖全部必备要素：
封面图路径 cover、公众号名 account、标题 title、导语 lead、引言 intro、
章节 sections（其中第 1、第 3 章节各挂一张插图 image）、金句 closing_quote、
互动 interaction、关注 follow、声明 disclaimer。
写作规范参见 references/writing_guide.md（语气、篇幅、金句写法、互动话术）。
第 3 步：生成三张 16:9 插图
通过 DeferExecuteTool 调用 ImageGen，一次性（或分批）生成并保存到
output/<slug>/images/：
cover.png—— 主题相关的温馨/专业封面（无文字、16:9）illo1.png—— 与第 1 章节呼应的场景插画（无文字、16:9）illo2.png—— 与第 2/3 章节呼应的场景插画（无文字、16:9）
> 务必在 prompt 中明确 16:9 horizontal wide / no text，避免图上出现乱码文字。
> 三张图均须为 16:9。
第 4 步：构建 HTML 并转换为 DOCX
# 用本技能的脚本（首次运行会自动安装依赖）
PYTHON=<本环境 python 解释器>
$PYTHON <skill_dir>/scripts/build_html.py output/<slug>/content.json -o output/<slug>/article.html
$PYTHON <skill_dir>/scripts/html_to_docx.py output/<slug>/article.html -o output/<slug>/<标题>.docx
<skill_dir>为本技能目录（即含 SKILL.md 的目录）。- 图片路径按
article.html同级images/解析，已就绪。 - 生成的
.docx即最终交付物，含全部图片与版式。
第 5 步：交付与预览
调用 present_files 展示生成的 .docx，让用户直接在预览面板查看。
批量生成流程
当用户给出 N 个主题/链接 时：
- 为每个主题分配独立
slug，建立output/<slug>/与output/<slug>/images/。 - 对每个
slug依次执行「第 1–4 步」；各篇的content.json、图片、HTML、docx
互不共享，确保独立可分发。 - 全部完成后，用一次
present_files同时展示 N 个 docx。 - 若某篇生成失败，仅重试该
slug，不影响其余。
必备要素检查清单（每篇都要核对）
- [ ] 封面图 16:9（已嵌入 docx）
- [ ] 标题 + 公众号名/日期导语
- [ ] 正文 ≥ 2 个章节，含左侧主色色条
- [ ] 两张文中插图 16:9（已嵌入，位置呼应章节）
- [ ] 金句框 / 互动结语卡片
- [ ] 关注导语
- [ ] 原创免责声明框
- [ ] 独立 docx 文件可正常打开
资源索引
scripts/build_html.py—— JSON 内容 → 公众号风格 HTMLscripts/html_to_docx.py—— HTML → 带版式的 Word（自包含，零外部服务）scripts/setup_env.sh/setup_env.ps1—— 预建依赖环境（可选）scripts/requirements.txt—— Python 依赖清单references/article_template.html—— 目标 HTML 版式与配色参考references/writing_guide.md—— 各板块写作规范references/batch_workflow.md—— 批量模式与完整 JSON SchemaREADME.md—— 安装与分发说明（面向技能使用者）
