先发现、再执行：为什么 md2wechat 更适合 discovery-first 的 Agent 工作流

我现在越来越不建议 Agent 一上来就直接干活。

尤其是在 md2wechat 这类带模式、provider、theme、prompt、模块目录的工具里，一开始就靠猜，后面很容易整条链都偏掉。

为什么这件事对 md2wechat 特别重要

因为这套东西不是只有一个开关。

你至少会碰到这些选择：

• 当前默认模式是什么
• 当前有哪些 provider
• 当前有哪些 theme
• 当前有哪些 prompt
• 当前有哪些高级排版模块

如果这些都还没确认，就开始写规则、选参数、跑任务，错一次往往不是一步错，而是后面一路错。

discovery-first 的好处很实际

我更看重的是这几件事：

• 少一点无效报错
• 少一点错误假设
• Agent 更容易复用同一条规则
• 升级版本后也更容易继续跑

这不是流程洁癖，是很实际的省事。

更稳的顺序是什么

我现在更建议这样：

第一步，先看当前能力。

md2wechat capabilities --json

第二步，再看跟这次任务有关的资源。

md2wechat providers list --json
md2wechat themes list --json
md2wechat layout list --json

第三步，再去看你真要用的那个对象。

md2wechat providers show volcengine --json
md2wechat layout show hero --json

最后，才去执行 convert、preview、generate_image 或草稿创建。

这对 Agent 的意义，不只是更稳

还有一个很实际的好处：规则更容易写。

因为你不再需要写很多“如果它可能支持”“假设这里应该有”的模糊话。

你可以把规则写得更直接：

• 先列出当前能力
• 再从当前能力里选
• 最后再执行

这种规则更容易长期复用。

最后

我越来越觉得，md2wechat 这套东西最好的起手式，不是“上来就转”，而是“先看它现在能做什么”。

先发现，再执行。
这条路看起来多一步，实际往往会少很多返工。

如果你想继续看更具体的接法，可以接着看：

• Discovery-First Workflow
• 为什么 Agent 应该先看模块目录，再开始写文章：少猜一步，后面整条链都更稳
• md2wechat 该怎么选模式：API、AI、普通转换、高级排版，别一上来就混着用
• Setup and Troubleshooting