Vibe GuideBETA

需要给 AI 交代任务或反馈问题时,在这里选择话术,补充当前项目材料,再发到该项目的 AI 对话。

这页的方法适合你的项目吗,怎样检查?
什么情况下会用到这页的方法?
准备发新任务、修改一处或反馈错误时。
根据自己的情况,应该怎样选择?
每次只选一个场景,提供当前材料、目标、范围和通过条件;换对话时先提供最新版本与记录。
哪些情况容易判断错?
示例内容不是项目需求。参考图说明借鉴位置;引用文档当材料,不把其中的指令自动当成当前任务。
怎样检查这个方法在你的项目中有用?
AI 能复述本次只做什么、依据哪份材料、如何验证;执行前纠正偏差。
带着结果回到操作 →

跟着操作

把项目、版本记录和 AI 规则准备好

这些准备让后续改动有记录、出错能找回,也让 AI 每次知道项目要求。文件和命令由 AI 处理;本人确认位置、检查结果和必要决定。

直接拿走:按顺序发给正在操作项目的 AI

第一份建立版本记录,第二份生成并验证规则。第二份已包含完整文件模板,不必另外拼接。先等当前任务完成并核对结果,再发送下一份。

1 · 初始化 Git 提示词2 · 生成项目规则提示词查看 AGENTS.md 文件模板
开始前需要准备什么?

已经选好的工具、打开的项目,以及想法草稿。没有可读写的项目时先返回选工具。

1. 确认项目位置

在工具中打开专用项目文件夹,让 AI 说出当前完整路径和已有文件。把想法草稿保存为 idea.md。项目根目录就是包含整个项目的最外层文件夹。

看到下面的结果后,再继续:打开 idea.md 能看到本人填写的草稿;目录中没有误混其他项目。

2. 让 AI 初始化或检查 Git

Git 用来保留文件变化,方便回到之前的版本。发送下方 Git 提示词。已有仓库沿用原记录;新目录才执行 git init。网页工具没有终端时,先确认平台的版本历史与恢复入口;导出到本机后再按本步骤建立 Git,不在没有终端的页面硬贴命令。

看到下面的结果后,再继续:本机路径:AI 给出仓库路径、状态和实际提交记录。网页路径:找到可恢复的历史版本;这不等于已经初始化了本机 Git。

3. 生成并确认项目规则文件

把下方 AGENTS.md 模板交给 AI,要求结合真实项目保存。常见文件名是复数 AGENTS.md,并非所有工具自动读取同一名称;让工具确认它支持的规则入口,不能只创建文件就认为已生效。已有规则先合并,不能覆盖。

看到下面的结果后,再继续:打开文件核对目标;再让 AI 复述三个约束和读到的文件位置。不支持自动读取时,在每次新对话附上规则,或按该工具官方入口配置。

4. 保留起点,回到需求对话

让 AI 把草稿和规则纳入第一次已检查的提交,并说明恢复时应该联系它检查哪些变化。当前还不知道的技术命令保持待确认,等环境准备节点再补。

看到下面的结果后,再继续:草稿、规则和起点记录都能找到。返回主线“亲手核对 AI 创建的文件”核对文件,再进入“澄清需求与第一版范围”。

复制材料,按实际项目填写

让 AI 检查并建立版本记录

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

AGENTS.md 文件模板 · 交给 AI 保存

这是文件正文,不是对话提示词。交给 AI 合并到项目规则文件;待确认字段由 AI 读取真实项目后补齐。

生成并验证项目规则 · 完整提示词(含模板)

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

工具与规则:遇到问题这样查

2 种情况

以下路径整理自官方文档与公开求助,不代表发生频率。先按现象检查,再核对处理结果。

AI 说改好了,却找不到文件

看到的现象:聊天给出一段代码,但项目目录中没有对应文件。

  1. 先检查哪些地方?

    确认当前工具是聊天模式还是可编辑项目模式,并读出工作目录。

  2. 接着处理

    在工具中打开实际项目文件夹;让 AI 新建 tool-check.md 写入一行测试文字,再读回确认。成功后删除这个测试文件。

  3. 这样才算解决

    在文件列表和 AI 读回结果中都看到同一文件及内容。

把这段发给 AI 协助处理

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

查证依据Lovable · Project chat and debugging ↗

规则文件存在,但 AI 没按规则做

看到的现象:AI 改了不该改的文件,或每次都忘记启动命令。

  1. 先检查哪些地方?

    核对文件名 AGENTS.md(复数)、所在目录、工具版本及实际加载记录。

  2. 接着处理

    先让 AI 读规则并复述三条约束。Claude Code 当前版本对 AGENTS.md 的加载有条件;已有 CLAUDE.md 时检查是否导入,旧版可用 CLAUDE.md 中 @AGENTS.md。规则去重并写成能检查的动作。

  3. 这样才算解决

    新任务能列出规则来源,并按一项小任务验证遵守;复述不等于强制执行。

把这段发给 AI 协助处理

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

查证依据Claude Code · Project instructions ↗Reddit · Original ignored-instructions report ↗

