在上一期我们已经可以让 Codex 和 GitHub 连接起来了，可以提交、推送、回滚代码。但是，每一次我们都要自己提交和推送，实在是不方便，有没有什么办法可以让整个项目遵守自动提交的规范呢？或者说，有没有一种方式可以构建一个项目规范呢？

答案是肯定的，这就是 AGENTS.md 和 DESIGN.md 文档。

AGENTS.md

这是一个项目的规范文档，每一次 AI 生成内容的时候都会读一遍这个文档，因此，是绝对会执行的（不过具体能执行多少，这受到模型能力的影响，例如 GPT 5.6 sol 基本可以完全遵循，但是 GPT 5.6 luna 可能只能遵守 60% 左右）。

项目中的 AGENTS.md

这个 Markdown 文档一般是用来规范或者教会 AI 一些必要的特定操作或者问题的解决方式。例如：

  • 每次 AI 生成后，要求自动提交代码；

  • 当遇到 xxx bug 的时候，必须使用 xxx 方案来解决，代码和架构如下……

不难看出，这是给 AI 提供了一份特定项目的规范文档。有了它，AI 就可以按照我们的要求写代码。你可以写清楚项目是做什么的、使用什么技术栈，也可以要求每次代码变更后都自动提交。而且，上一篇文章介绍了 Git 提交规范，你也可以把它写到 AGENTS.md 文档里，让 AI 提交时遵守。

但是请务必注意 AGENTS.md 的文件体积，最好不要太多行（理论上超过 100 行就有些多了），建议通过索引构建目录的多文档结构来处理 AGENTS.md，我曾写过一篇专门的文章（链接：从一篇 AGENTS.md 指南到 AgentsMD-GEN · AI）以及对应的 Skill 来解决 AGENTS.md 的维护问题，链接：https://github.com/Niall-Young/AgentsMD-GEN。

DESIGN.md

DESIGN.md 的名字其实就已经告诉我们它是做什么的了。

它用来约定设计规范（注意，我这里没有说它能直接让 AI 生成优质的设计稿），例如品牌色、圆角等。通常包括变量、字体样式、阴影及其基础用法，Google 的 DESIGN.md 开源仓库中有详细介绍。

DESIGN.md 示例

这个东西的作用在前段时间的营销中被严重高估了，其主要作用就是用来规范以下几件事情：

  • 规范全局变量、样式及其使用方式；

  • 规范组件和控件的基础交互；

  • 规范交互流程、交互逻辑。

Vercel、Atlassian 等公司对 DESIGN.md 有着相对工程化和详细的实践，如果你感兴趣可以查看一下这几篇文章：

  • Vercel 工程实践：https://vercel.com/blog/how-our-agents-build-on-brand-pages-with-design-md

  • Atlassian 工程实践：https://www.atlassian.com/blog/how-we-build/atlassians-design-md-is-here-what-we-learned-testing-portable-design-context-in-practice

创建 AGENTS.md 和 DESIGN.md

创建很简单：在项目根目录里创建两个 Markdown 文件，分别命名为 AGENTS.md 和 DESIGN.md。当然，你也可以让 AI 帮你创建，它通常会先梳理当前项目的一些基础规范。

创建一个 AGENTS.md 和 DESIGN.md

通常来说，这两个文档都会在项目开始时创建。

使用建议

  • 在项目开始时，也就是 Git 仓库初始化之后，就创建好 AGENTS.md；

  • DESIGN.md 只适合在小项目和原型中使用，不适合在大型项目中使用，token 消耗较大且效果不一定会很好；

  • 如果遇到一个 AI 总是改错的问题，在修复好后，要求 AI 把这部分收敛到 AGENTS.md；

  • DESIGN.md 是可以从 Figma 的组件库直接利用 MCP 输出出来的，如果你有设计稿，那么可以这么做。

下一步

现在，我们的项目终于有规范了，然后我们知道如何利用计划模式让 AI 更好地干活，项目管理有 Git 工具了，但是，如果我们遇到了选择题——这个按钮用蓝色还是紫色更好，该怎么办呢？