📌 一句话摘要

本文介绍规格驱动开发，它利用 Markdown 作为 AI 编码代理（如 GitHub Copilot）的“编程语言”来生成可执行代码，从而提高一致性和优化工作流程。

📝 详细摘要

本文提出了一种名为“规格驱动开发”的新方法，用于使用 AI 编码代理（如 GitHub Copilot）构建应用程序。它旨在解决 AI 代理在迭代编码时常遇到的上下文丢失或重复指令问题。核心思想是使用 Markdown 文件 (`main.md`) 作为唯一的真实来源，定义应用程序的目的、设计决策，甚至是详细的逻辑（变量、循环、数据库模式）。AI 通过读取此 Markdown 规范、用户友好的 `README.md` 以及 AI 代理提示 (`compile.prompt.md`)，将规范“编译”为实际的可执行代码（例如，Go 代码）。作者通过“GitHub Brain MCP Server”项目演示了此工作流程，并强调了如何将 `README.md` 文档嵌入到 `main.md` 中以保持同步。该工作流程还包括使用 AI 对 Markdown 规范进行“代码规范化”。几个月后的观察表明，该方法效果良好，并且随着代理更新而不断改进。但也存在一些挑战，例如大型代码库的编译速度变慢以及测试集成问题。总的来说，这种方法提供了一种增强与 AI 编码代理交互的有效途径，从而提高开发效率和一致性。

💡 主要观点

1. 使用 Markdown 进行规格驱动开发可以增强 AI 编码代理的一致性，减少上下文丢失。 通过在 Markdown 规范中定义应用程序逻辑和设计，AI 代理可以更清晰地理解项目需求，从而确保代码生成的一致性并减少重复指令。
2. 该工作流程将 Markdown 视为一种“编程语言”，允许 AI 将其“编译”为可执行代码。 这种创新方法将应用程序定义集中在易于理解的 Markdown 中，然后由 AI 代理将这些规范转换为可执行代码，从而简化开发和文档同步。
3. 这种实验性方法虽然面临挑战，但能够提高开发者的生产力，并为与 AI 编码工具的交互提供新的途径。 作者的观察表明，该工作流程非常有效，尤其是在代理更新后，这预示着开发者利用 AI 进行软件创建的方式可能会发生转变。

💬 文章金句

• 如果我用 Markdown 指令文件“编写”整个应用程序会怎么样？
• 这实际上是用 Markdown 和纯英语进行编程：存储变量、循环和逻辑条件。
• `main.go` 文件越大，编译速度越慢。
• 该领域的快速发展令人鼓舞，希望我的实验性工作流程能为您提供一些实用的想法。

📊 文章信息

阅读完整文章