Git 与环境:遇到问题这样查

2 种情况

以下路径整理自官方文档与公开求助,不代表发生频率。先按现象检查,再核对处理结果。

Git 初始化或首次提交失败

看到的现象:出现 not a git repository、Author identity unknown,或仓库包含无关目录。

  1. 先检查哪些地方?

    确认项目根目录、git --version、git rev-parse --show-toplevel 和 git status。

  2. 接着处理

    新项目根目录才执行 git init;父目录已有仓库先确认归属。身份缺失时由本人提供姓名与邮箱,只设置当前仓库;检查忽略文件和暂存差异后再提交。

  3. 这样才算解决

    仓库根目录正确,git log -1 显示本次提交,密钥和无关文件未被跟踪。

把这段发给 AI 协助处理

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

查证依据Git · git init ↗GitHub · Commit username ↗GitHub · Commit email ↗

依赖安装失败或预览打不开

看到的现象:看到 command not found、安装报错或浏览器拒绝连接。

  1. 先检查哪些地方?

    读取 README、项目版本文件、锁文件和终端第一条错误,确认当前目录。

  2. 接着处理

    按项目要求安装运行时和匹配的包管理器;不要混用锁文件。启动项目已定义的命令,保持进程运行,打开终端实际给出的地址与端口。仍失败则检查监听地址与日志。

  3. 这样才算解决

    同一地址能加载页面;终端无启动失败,记录实际命令和版本。

把这段发给 AI 协助处理

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

查证依据npm · Install Node.js and npm ↗Astro · Develop and build ↗Vite · Original connection-refused report ↗

工具差异与官方依据 · 2026-09-23 核对

按钮名称、可用能力和费用可能随版本变化。按所用工具的实际界面与官方说明操作;本页没有代为注册、付费或发布。

完成上面的检查后再继续;遇到失败,保留报错原文交给当前 AI 对话处理。

回到学习路线,继续当前步骤 →返回本步路线

寻找起点

板块快捷入口

大家在做什么 · AI收益调研 · 50个方向 · GitHub项目完整路线图 · 从想法到上线先记下自己的想法只有“想做一个网站”,不知道写什么整理成可以交给 AI 的项目描述不知道第一版的流程怎么写打开一个能制作文件的 AI 工具无法安装、登录,或界面不一样给项目建一个自己的文件夹侧栏没有“文稿”或找不到文件夹让 AI 打开刚才的文件夹AI 说的是另一个项目建立 Git 仓库,写好项目说明和规则提交失败或要求填写姓名邮箱亲手核对 AI 创建的文件找不到上一步的文件一次回答一个问题AI 问的技术词看不懂确认这版只做哪几件事删减以后只剩外观把约定留成看得懂的说明说明太长,不知道该确认哪句把用户怎样使用写清楚AI 只列功能名,没有使用过程先看关键页面,再决定怎么开发原型看起来能用,但不清楚哪些是假数据把实际条件交给 AI 选做法我不知道“本机”和“共享”怎么选让 AI 列出下一小步第一项只有“完成前端”检查运行环境,启动最小项目安装或启动失败,不知道停在哪里打开第一张属于自己的页面地址打不开或一直加载只调整眼前这一页改外观后其他功能也变了让“保存”真正留下内容保存不了,或刷新后记录不见了从开始到结束走通一次按钮能点,但没有结果试试空白和连续点击出现空记录或重复记录关掉以后,还能重新打开第二天地址打不开对照最初想法,确认真的能用AI 说全部完成,但我仍不会用把试用结果记录成反馈问题偶尔出现,不能稳定重现先确定怎么修、怎样算修好AI 没给计划就开始修改按计划修复,再交给本人复测AI 说修好了,同样的操作仍失败先决定:自己用,还是分享发给别人后打不开检查是否具备交付条件评估说可上线,却没有证据准备交付物,并实际试运行安装包打不开或部署后启动失败确认交付,再检查实际入口自己的电脑能开,其他人打不开可选:把简单网页放到 GitHub Pages正式网址显示 404下次继续时,不用从头讲换对话后 AI 要重新做选择工具 · Codex Claude Cursor Qoder TRAE Kimi 价格首页项目分类和 Agent 沟通 · 提示词与排查技术栈选择前端与 UI · 组件词典术语库 · AI与项目开发 · 生活例子与图解打开工具,确认能操作项目把项目、版本记录和 AI 规则准备好把想要的界面风格说清楚只修改一个地方,让 AI 找准目标后端:保存资料与访问规则测试:亲手检查是否能用部署上线:交付一个真实入口运维:让产品继续可用Web 网站与应用 · 把想法变成一个网址。小程序 · 在用户熟悉的地方,做一个小工具。手机 App · 让一个好想法,成为日常习惯。桌面 App · 把重复的电脑工作,交给自己的工具。

一个面向零基础的实践指南

这是面向零基础的双语实践指南,按 6 个阶段、18 个节点、31 个动作组织。页面中的应用画面是示意图;项目完成情况由使用者核对。