Vibe Coding学习笔记(第六篇):给AI写＂工作手册＂

📖 这是我的「Vibe Coding实战营」学习笔记，记录从零开发一个 AI 项目的全过程。上一篇我们搞定了技术设计，今天来聊聊怎么给AI写开发指令。

如果你也在用AI辅助开发，一定遇到过这个问题：

每次让AI写代码，它都理解错需求——风格不对、规范不对、安全要求也忽略了。改来改去，反而比自己写还慢。

直到今天我才明白：AI开发不是不用写文档，而是要写给AI看。用一份AGENTS.md把所有规则说清楚，AI就能一次性写出符合你要求的代码，开发效率直接翻倍。

为什么要给AI写指令？

你有没有发现：

• 让AI写组件，一会儿用class，一会儿用function，风格不统一

• API Key直接硬编码在代码里，差点把密钥提交到GitHub

• 项目大了之后，新功能代码和老代码风格格格不入

• 每次都要重复说一遍"用Tailwind写样式"、"注意类型安全"

这些问题的根源很简单：AI不知道你的规则。

大模型很聪明，但它不会读心。你不把规则说清楚，它只能按训练集里的平均情况输出。而我们需要的是符合项目规范、满足安全要求、保持风格统一的代码。

AGENTS.md就是解决这个问题的：把项目的开发规范、技术约束、设计要求一次性写清楚，AI每次开发都遵守，省去反复沟通的成本。

AGENTS.md应该包含哪些内容？

根据我的实战经验，一份好的AI开发指令必须包含这9个部分：

三个核心设计思路，让AI更听话

1. 「必须遵守」比「建议」更有用

在我的模板里，关键地方都加上了**「必须遵守」**。为什么？

因为AI天生喜欢"发挥创意"，如果你写"建议使用TypeScript"，它可能就给你写JavaScript。但如果你明确说"必须使用TypeScript，保证类型安全，优先避免any"，它几乎不会出错。

我的经验： 把底线规则明确出来，别怕啰嗦。

2. 给例子，胜过文字描述

看这段命名规则：

- 组件名：`PascalCase`（例如 `TurtleSoupLobby`）- 函数名：`camelCase`（例如 `handleSubmitQuestion`）

如果只写PascalCase，AI可能知道，但加上具体例子，它100%不会错。对于AI来说，具体例子比抽象定义有效得多。

3. 安全规则写最前面，避免事故

我把「AI接入安全要求」单独作为一章，就是因为这个问题太容易踩坑了。

你不提醒AI，它真的会直接把API Key写死在代码里。如果一不小心提交到GitHub，密钥就泄露了。

必问自己： 有哪些规则是绝对不能违反的？单独列出来，用加粗强调。

实际效果如何？效率提升了多少？

写完这份AGENTS.md之后，我最大的感受是：沟通成本骤降。

以前开发一个新组件，我要先说一遍技术栈，再说一遍样式规范，再说一遍安全要求，少说花5分钟。现在，AI打开项目就看到AGENTS.md，自动遵守所有规则，我只需要说清楚「做什么」就行。

粗略统计：

整体开发效率至少提升了2-3倍。

适合谁用？

如果你符合以下任一情况，强烈建议试试AGENTS.md：

✅ 使用Cursor、GPT-4o等AI编程工具✅ 个人开发，全程AI辅助✅ 多人协作，需要统一代码规范✅ 开发AI应用，有特殊的安全/业务规则

哪怕你只是一个人开发，这份"工作手册"也能帮AI少犯错，帮你省时间。

这次实战项目我整理了一份完整的AGENTS.md，有需要的评论区扣666：

Day 6 任务完成：

• 创建AGENTS.md文件

• 整理PRD、技术设计、AGENTS.md三个文档

• 输出学习笔记

思考：为什么需要给AI写指令？

我的答案是：AI是协作伙伴，不是外包员工。你得把规则说清楚，它才能帮到你。

以前我们写文档是给人看的，现在写AGENTS.md是给AI看的。本质上都是降低沟通成本，提高协作效率。

当你把规则沉淀下来，AI就能一次性写出符合预期的代码，你也能把精力花在真正重要的产品设计上，而不是反复给AI改错。

关注我，持续更新AI产品实战营学习笔记，带你一步步用AI开发出完整产品。

如果你也在做AI开发，或者想试试用AI辅助开发，欢迎交流讨论。