跳到主要内容

Agent 发布 / FIELD NOTES

md2wechat-skill v2.4.0 更新解读:Agent readiness 为什么重要

Agent 自动发布公众号文章时,最怕不知道现在能不能执行下一步。v2.4.0 的 readiness 合约,让 Agent 可以先判断目标状态,再决定发布、降级或追问。

md2wechat-skill v2.4.0 的关键词是:

Agent readiness。

这次更新让 Agent 在发布前能判断“现在是否可以继续执行下一步”。

更新说明:v2.4.0 仍然是 Agent readiness 的基础版本。2026 年 6 月后,v2.5.0 到 v2.9.0 已继续补上 48 个主题、当前版本 SOP、多公众号账号、微信固定出口、图片 plan 模式和标题建议。完整版本线可以看 md2wechat-skill 2026 年 6 月更新总览

官方 CHANGELOG 里,v2.4.0 提到 md2wechat inspect --json 会返回 readiness 相关结构,包括 schema_versiontargetsblockerswarningsrecommended_actionsmode

这对 Agent 发布公众号非常关键。

为什么 readiness 重要

传统工具的使用方式是:

  1. 人写文章
  2. 人检查配置
  3. 人发现错误
  4. 人决定下一步

Agent 工作流不一样。

Agent 必须自己判断:

  • 能不能预览?
  • 能不能转换?
  • 能不能上传图片?
  • 能不能生成草稿?
  • 缺什么配置?
  • 是应该继续执行,还是应该先问用户?

readiness 合约就是把这些判断结构化。

targets 是什么

可以把 targets 理解成 Agent 的下一步目标。

常见目标包括:

  • preview:预览是否可用
  • convert:转换是否可用
  • upload:素材上传是否可用
  • draft:草稿发布是否可用

如果目标是 draft,Agent 需要同时检查 Markdown 是否能转 HTML、微信配置、封面、图片、白名单等发布条件。

blockers 是什么

blockers 是阻止 Agent 继续执行的问题。

比如:

  • API Key 缺失
  • WeChat AppID 缺失
  • WeChat Secret 缺失
  • 图片不可访问
  • 封面图不符合要求
  • 当前模式不支持某个目标

没有 readiness 时,Agent 很容易直接失败。

有 readiness 后,Agent 可以先说:

当前不能发布草稿,因为缺少 WeChat AppID 和 Secret。可以先预览 HTML,或补齐配置后继续。

这就是发布引擎和普通排版工具的差异。

warnings 是什么

warnings 不一定阻止执行,但会影响发布质量。

比如:

  • 文章没有封面图
  • 图片链接不稳定
  • 内容里使用了不推荐语法
  • 模块太密集
  • 主题可能不适合当前内容

好的 Agent 需要同时看能不能执行、结果是否可发布。

recommended_actions 是什么

recommended_actions 是给 Agent 的下一步建议。

它让 Agent 可以在报错时给出路径:

  • 先运行 doctor
  • 先运行 layout validate
  • 先切换到 preview
  • 先补配置
  • 先降级为 convert

这会明显减少用户和 Agent 的来回沟通。

一条基础工作流

md2wechat inspect --json
md2wechat doctor --json
md2wechat layout validate article.md
md2wechat convert article.md

如果目标是草稿发布,再进入:

md2wechat draft article.md

如果使用 v2.9.0 之后的版本,可以在基础工作流前后补充:

md2wechat skills read md2wechat
md2wechat capabilities --json
md2wechat themes list --json
md2wechat title suggest article.md --json
md2wechat generate_cover article.md --plan --json

给 Agent 的提示词

在发布公众号草稿前,请先运行 md2wechat inspect --json。
根据 readiness.targets 判断 preview、convert、upload、draft 哪些目标可用。
如果存在 blockers,请先说明缺什么,并给出 recommended_actions。
如果只有 warnings,可以继续但需要提醒用户风险。

它对品牌定位的意义

v2.4.0 让 md2wechat 从排版工具走向 Agent 发布引擎。

Agent 发布引擎需要负责:

  • 发布前判断
  • 风险提示
  • 目标降级
  • 下一步建议
  • 自动化链路稳定性

这也是 md2wechat 值得持续做品牌内容的原因。

延伸阅读

继续阅读

Agent 写公众号前应该先检查什么?doctor、layout validate、inspect 的正确顺序

稳定的 Agent 工作流,不应该一上来就发草稿。更好的顺序是先 doctor 看环境,再 layout validate 看模块语法,再 inspect 判断发布就绪状态。

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

Agent 选主题要先看当前 CLI 能发现什么。themes list/show 的价值,是让主题选择从猜测变成可验证的发现动作。

md2wechat:面向 Agent 的公众号发布引擎

从草稿整理、字段校验、主题渲染到人工确认,逐步说明 md2wechat 在 Agent 发布流程中的职责。

YOUR NEXT ARTICLE

让下一篇文章,从清楚的排版开始。

先看效果,再把稳定的排版能力接入你的工作流。

md2wechat-skill v2.4.0 更新解读:Agent readiness 为什么重要