玩转Vibe Coding：你的Markdown提示词里到底该写些什么？

最近“Vibe Coding”这个概念火得一塌糊涂，大家都在尝试用AI来辅助甚至主导代码编写。但你有没有发现，有时候AI写出来的代码虽然能跑，但风格完全不像你的，或者总是在细节上抓不住重点？

Vibe Coding 强调人类与AI在编码过程中的协作，通过精准的指令提升效率。

这就涉及到了一个关键环节：你是怎么给AI下指令的？很多大佬都会准备一个专属的 Markdown 指导文件（Prompt File），作为与AI协作的“系统说明书”。那么，这份文件里到底应该放些什么，才能让AI真正读懂你的心思，成为你的最强辅助呢？今天我们就来拆解一下。

一、 基础门槛：确立编码规范

首先，别让AI瞎猜。就像雇佣一个新员工，第一件大事就是给他看员工手册。在MD文件的开头，你应该明确项目的编码标准。

• 语言与框架：是用Python写后端还是React写前端？Node.js版本是多少？
• 风格指南：是遵循 Airbnb 的 JavaScript 规范，还是 Google 的 Python 风格？缩进是用 Tab 还是 2 空格？
• 命名约定：变量是用驼峰式还是下划线？文件命名是否有特定规则？

把这些写死在文档里，AI生成的代码就能直接通过你的 Linter 检查，省去大量后期修改的时间。

二、 核心资产：项目上下文与结构

很多Vibe Coding工具是支持“仓库感知”的，但AI的记忆有限，容易迷路。你的MD文档里应该包含一份简短的“项目地图”。

为AI提供清晰的项目结构和模块关系图，能大幅减少代码生成错误。

• 目录结构说明：简要解释核心文件夹的作用，比如 /src 下放什么，/public 下放什么。
• 关键模块关系：如果项目比较复杂，用文字描述一下核心模块的调用关系。例如：“用户认证模块通过 API 调用数据库层，不允许直接访问数据库。”

这能防止AI在写跨文件逻辑时出现“瞎子摸象”的情况，避免创造出并不存在的函数调用。

三、 进阶技巧：上下文注入与排除

这是区分新手和老手的关键点。并不是所有代码都适合喂给AI。

• 显式上下文：告诉AI，“在处理支付逻辑时，必须参考 payment_service.js 中的 validateCard 方法”。这相当于给AI划重点。
• 排除干扰项：特别注明“忽略 /legacy 文件夹下的代码，那是旧版本，不要参考”。如果不写这个，AI可能会把几年前的垃圾代码当成最佳实践学过去，导致代码库退化。

四、 性能与安全红线

在MD文件里设立“高压线”，防止AI写出看起来华丽但实际致命的代码。

• 安全约束：明确禁止使用某些危险的库（如已停止维护的 npm 包），或者强制使用特定的安全工具（如必须使用参数化查询防止 SQL 注入）。

• 性能指标：如果你的应用对性能敏感，可以写上：“所有循环操作必须在 O(n) 复杂度内完成，避免嵌套循环。”或者“前端组件必须保持懒加载。”

五、 个性化你的“AI 人设”

这部分比较有趣，你可以给AI设定一个“扮演角色”。

• 语气与注释：要求生成的代码注释必须是中文，或者必须解释“为什么这样做”，而不仅仅是做了什么。
• 思考模式：比如：“在重构代码前，先列出原有代码的三个缺点，再给出改进方案。”这能强迫AI进行更深层次的逻辑思考，而不仅仅是简单的代码翻译。

六、 实战建议：如何维护这个文件？

别指望写一次就一劳永逸。Vibe Coding 是一个动态过程。

1. 版本管理：把这个 Markdown 文件放在项目根目录里，纳入 Git 管理。团队协作时，大家共同维护这份“说明书”，才能保证AI产出的代码风格统一。
2. 碎片化更新：每次当你发现AI写错了某个反复出现的逻辑，不要只改代码，回去更新你的MD文档。这是在“训练”属于你的专属AI模型。

结语

Vibe Coding 的本质不是让AI完全取代你，而是让你成为一名“架构师”和“审核员”。那个小小的 Markdown 文件，就是你手中指挥AI大军的权杖。花点时间打磨它，你会发现，编程不再是枯燥的搬砖，而更像是一场精密的指挥艺术。

你也试试在下次开干前，先把这份文档准备好？