Agent 怎么选公众号主题？themes list/show、48 个专业主题和 API 兼容边界

主题选择看起来是审美问题。对 Agent 来说，第一步是可发现性。

Agent 不该凭记忆猜主题名。它需要先确认：

• 当前有哪些主题
• 每个主题适合什么内容
• 哪些主题支持 API 模式
• 哪些主题适合本地工作流
• 当前版本的主题列表是否已经更新

md2wechat-skill 从 v2.3.1 到 v2.5.0 持续补齐主题发现能力。现在 CLI 和 API 文档里的专业主题数已经对齐到 48 个。

为什么不能让 Agent 猜主题

主题名一旦猜错，结果通常有三种：

• 回退到默认主题
• 转换失败
• 用户以为系统能力不稳定

这类错误很影响交付体验。主题选择应该由命令返回的数据决定。

推荐先运行 themes list

md2wechat themes list --json

Agent 应优先读取结构化结果，拿到可用主题范围、主题名称和模式边界。

再运行 themes show

md2wechat themes show github-readme --json

主题详情应该帮助 Agent 判断：

• 主题气质
• 适合内容
• 是否适合长文
• 是否适合代码
• 是否适合商业稿
• 是否适合当前输出模式

48 个专业主题的价值

v2.5.0 把 API 主题文档和 CLI 发现能力补齐到 48 个专业主题。

这一版补入了 /theme-gallery 中常用的特色主题：

• nyt-classic
• github-readme
• mint-fresh
• sunset-amber
• ink-minimal
• lavender-dream
• coffee-house
• bauhaus-primary

主题数量增加后，更需要让 Agent 通过 discovery 选择，减少用户在几十个名字里反复试。

常见选择方向：

• 教程稿：优先清晰、代码块稳定的主题
• 品牌稿：优先有识别度且正文不被抢走的主题
• 企业服务稿：优先稳重、可信、CTA 清楚的主题
• 活动稿：优先节奏明确、有视觉记忆点的主题
• 技术文档：优先代码、引用、表格表现稳定的主题

先读当前版本 SOP

v2.5.0 之后，Agent 可以直接读取当前 CLI 内置的使用说明：

md2wechat skills list
md2wechat skills read md2wechat

这一步适合放在主题选择前。它能避免 Agent 继续沿用旧教程里的主题数量、旧命令或旧参数。

API 模式和本地模式要分清

有些主题适合 API 稳定转换。

有些主题适合本地预览或更复杂的人工校准流程。

Agent 需要通过 themes list --json 和 themes show --json 判断边界。

推荐提示词：

请先运行 md2wechat skills read md2wechat，读取当前版本说明。
再通过 md2wechat themes list --json 获取可用主题。
然后通过 md2wechat themes show <theme> --json 查看目标主题详情。
不要猜主题名。
如果当前模式不支持某个主题，请选择兼容主题，并说明原因。

主题和模块怎么配合

主题负责气质，模块负责说服力。

一篇稳定的公众号文章通常需要：

1. 主题确定整体气质
2. hero 决定第一屏
3. infographic 形成记忆点
4. metrics / compare / steps 支撑证据
5. summary / cta 推动收尾

主题是底色，结构要靠模块完成。

给 Agent 的主题选择规则

如果是教程文章，优先选择清晰、正文可读、代码块稳定的主题。
如果是观点文章，优先选择有编辑感且正文负担轻的主题。
如果是企业服务文章，优先选择稳重、可信、CTA 清楚的主题。
如果是技术文章，优先检查代码块、引用、表格和列表表现。
如果不确定，使用默认主题，并用高级模块增强结构。

常见错法

• 主题名靠猜
• 只按颜色选主题
• 把主题当成排版能力的全部
• 主题和模块风格冲突
• API 模式和本地模式边界不清
• 继续使用旧文档里的主题数量口径

延伸阅读

• md2wechat-skill CHANGELOG
• md2wechat-skill 2026 年 6 月更新总览
• 公众号主题怎么选？
• 公众号高级排版总览