技能介绍

解决什么

把 Markdown 文章变成微信公众号可发布的 HTML，中间不靠手工复制粘贴或临时改样式。实际写作里常见三类问题：一是标题、摘要、封面、草稿等发布元数据与正文格式混在一起；二是不同主题和排版模块只在某些模式下有效，容易选错；三是 Markdown 图片上传、微信草稿创建、远程生成封面都属于副作用，稍不注意就会触发未预期的外部操作。该技能的目标是让代理先路由意图，再按可验证的流程执行。

技能如何工作

核心是通过 md2wechat CLI 工作。发布前先做意图路由：标准文章用 inspect、preview、convert；图片优先帖子用 create_image_post；封面或信息图用 generate_cover、generate_infographic；标题候选用 title suggest --json；改进建议用 md2wechat advise --json；写作或去 AI 痕迹用 write、humanize。对提供商、主题、提示词、排版不确定时，先运行发现命令，不凭记忆猜测。

文章工作流优先确认后执行：

md2wechat inspect --json 读取元数据和发布就绪状态，重点看 data.readiness.targets 与 data.readiness.blockers；被阻止时停止并报告，不继续猜测。
md2wechat preview 本地预览。
md2wechat convert ... 执行转换。
只有用户明确要求时，才追加 --upload、--draft、--cover。

格式化协议要求源 Markdown 保持只读，生成临时格式化 Markdown，只插入能诚实填充的排版模块，再用 layout validate --file ... --json 校验。主题从 themes list --json 的 type 和 selectable 选择：API 模式只用 type: api，AI 模式只用 type: ai。排版模块按 attention、readability、memorability、conversion 分类，默认不堆砌，最多 1 个 hero、1 个 verdict、1 个 cta，内容不足就跳过。品牌档案 ~/.config/md2wechat/brand.md 只作上下文，任何命名主题或模块仍需 CLI 发现验证。

适用边界

API 模式是默认，需要高级排版模块时必须使用；AI 模式是轻量路径，不渲染高级排版。API 转换需要 md2wechat API 凭证，微信草稿需要微信凭证，直接图片生成需要图片提供商凭证；doctor --json 只做本地检查，不执行线上认证、不上传图片、不创建草稿。API 失败后不要偷偷切换到 AI 模式，因为输出能力会变。默认不创建草稿、不上传图片、不发布、不调用远程图片生成；草稿前要检查 data.readiness.targets.draft，且必须通过 --cover 或 --cover-media-id 提供封面，不能假设微信 URL 可复用为 thumb_media_id。