需要给 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 对话。不确定项写“尚未确定”,示例可以自行替换。
已确认 · 以下是本次专属内容,可一键复制
【背景】【填写项目用途与给谁使用】
【当前问题】【填写正在遇到的困难或希望完成的变化】
【输入材料】项目完整路径、idea.md 和已经存在的文件。
【本次任务】核对当前目录与 git --version。使用 git rev-parse --show-toplevel 检查本目录是否已在仓库内,避免把父目录误当项目。已有仓库先运行 git status 并保留历史;确认是新项目后才在其根目录 git init。根据真实文件生成或完善 .gitignore,排除密钥、依赖与构建产物。逐个核对本任务文件再暂存,运行 git diff --cached 检查内容,然后创建初始提交。若缺少提交姓名邮箱,询问实际值,不编造、不擅自改全局配置。不推送远程。
【约束】保留已确认范围和现有工作,不做无关修改。
请按以下顺序执行:
1. 先读取材料并复述目标;缺少会影响结果的信息时,先问一个关键问题。
2. 能由 AI 完成的读取、整理、修改和检查请直接执行;需要本人操作时说明在哪个页面点击什么。
3. 已有项目实施前保留可恢复版本;首次空目录先保留新建文件,Git准备完成后再建立起点提交。不要覆盖现有未确认改动。
4. 给出实际产物、文件位置与当前预览,不把方案当作已经执行。
【需要交付】git status 的实际结果、git log -1 的实际提交信息、未纳入记录的文件及原因。Git 不可用时给出对应系统的官方安装入口,安装后重新检查。
【检查标准】逐项对照本次目标,报告实际检查、未验证项和下一步。删除资料、付费、扩大访问或公开发布前等待明确确认。这是文件正文,不是对话提示词。交给 AI 合并到项目规则文件;待确认字段由 AI 读取真实项目后补齐。
已确认 · 以下是本次专属内容,可一键复制
# 项目协作说明
## 项目目标
- 项目用途:待填写。
- 使用者:待填写。
- 第一版范围:读取 docs/requirements.md;尚不存在时先提问确认。
- 暂不做的事:以确认的需求为准,不自行增加。
## 开始任务前
1. 读取本文件、README.md、docs/requirements.md、docs/design.md 和 tasks/todo.md 中已存在的内容。
2. 核对当前项目目录、Git 状态和未提交变化。不存在的文件先说明,不编造。
3. 复述本次目标及完成标准,只问会实质影响结果的缺失信息。
## 实施方式
- 能自动完成的读取、整理、实现和检查直接完成。
- 每次交付一个可以打开检查的小版本,保留已有工作,不无关重构。
- 使用当前项目已经采用的技术和样式;变更方案先解释原因与影响。
- 用普通话解释技术词,提供具体点击步骤和预期画面。
## 项目命令(由 AI 核对后填写,不猜测)
- 安装依赖:待确认。
- 启动预览:待确认。
- 检查代码:待确认。
- 构建产物:待确认。
- 项目尚未建立时,以上保持待确认;环境准备完成后补齐。
## 检查与完成
- 对照需求检查正常操作、空值、失败和受影响的旧功能。
- 将实际执行、通过、失败和未验证项分别写入 docs/checks.md。
- 更新 tasks/todo.md 的状态;给出文件位置、当前预览和下一步。
- 构建成功不能替代人工试用,未执行的检查不能说通过。
## 版本与资料
- 修改前确认可以找回当前版本;检查通过后提交本任务的文件,并写明改动。
- 提交前检查暂存内容,不提交密钥、个人资料、依赖目录和构建产物。
- 不覆盖无关的未提交工作,不随意删除历史或使用强制恢复。
- Git 只记录纳入版本管理的文件,不等于线上数据库备份。
## 需要本人决定
- 付费、删除资料、扩大访问权限、推送远程或公开发布前说明影响并等待确认。
- 遇到无法继续的问题,记录已经尝试的步骤、实际结果和最小待确认事项。
先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。
已确认 · 以下是本次专属内容,可一键复制
我准备在当前项目建立 AI 协作规则,请直接完成以下任务。
【项目路径】填写已经在工具中打开的项目位置。
【项目用途】填写用途,或读取 idea.md。
【正在使用的工具与版本】填写工具名称;版本未知时请先核实。
1. 先说出当前项目根目录,读取已有规则文件与 README,保留原内容。
2. 根据当前工具官方说明,确认规则文件名、放置位置和加载条件。通用文件名是 AGENTS.md(复数),不要自行使用 AGENT.md。若需 CLAUDE.md、GEMINI.md 或设置页,说明原因并按当前版本接入,避免两套冲突规则。
3. 把下面的模板合并进真实项目。根据文件填写已知信息,未知命令保持“待确认”,不要猜测。
4. 保存后重新读取,报告完整路径、改动摘要、三个约束及仍待确认的内容。
5. 检查当前会话的规则加载记录(工具提供时);另开新会话后再做一次读取检查。无法观察自动加载时明确写“尚未验证”,不要仅凭自述说自动生效。
6. 本次不制作业务功能、不推送、不发布。
以下是文件内容模板:
# 项目协作说明
## 项目目标
- 项目用途:待填写。
- 使用者:待填写。
- 第一版范围:读取 docs/requirements.md;尚不存在时先提问确认。
- 暂不做的事:以确认的需求为准,不自行增加。
## 开始任务前
1. 读取本文件、README.md、docs/requirements.md、docs/design.md 和 tasks/todo.md 中已存在的内容。
2. 核对当前项目目录、Git 状态和未提交变化。不存在的文件先说明,不编造。
3. 复述本次目标及完成标准,只问会实质影响结果的缺失信息。
## 实施方式
- 能自动完成的读取、整理、实现和检查直接完成。
- 每次交付一个可以打开检查的小版本,保留已有工作,不无关重构。
- 使用当前项目已经采用的技术和样式;变更方案先解释原因与影响。
- 用普通话解释技术词,提供具体点击步骤和预期画面。
## 项目命令(由 AI 核对后填写,不猜测)
- 安装依赖:待确认。
- 启动预览:待确认。
- 检查代码:待确认。
- 构建产物:待确认。
- 项目尚未建立时,以上保持待确认;环境准备完成后补齐。
## 检查与完成
- 对照需求检查正常操作、空值、失败和受影响的旧功能。
- 将实际执行、通过、失败和未验证项分别写入 docs/checks.md。
- 更新 tasks/todo.md 的状态;给出文件位置、当前预览和下一步。
- 构建成功不能替代人工试用,未执行的检查不能说通过。
## 版本与资料
- 修改前确认可以找回当前版本;检查通过后提交本任务的文件,并写明改动。
- 提交前检查暂存内容,不提交密钥、个人资料、依赖目录和构建产物。
- 不覆盖无关的未提交工作,不随意删除历史或使用强制恢复。
- Git 只记录纳入版本管理的文件,不等于线上数据库备份。
## 需要本人决定
- 付费、删除资料、扩大访问权限、推送远程或公开发布前说明影响并等待确认。
- 遇到无法继续的问题,记录已经尝试的步骤、实际结果和最小待确认事项。
工具与规则:遇到问题这样查
2 种情况以下路径整理自官方文档与公开求助,不代表发生频率。先按现象检查,再核对处理结果。
AI 说改好了,却找不到文件
看到的现象:聊天给出一段代码,但项目目录中没有对应文件。
- 先检查哪些地方?
确认当前工具是聊天模式还是可编辑项目模式,并读出工作目录。
- 接着处理
在工具中打开实际项目文件夹;让 AI 新建 tool-check.md 写入一行测试文字,再读回确认。成功后删除这个测试文件。
- 这样才算解决
在文件列表和 AI 读回结果中都看到同一文件及内容。
先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。
已确认 · 以下是本次专属内容,可一键复制
我在【AI 说改好了,却找不到文件】这一步遇到问题。
项目与工具:[填写名称、版本和项目路径]
实际现象:[填写操作步骤、报错原文或附截图;隐去密钥和个人数据]
期望结果:[填写实际目标]
请先检查:确认当前工具是聊天模式还是可编辑项目模式,并读出工作目录。
处理方向:在工具中打开实际项目文件夹;让 AI 新建 tool-check.md 写入一行测试文字,再读回确认。成功后删除这个测试文件。
请先说明证据和原因,再执行最小范围修复;保留已有改动,不扩展功能。需要我操作时,一次给出一个位置明确的动作,并说明应当看到什么。
验证标准:在文件列表和 AI 读回结果中都看到同一文件及内容。
最后列出实际验证结果、未验证项和下一步。
如需创建检查文件,先确认文件名未被占用;只删除本次新建的检查文件,保留所有已有文件。规则文件存在,但 AI 没按规则做
看到的现象:AI 改了不该改的文件,或每次都忘记启动命令。
- 先检查哪些地方?
核对文件名 AGENTS.md(复数)、所在目录、工具版本及实际加载记录。
- 接着处理
先让 AI 读规则并复述三条约束。Claude Code 当前版本对 AGENTS.md 的加载有条件;已有 CLAUDE.md 时检查是否导入,旧版可用 CLAUDE.md 中 @AGENTS.md。规则去重并写成能检查的动作。
- 这样才算解决
新任务能列出规则来源,并按一项小任务验证遵守;复述不等于强制执行。
先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。
已确认 · 以下是本次专属内容,可一键复制
我在【规则文件存在,但 AI 没按规则做】这一步遇到问题。
项目与工具:[填写名称、版本和项目路径]
实际现象:[填写操作步骤、报错原文或附截图;隐去密钥和个人数据]
期望结果:[填写实际目标]
请先检查:核对文件名 AGENTS.md(复数)、所在目录、工具版本及实际加载记录。
处理方向:先让 AI 读规则并复述三条约束。Claude Code 当前版本对 AGENTS.md 的加载有条件;已有 CLAUDE.md 时检查是否导入,旧版可用 CLAUDE.md 中 @AGENTS.md。规则去重并写成能检查的动作。
请先说明证据和原因,再执行最小范围修复;保留已有改动,不扩展功能。需要我操作时,一次给出一个位置明确的动作,并说明应当看到什么。
验证标准:新任务能列出规则来源,并按一项小任务验证遵守;复述不等于强制执行。
最后列出实际验证结果、未验证项和下一步。查证依据Claude Code · Project instructions ↗Reddit · Original ignored-instructions report ↗
Git 与环境:遇到问题这样查
2 种情况以下路径整理自官方文档与公开求助,不代表发生频率。先按现象检查,再核对处理结果。
Git 初始化或首次提交失败
看到的现象:出现 not a git repository、Author identity unknown,或仓库包含无关目录。
- 先检查哪些地方?
确认项目根目录、git --version、git rev-parse --show-toplevel 和 git status。
- 接着处理
新项目根目录才执行 git init;父目录已有仓库先确认归属。身份缺失时由本人提供姓名与邮箱,只设置当前仓库;检查忽略文件和暂存差异后再提交。
- 这样才算解决
仓库根目录正确,git log -1 显示本次提交,密钥和无关文件未被跟踪。
先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。
已确认 · 以下是本次专属内容,可一键复制
我在【Git 初始化或首次提交失败】这一步遇到问题。
项目与工具:[填写名称、版本和项目路径]
实际现象:[填写操作步骤、报错原文或附截图;隐去密钥和个人数据]
期望结果:[填写实际目标]
请先检查:确认项目根目录、git --version、git rev-parse --show-toplevel 和 git status。
处理方向:新项目根目录才执行 git init;父目录已有仓库先确认归属。身份缺失时由本人提供姓名与邮箱,只设置当前仓库;检查忽略文件和暂存差异后再提交。
请先说明证据和原因,再执行最小范围修复;保留已有改动,不扩展功能。需要我操作时,一次给出一个位置明确的动作,并说明应当看到什么。
验证标准:仓库根目录正确,git log -1 显示本次提交,密钥和无关文件未被跟踪。
最后列出实际验证结果、未验证项和下一步。查证依据Git · git init ↗GitHub · Commit username ↗GitHub · Commit email ↗
依赖安装失败或预览打不开
看到的现象:看到 command not found、安装报错或浏览器拒绝连接。
- 先检查哪些地方?
读取 README、项目版本文件、锁文件和终端第一条错误,确认当前目录。
- 接着处理
按项目要求安装运行时和匹配的包管理器;不要混用锁文件。启动项目已定义的命令,保持进程运行,打开终端实际给出的地址与端口。仍失败则检查监听地址与日志。
- 这样才算解决
同一地址能加载页面;终端无启动失败,记录实际命令和版本。
先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。
已确认 · 以下是本次专属内容,可一键复制
我在【依赖安装失败或预览打不开】这一步遇到问题。
项目与工具:[填写名称、版本和项目路径]
实际现象:[填写操作步骤、报错原文或附截图;隐去密钥和个人数据]
期望结果:[填写实际目标]
请先检查:读取 README、项目版本文件、锁文件和终端第一条错误,确认当前目录。
处理方向:按项目要求安装运行时和匹配的包管理器;不要混用锁文件。启动项目已定义的命令,保持进程运行,打开终端实际给出的地址与端口。仍失败则检查监听地址与日志。
请先说明证据和原因,再执行最小范围修复;保留已有改动,不扩展功能。需要我操作时,一次给出一个位置明确的动作,并说明应当看到什么。
验证标准:同一地址能加载页面;终端无启动失败,记录实际命令和版本。
最后列出实际验证结果、未验证项和下一步。查证依据npm · Install Node.js and npm ↗Astro · Develop and build ↗Vite · Original connection-refused report ↗
工具差异与官方依据 · 2026-09-23 核对
按钮名称、可用能力和费用可能随版本变化。按所用工具的实际界面与官方说明操作;本页没有代为注册、付费或发布。