md2wechat稳定的 Agent 工作流，应该先确认环境、能力和目标，再生成预览或草稿。
2026 年 6 月之后，md2wechat-skill 的检查链路覆盖 doctor、layout validate、inspect、当前版本 SOP、48 个主题发现、多账号发布、固定出口代理、图片计划和标题建议。
推荐顺序是：
skills readcapabilitiesdoctorthemes list / themes showlayout validateinspecttitle suggestgenerate_cover --planpreview / convert / draft
这条链路能把很多失败提前拦住。
第一步：读取当前版本 SOP
md2wechat skills list
md2wechat skills read md2wechat
这一步让 Agent 读取当前 CLI 内置说明，避免继续使用旧教程里的主题数量、旧参数和旧流程。
第二步：读取能力清单
md2wechat capabilities --json
能力清单适合让 Agent 判断当前版本是否支持：
- 标题建议
- 图片 plan 模式
- 主题发现
- 微信草稿
- 多账号配置
- 固定出口代理
v2.9.0 已把 title_generation 写入能力清单。Agent 不需要猜标题建议是否可用。
第三步：doctor 检查环境
doctor 负责回答：
当前环境能不能正常工作？
它适合检查：
- 命令是否安装
- 配置是否存在
- API Key 是否可用
- 微信相关配置是否齐全
- 基础依赖是否满足
推荐：
md2wechat doctor --json
JSON 输出更适合 Agent 读取和决策。
第四步：发现主题
md2wechat themes list --json
md2wechat themes show github-readme --json
v2.5.0 后，主题发现口径已经补齐到 48 个专业主题。
Agent 应通过命令确认主题名和模式边界，再决定文章使用哪个主题。
第五步：layout validate 检查模块语法
高级排版模块越多，越需要语法检查。
尤其是这些结构化模块：
matrixdialogue-pairquestionresource-listcomparison-tablechangelog
推荐：
md2wechat layout validate article.md --json
它的价值是把“复制到公众号后才发现不对”提前到发布前。
第六步：inspect 判断是否就绪
inspect --json 更像发布前状态报告。
它关心：
- 当前目标是什么
- 哪些目标可用
- 哪些问题会阻止发布
- 哪些问题只是风险提醒
- 下一步建议做什么
推荐：
md2wechat inspect article.md --json
第七步：标题建议
v2.9.0 加入：
md2wechat title suggest article.md --json
这个命令输出标题建议请求，让宿主 Agent 调用自己的模型完成标题生成。
它不会写回文章，不会上传图片，不会创建草稿，也不需要公众号凭证。
第八步：图片计划
v2.8.0 给图片相关命令加入无副作用计划模式：
md2wechat generate_cover article.md --plan --json
md2wechat generate_image article.md --plan --json
md2wechat generate_infographic article.md --plan --json
Agent 可以先拿到图片需求，再用自己所在环境的图片生成工具执行。
第九步：根据目标选择动作
如果只是看效果：
md2wechat preview article.md
如果要转 HTML：
md2wechat convert article.md
如果要进公众号草稿：
md2wechat draft article.md --wechat-account brand-main
如果团队配置了固定出口代理，微信上传、草稿、图文发布等微信侧请求可以走 wechat.proxy_url 或 WECHAT_PROXY_URL。
一条完整的 Agent 提示词
你要把这篇 Markdown 变成可发布公众号稿。
请按顺序执行：
1. md2wechat skills read md2wechat
2. md2wechat capabilities --json
3. md2wechat doctor --json
4. md2wechat themes list --json
5. md2wechat layout validate article.md --json
6. md2wechat inspect article.md --json
7. md2wechat title suggest article.md --json
8. md2wechat generate_cover article.md --plan --json
如果存在 blockers，先说明问题和下一步建议。
如果只有 warnings，可以继续预览或转换，但要提醒风险。
只有 draft 目标就绪时，才执行草稿发布。
如果有多个公众号账号，请明确使用 --wechat-account。
为什么这对用户重要
对个人创作者来说，这意味着：
- 少调样式
- 少踩发布坑
- 更快拿到第一版高级稿
- 标题和配图有清晰方案
对企业来说，这意味着：
- 发布流程更可控
- 多账号协作更清楚
- 固定出口适配微信白名单
- Agent 接入更容易标准化
高级模块检查重点
最近新增或校准的语法里，尤其要注意：
:::flow[产品上线流程]
需求分析 → 设计评审 → 开发联调 → 测试验收 → 正式发布
:::
:::matrix headers=能力,基础版,专业版,企业版
高级模块|✓|✓|✓
API 调用|✗|✓|✓
:::
:::dialogue-pair left=读者 right=作者
U: 高级模块和普通 Markdown 有什么区别？
E: 高级模块把结构内联到样式里，微信公众号也能完整渲染。
:::
这些语法应该进入 Agent 的默认检查规则。