技能介绍

问题在哪

微信公众号后台不直接吃标准 Markdown：标题元数据、封面、thumb_media_id、图片托管和排版模块（如 :::module）都有各自规则。手写 HTML 或凭记忆选主题，很容易在草稿阶段才发现缺封面、主题与 convert --mode 不匹配，或 AI 模式根本渲染不了 API 专用模块。

技能如何组织工作流

本技能把 md2wechat CLI 当作唯一事实来源，先按意图选命令族，再「先发现、再行动」：

标准长文：inspect --json → preview → convert；仅在用户明确要求时加 --upload、--draft、--cover
图文 / 图片笔记：走 create_image_post，不用 convert --draft
封面与信息图：generate_cover、generate_infographic
标题与润色建议：title suggest --json、advise --json（建议不自动执行）；风格写作用 write / humanize

inspect 输出里的 data.readiness.targets 与 data.readiness.blockers 是能否继续的判据；有 blocker 就停，不猜配置。默认 API 模式（需凭证与高级排版）；AI 模式 是轻量路径，不解析排版模块，且 API 失败不会偷偷切到 AI。

需要「只格式化、不动源稿」时：读原文与可选 ~/.config/md2wechat/brand.md，生成临时 Markdown，layout validate --json 通过后再 convert；主题从 themes list --json 按 type 与 selectable 选，模块遵守「少堆砌」纪律（如最多一个 hero / verdict / cta）。

边界与副作用

不会默认创建草稿、上传图片、发布或调远程生图；doctor --json 只做本地检查。草稿前须 inspect 里 draft 就绪，封面用 --cover 或 --cover-media-id，不假设外链 URL 可当 thumb_media_id。配置或排版失败时走 doctor、config show、layout validate / layout show 对症排查。

截图预览

使用场景

在本地写完公众号长文的 Markdown 后，先用 `inspect --json` 查 readiness 与 blockers，再 `preview` 与 `convert` 生成可粘贴或下发的 HTML。
运营要发以图片为主的图文笔记时，按技能要求走 `create_image_post`，避免误用 `convert --draft` 导致工作流不对。
标题与正文已定稿，需要微信标题候选或改写建议时，分别调用 `title suggest --json` 与 `advise --json`，由人决定是否采纳。
源稿 Markdown 需保持只读，但要套主题与 `:::module` 排版时，生成临时稿、`layout validate --json` 通过后再执行 `convert`（默认 API 模式）。