为什么 Agent 应该先看模块目录，再开始写文章：少猜一步，后面整条链都更稳

如果 Agent 已经要用高级排版了，我现在几乎都会建议它先做一件事：

先看当前模块目录。

很多后面的错误，其实都能在这一步前置掉。

为什么这一步这么值

因为高级排版不是自由发挥。

它有明确的模块名、字段和适用边界。

如果这些都还没确认，Agent 就开始凭记忆写，很容易出几种问题：

• 模块名写错
• 选了不适合当前任务的模块
• 字段乱填
• 一篇里堆太多重模块

这些问题不是执行阶段才出现的，它们在写的时候就已经埋下了。

先看模块目录，本质上是在先对齐边界

我更看重的是这个作用。

你先跑：

md2wechat layout list --json
md2wechat layout show hero --json

这时候你拿到的不是“灵感”，而是边界：

• 当前有哪些模块
• 模块主要服务什么
• 什么时候该用
• 什么时候不该用

这对 Agent 特别重要。

这比直接开写省事

很多人会觉得，多跑一步 discovery 好像更慢。

但真实情况常常相反。

如果 Agent 一开始就选错模块，后面你会在这些地方返工：

• 正文重写
• 结构重排
• 语法修补
• 渲染排错

前面多看一步，后面常常少返很多步。

尤其是第一次接一篇新任务时

如果这篇内容是：

• 发布稿
• 教程
• 服务页
• 方法论长文

那它几乎一定值得先看模块目录。

因为这几类内容，本来就最依赖结构判断。

最后

我现在越来越觉得，Agent 用高级排版时，最不该省的那一步，就是先看目录。

少猜一步，后面整条链都更稳。

如果你想继续看，可以接着看：

• Discovery-First Workflow
• Advanced Layout Recipes
• 先发现、再执行：为什么 md2wechat 更适合 discovery-first 的 Agent 工作流