练习AI编程两年半，分享三个必须的顶层提示词，建议无论什么开发工具都手动加上！

在利用 AI 辅助编程的两年半里，我尝试过各种 AI 代码助手（如 Codex, Cursor, Windsurf 等），也经历过从“AI 乱写代码”到“人机高效协同”的磨合过程。

在实际开发中，AI 最大的痛点往往不是代码写不出来，而是**文档乱放、设计方案转瞬即逝、代码改了什么完全不可追溯**。为了让 AI 乖乖听话，并在项目根目录下保持极其严谨的工程结构，我总结了**三个必须的顶层提示词（System Prompt / Instructions）**。

建议大家无论使用什么开发工具，都把它们手动加到你的用户级自定义指令中！


### 1：常规文档

AI 经常会根据我们的要求生成诸如环境配置、部署步骤、API 调用指南等说明。如果不加限制，它们要么直接被打印在聊天框里找不到，要么就被随便丢在项目根目录下。这条提示词强制 AI 将所有指导性文档统一收纳，建立项目保姆级的 `docs` 资产库。

**英文提示词：**

> If I ask you to provide some instructions or guides, please save them to the "docs" folder in the root directory.

**中文翻译：**

> 如果我要求你提供一些操作说明或指南，请将它们保存到根目录下的 "docs" 文件夹中。


### 2：设计文档

在动手写代码之前，优秀的开发者都会先做架构设计和方案评审。让 AI 生成设计方案（Design Proposal）时，我们需要将其固化为文档，便于后续核对或团队协作。此提示词确保所有的核心设计思想、数据库 Schema 设计、接口定义等都有迹可循。

**英文提示词：**

> If I ask you to provide some design proposal documents, please save them to the "design" folder in the root directory.

**中文翻译：**

> 如果我要求你提供一些设计方案文档，请将它们保存到根目录下的 "design" 文件夹中。


### 3：更新日志

这是我高强度使用 AI 编程后最受益匪浅的一条！AI 的修改速度极快，有时候连续改几个文件，回过头来连自己都忘了它到底动了哪些逻辑。这条指令要求 AI 每次修改代码后，自动在 `changelog` 目录里按时间顺序生成带序号的变更记录（如 `001-fix-auth-bug.md`）。这不仅让项目的演进一目了然，还能在 AI 偶尔“翻车”时，作为最完美的复盘和回滚参考。

**英文提示词：**

> Each time code is modified, a new document is created to record the changes in chronological order. Filenames begin with a sort number for easy organization. These documents are saved to the `changelog` folder in the root directory.

**中文翻译：**

> 每次修改代码时，都会创建一个新文档，按时间顺序记录这些变更。为了便于整理，文件名以排序数字开头。这些文档保存在根目录下的 `changelog` 文件夹中。


### 怎么使用它们？

**Cursor**：进入 `Settings -> Features`，直接填入 **`Rules for AI`**。

**Claude Code**：修改用户家目录下的 **`~/.clauderc`**（或通过 `claude config set` 命令配置全局指令）。

**Windsurf**：进入 `Settings`，搜索并填入 **`Global Rules for AI`**。

**Claude Code**：修改用户目录下的 **`~/.claude/settings.json`**（在 `globalInstructions` 字段添加），或在根目录创建全局 **`~/.claude/CLAUDE.md`**。

**VS Code 通用插件 (如 Continue)**：打开全局 `settings.json`，修改对应插件的 **`systemPrompt`** 字段。

### 结语

两年的 AI 编程经验告诉我：**把 AI 当成程序员，不如把 AI 当成一个“需要严格制度约束的初级开发”。** 优秀的顶层提示词就是项目的终极规范，不用你多费口舌，它自己就能把项目的文档、设计、日志管理得井井有条。赶快给你的开发工具加上吧！