Skills aws-wechat-article-formatting

Name: aws-wechat-article-formatting
Author: openclaw

给公众号文章排版，转换为可直接粘贴到微信后台的格式，支持多套主题。当用户提到「排版」「版式」「美化」「格式化」「字号」「段落样式」「换个主题」「转 HTML」「弄好看点」「调整格式」时使用。

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bbd145/aws-wechat-article-formatting" ~/.claude/skills/openclaw-skills-aws-wechat-article-formatting && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/bbd145/aws-wechat-article-formatting" ~/.openclaw/skills/openclaw-skills-aws-wechat-article-formatting && rm -rf "$T"

manifest: skills/bbd145/aws-wechat-article-formatting/SKILL.md

排版

路由

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

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

脚本目录

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

{baseDir}

。

脚本	用途
`scripts/format.py`	Markdown → 微信兼容 HTML

配置检查 ⛔

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

内置主题

主题	风格	适用场景
`default`	经典蓝 — 左边框小标题，底部分割线大标题	科技、干货、通用
`grace`	优雅紫 — 圆角色块小标题，文字阴影	文艺、生活方式
`modern`	暖橙 — 胶囊圆角小标题，宽松行高	现代感、品牌
`simple`	极简黑 — 底线小标题，最少装饰	极简主义、学术

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

工作流

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

第1步：确定主题

主题解析顺序（

format.py

行为与智能体择一）：

命令行
```
--theme <名称>
```
：显式指定时始终优先。
未传
--theme
：
```
format.py
```
读取 合并后的本篇配置：先 .aws-article/config.yaml
顶层（不含
```
writing_model
```
/
```
image_model
```
），再叠与
article.md
同目录的
article.yaml
，同键本篇优先（仅
```
embeds.related_articles
```
单独与全局合并，见下节）。从合并结果取 default_format_preset
（非空则作为主题名）；若仍为空，则用内置主题名 default
。
智能体在对话中帮用户选主题时，仍按：用户口述 → 上条合并配置中的预设 →
```
.aws-article/presets/formatting/
```
自定义 → 内置
```
default
```
。

主题名须对应 内置主题 或

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

。字段说明见 articlescreening-schema.md（与仓库

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 <名称>`	主题；省略则按合并配置 → default	见上文
`--color <hex>`	自定义主色	主题默认
`--font-size <px>`	字号	16px
`-o <路径>`	输出路径	同名 .html
`--list-themes`	列出可用主题

自定义主题

在

.aws-article/presets/formatting/

下新建主题文件即可。

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

过程文件

读取产出

article.md

、.aws-article/config.yaml
+ 同目录
article.yaml
（默认主题与

embeds

）、

closing.md

（可选）

article.html