这一篇训练的 vibecoding 能力:把项目约定写清楚,让 AI 编程工具每次都按同一套要求工作。工具功能会变化,先用文字规则和可复制提示词完成任务。
先写一份项目说明
在项目文件夹里新建 AGENTS.md,用平常说话的方式写明目标、启动方法和不能改的内容。有些工具会自动读取这个文件;如果没有自动读取,就在对话里明确要求它先读。
# 项目说明
这是一个给编程小白使用的 Python 记账工具。
## 启动方法
在项目文件夹打开 PowerShell,运行 python app.py。
## 修改规则
- 先说明要改哪些文件,再修改。
- 不要把 API Key 写进代码或回复。
- 修改后告诉我如何手动验收。
【可直接复制给 AI 编程工具】
请先阅读当前项目的 AGENTS.md,不修改文件。
用三句话复述项目目标、启动方法和修改限制。
如果文件不存在,请告诉我应该放在哪个文件夹。
【AI 正常会返回什么】 对项目约定的复述。若它漏掉限制,先补充说明,再开始改代码。
把重复任务变成清单
不一定需要工具专属的 Skill 功能。先把步骤保存在 docs/启动检查.md,以后直接引用它。工具支持 Skill 时,再按官方说明转换。
【可直接复制给 AI 编程工具】
请把“启动项目前先检查 Python、依赖、主程序和报错”的步骤写成一份小白能照做的清单。
每一步都说明检查方法、成功标志和失败时要复制什么信息。
不要替我安装不明来源的软件。
【AI 正常会返回什么】 一份可以反复使用的检查清单。你需要照着执行一次,确认命令和路径适合自己的电脑。
只给需要的权限
让工具先读文件并说明计划;明确需要它改代码时,再允许写入。安装依赖、访问网络、改数据库或提交代码之前,先看清它准备执行的具体动作。权限按钮名称因工具而异。
【可直接复制给 AI 编程工具】
请先只读检查这个项目,列出要修改的文件和原因。
在我确认修改范围之前,不要安装依赖、删除文件或访问外部服务。
【AI 正常会返回什么】 文件清单和修改理由。接着只授权本次任务需要的操作。
成功标志: 换一个对话后,工具仍能按照项目说明给出正确启动方法和修改范围;你也知道怎样核对它的每次改动。
