排版

路由

一键发文且未明确只要排版 → aws-wechat-article-main。

将 Markdown 文章转换为微信公众号兼容的 HTML，所有样式 inline。

脚本目录

Agent 执行：确定本 SKILL.md 所在目录为

{baseDir}

scripts/format.py

配置检查 ⛔

任何操作执行前，必须按 首次引导 执行其中的 「检测顺序」。单独启用本 skill 时同上。检测通过后才能进行以下操作（或用户明确书面确认「本次不检查」）：

内置主题

default

grace

modern

simple

每个主题包含：标题样式、引用块样式、分割线、强调色、段落间距等完整规则。

工作流

排版进度：
- [ ] 第0步：配置检查（见本节「配置检查」）⛔
- [ ] 第1步：确定主题（与合并配置 / 用户指定）
- [ ] 第2步：转换
- [ ] 第3步：输出 HTML

第1步：确定主题

主题解析顺序（

format.py

1. 命令行

   --theme <名称>

   ：显式指定时始终优先。
2. 未传

   --theme

   ：

   format.py

   读取 合并后的本篇配置：先

   .aws-article/config.yaml

   顶层（不含

   writing_model

   /

   image_model

   ），再叠 与

   article.md

   同目录的

   article.yaml

   ，同键本篇优先（仅

   embeds.related_articles

   单独与全局合并，见下节）。从合并结果取

   default_format_preset

   （非空则作为主题名）；若仍为空，则用内置主题名

   default

   。
3. 智能体在对话中帮用户选主题时，仍按：用户口述 → 上条合并配置中的预设 →

   .aws-article/presets/formatting/

   自定义 → 内置

   default

   。

主题名须对应 内置主题 或

.aws-article/presets/formatting/<名>.yaml

config.yaml

第2步：转换

在仓库根执行（路径按实际本篇目录调整）：

# 不传 --theme：使用合并配置中的 default_format_preset，否则 default
python {baseDir}/scripts/format.py drafts/YYYYMMDD-slug/article.md -o drafts/YYYYMMDD-slug/article.html

# 显式指定主题（覆盖配置）
python {baseDir}/scripts/format.py drafts/YYYYMMDD-slug/article.md --theme grace -o drafts/YYYYMMDD-slug/article.html

# 自定义主色 / 字号
python {baseDir}/scripts/format.py article.md --theme modern --color "#A93226"
python {baseDir}/scripts/format.py article.md --font-size 15px

# 列出可用主题
python {baseDir}/scripts/format.py --list-themes

嵌入元素

{embed:...}

• format.py

  ：名片 / 小程序 的

  embeds

  以

  .aws-article/config.yaml

  为准；仅「往期链接」：本篇

  article.yaml

  可写

  embeds.related_articles

  ，与全局

  related_articles

  深度合并（用于每篇不同推荐）。合并结果中非空

  embeds

  时解析

  {embed:profile|miniprogram|miniprogram_card|link:名称}

  ；否则不对嵌入占位符做替换（视为无配置）。
• 与 writing 结构模板 中的占位说明一致。

第3步：输出 HTML

输出的 HTML 特性：

• 所有样式 inline（微信编辑器兼容）
• 正文不含文章标题：Markdown 中第一个

  #

  （h1）在转换时被跳过，标题在公众号后台单独填写，正文不重复
• 配图标记

  ![类型：描述](placeholder)

  保留为

  <img>

  标签，待 images skill 替换
• 图注自动从标记描述中提取
• 同目录存在

  closing.md

  时，

  format.py

  会追加到文末（脚本既有行为）

选项

--theme <名称>

--color <hex>

--font-size <px>

-o <路径>

--list-themes

自定义主题

在

.aws-article/presets/formatting/

主题文件格式和扩展方式详见：references/presets/README.md

过程文件

article.md

.aws-article/config.yaml

article.yaml

embeds

closing.md

article.html