wechat-feige-formatter

SKILL.md

---
name: wechat-feige-formatter
description: >
  公众号排版工具。用户提供任意格式的文章内容（草稿、纯文字、已有 Markdown 均可），
  AI 自动识别结构、添加排版标记，生成专业公众号 HTML。
  Use when: 用户说"帮我排版"、"转成公众号格式"、"生成 HTML"；用户上传文章内容或文件
  NOT for: 纯文本渲染；用户只想预览已有 HTML
---

## 核心原则

**用户不需要懂任何排版语法。** 用户给什么内容都接受，AI 负责理解内容并生成标准格式，再调用工具转换。

---

## Workflow

### 第一步：接收用户内容

接受以下任意形式的输入：
- 上传的 `.md` 文件（带或不带排版标记）
- 上传的 `.txt` 文件
- 直接粘贴的文字内容（草稿、大纲、聊天记录水平都可以）
- 提供的本地文件路径

**不要要求用户手动添加排版标记。** 内容理解和格式转换是 AI 的工作。

---

### 第二步：AI 智能排版（核心步骤）

**必须先读取 `references/排版优化规则.md`**，按规则对内容进行分析和重组，生成符合 formatter 语法要求的标准 Markdown。

**7 项识别任务（全部执行）：**

1. **识别流程/步骤** → `> STEP XX` 卡片
2. **识别核心观点/结论** → `> ✨` 要点框
3. **识别小贴士/注意事项** → `> 💡` 提示框
4. **标记关键词** → `==词==` 高亮
5. **识别代码/指令/Prompt** → `` > 🤖 PROMPT: `` 框
6. **识别子话题** → `### 小标题`
7. **修正格式错误** → 特殊框内部无空行，每行以 `> ` 开头
8. **不新增原文没有的内容** → 不在章节标题下方插入"本节xxx"、"本节介绍xxx"等概述句，只对原文做格式标记

**最重要的格式规范：**

```markdown
# ✅ 正确：框内无空行，每行有 > 前缀
> ✨ 标题
> 第一行内容
> 第二行内容

# ❌ 错误：中间有空行（会导致格式崩坏）
> ✨ 标题

> 内容行
```

**章节标题语法（普通 ## 即可，formatter 自动生成 PART 卡片）：**
```markdown
## 章节标题                  # formatter 自动编号为 PART 01/02/03...
## 主标题 | 副标题           # 支持副标题
```

**BREAKING 开篇**：formatter 自动从 `#` 标题生成（不填副标题，避免与正文重复）。如需定制副标题或特殊样式，使用手动写法：
```markdown
## BREAKING
- bold: 新方式的标题（大号黑字）
- subtitle: 一句概括全文的说明（与正文不重复）
- strikethrough: 旧方式（删除线，可选）
- highlight: 核心亮点句（主色字体，可选）
- date: 2026.03

⚠️ 重要：每个字段必须以 `- ` 开头（列表格式），直接写 `key: value` 会当成正文输出！
```

生成优化后的标准 Markdown，保存为临时文件，供下一步使用。

---

### 第三步：调用转换脚本

使用 `scripts/formatter.py` 将优化后的 Markdown 转换为 HTML：

```bash
python3 {skill_dir}/scripts/formatter.py {input_md} --output {output_html}
```

可选参数：
```bash
# 自定义品牌色（默认桃色 #DE7356）
python3 {skill_dir}/scripts/formatter.py {input_md} --output {output_html} --brand-color "#660874"

# 关闭图片内嵌（默认开启，本地图片自动转 base64，方便复制到公众号）
python3 {skill_dir}/scripts/formatter.py {input_md} --output {output_html} --no-embed-images
```

**默认行为**：
- 本地图片自动转 base64 内嵌（无需额外参数，直接复制粘贴即可带图）
- HTML 页面内置「主题色」切换器，可在预览时实时切换 6 套配色，再点「一键复制」

**Python 版本要求**：Python 3.6+，仅用标准库，无第三方依赖。

---

### 第四步：返回结果

1. 生成最终 HTML 文件
2. 启动本地服务预览（如果环境支持）
3. 告知用户：HTML 文件路径在哪、如何复制到公众号编辑器使用

---

## 排版元素速查

| 元素 | formatter 语法 | 触发场景 |
|------|---------------|---------|
| PART 章节卡片（渐变橙色） | `## 标题` | 文章大章节 |
| BREAKING 开篇框 | 自动生成（或手动 `## BREAKING`） | 每篇文章开头 |
| STEP 步骤卡片 | `> STEP 01 标题` + `> 说明` | 有顺序的步骤/流程 |
| ✨ 要点框 | `> ✨ 标题` + `> 内容` | 核心结论、重要观点 |
| 💡 提示框 | `> 💡 标题` + `> 内容` | 小贴士、注意事项、建议 |
| 关键词高亮 | `==词==` | 专业术语、核心概念、产品名 |
| 🤖 指令框 | `> 🤖 PROMPT:` + `> 内容` | 代码、命令、AI Prompt |
| 代码块 | ` ```lang ``` ` | 较长代码片段 |
| ### 小标题 | `### 标题` | 章节内子话题 |
| **加粗** | `**词**` | 句子内强调词 |

---

## 常见场景

| 场景 | 操作 |
|------|------|
| 给草稿排版 | 直接粘贴草稿内容，说"帮我排版" |
| 给已有 Markdown 排版 | 上传 .md 文件，AI 自动检查并补全排版标记 |
| 调整品牌色 | 说"用蓝色排版"，AI 会在调用时加 --brand-color 参数 |
| 修改某个元素 | 说"把第二章改成步骤格式"，AI 重新生成并预览 |
</content>
</invoke>