准备 Git 与项目规则

同一个项目对话

每次只发送当前这一项的提示词：选中框内文字复制（Mac 按 ⌘C，Windows 按 Ctrl+C），切到所选工具的项目对话，粘贴后把【】替换成自己的内容，再点发送。等工具回复并核对“完成后应该看到”的结果，再做下一项。

1. 把项目文件夹初始化为 Git 仓库。在刚才的项目对话中发送下面这句话。Git 用来保存修改历史，已经保存的版本可以找回。展开收起

   建议提示词：

   请检查当前项目是否已经是 Git 仓库。如果还不是，请把这个项目文件夹初始化为 Git 仓库；如果已经是，请继续使用现有仓库。先不要提交或上传文件。

   完成后应该看到：工具明确告诉你已经建立或沿用了 Git 仓库。

2. 创建 AGENTS.md。它是写给 AI 工具看的项目说明书和规则，告诉工具应该怎样做事。展开收起

   建议提示词：

   请在项目根目录创建 AGENTS.md，写明：先读项目说明，再做我当前要求的任务；不擅自增加功能；不删除已有成果；完成后告诉我改了哪些文件、怎样检查。已有文件先读并保留原规则，不直接覆盖。若当前工具不支持此文件，请告诉我它支持的规则入口。

   完成后应该看到：打开 AGENTS.md，能读到项目的工作规则；其他工具则找到它支持的规则文件。

3. 把前面写好的项目描述保存成 idea.md。回到“整理项目描述”复制已确认内容，再粘贴进下面的话。展开收起

   建议提示词：

   请把下面这份项目说明保存到项目根目录的 idea.md。已有同名文件先告诉我差别，不直接覆盖。项目说明：
   【粘贴我已确认的项目描述】

   完成后应该看到：打开 idea.md，可以看到自己的项目名称、用户和想做的功能。

4. 让 Git 保存第一个版本。仓库建好还不等于文件已经保存成版本；完成这一项，才有可以回来的记录。展开收起

   建议提示词：

   请先检查本次文件，排除密码、密钥、数据库和自动生成文件。把本步确认过的项目说明与规则文件提交到本地 Git，作为第一个版本，并告诉我版本号。不要推送。缺少提交身份时告诉我需要填写什么，不替我编造身份。

   完成后应该看到：工具给出一次成功提交的版本号，文件仍能正常打开。

1. 把项目文件夹初始化为 Git 仓库。在刚才的项目对话中发送下面这句话。Git 用来保存修改历史，已经保存的版本可以找回。

   操作后应该看到什么？

   工具明确告诉你已经建立或沿用了 Git 仓库。

   没有看到这个结果时，怎么办？

   提示没有安装 Git 时，请工具按你的系统给出官方安装入口，安装后再做这一项。

2. 创建 AGENTS.md。它是写给 AI 工具看的项目说明书和规则，告诉工具应该怎样做事。

   操作后应该看到什么？

   打开 AGENTS.md，能读到项目的工作规则；其他工具则找到它支持的规则文件。

   没有看到这个结果时，怎么办？

   只有聊天回复而没有文件时，请工具给出保存后的实际文件路径。

3. 把前面写好的项目描述保存成 idea.md。回到“整理项目描述”复制已确认内容，再粘贴进下面的话。

   操作后应该看到什么？

   打开 idea.md，可以看到自己的项目名称、用户和想做的功能。

   没有看到这个结果时，怎么办？

   内容不对时指出哪句需要改；不要让工具重新猜一个项目。

4. 让 Git 保存第一个版本。仓库建好还不等于文件已经保存成版本；完成这一项，才有可以回来的记录。

   操作后应该看到什么？

   工具给出一次成功提交的版本号，文件仍能正常打开。

   没有看到这个结果时，怎么办？

   提交失败先按报错处理，不把初始化成功当成版本已保存；未提交的修改无法靠这次记录找回。

上面已经逐项发送并完成的，不必再发下面整段模板。需要整理本步材料时再使用；替换【】后确认，再复制到项目对话。

先检查能否读取当前项目位置。缺失或无访问能力时，明确缺项与需本人操作的入口，停止本步执行，不编造文件或前序结论。
已确认的项目描述：
【粘贴项目描述步骤生成的文本】
本步建立 Git 仓库、保存项目说明和规则，并提交第一个版本。核对当前文件夹，将以上描述保存为 idea.md；已有文件时先核对差异，不覆盖。检查 Git，已有仓库沿用；没有则初始化并排除密钥及生成文件。按当前工具支持的规则文件入口（如 AGENTS.md）记录：先读项目材料，只执行当前任务，保留已有成果，报告实际检查结果。缺少 Git、身份或写入权限时说明卡点，不编造。读回文件并建立仅包含本步文件的本地 Git 提交，报告位置与版本。不开发功能、不推送。

先检查能否读取当前项目位置。缺失或无访问能力时，明确缺项与需本人操作的入口，停止本步执行，不编造文件或前序结论。
已确认的项目描述：
【粘贴项目描述步骤生成的文本】
本步建立 Git 仓库、保存项目说明和规则，并提交第一个版本。核对当前文件夹，将以上描述保存为 idea.md；已有文件时先核对差异，不覆盖。检查 Git，已有仓库沿用；没有则初始化并排除密钥及生成文件。按当前工具支持的规则文件入口（如 AGENTS.md）记录：先读项目材料，只执行当前任务，保留已有成果，报告实际检查结果。缺少 Git、身份或写入权限时说明卡点，不编造。读回文件并建立仅包含本步文件的本地 Git 提交，报告位置与版本。不开发功能、不推送。

本次已选择个人学习记录全栈跟练。
项目规则补充：本机单人练习，不开放公网；数据库文件和虚拟环境不提交；不使用 localStorage 代替本项目数据库。

提示没有安装 Git 时，请工具按你的系统给出官方安装入口，安装后再做这一项。

项目/
  idea.md
  AGENTS.md（仅工具支持时）
  .gitignore
  .git/（隐藏的版本记录）

当前项目的 AI 对话，然后在工具的文件区或电脑的文件管理器中打开

每次只发送当前这一项的提示词：选中框内文字复制（Mac 按 ⌘C，Windows 按 Ctrl+C），切到所选工具的项目对话，粘贴后把【】替换成自己的内容，再点发送。等工具回复并核对“完成后应该看到”的结果，再做下一项。

1. 让工具给出刚才两个文件的位置。展开收起

   建议提示词：

   请列出本项目 idea.md 和 AGENTS.md（或本工具对应规则文件）的实际路径，并提供可打开的文件链接。只查看，不修改。

   完成后应该看到：得到自己项目中的文件位置。

2. 点击文件链接逐个打开。先看 idea.md 是否是自己的想法，再看规则文件有没有刚才约定的规则。展开收起

   完成后应该看到：两个文件内容正确，能在关闭后重新打开。

跟练：个人学习记录（前端 + 后端 + 数据库）

选择这个示例时，沿用同一个 learning-journal 项目逐步完成。已有自己的项目时，对照检查相关要求即可，不必另建项目。

点击 Codex 回复中的 idea.md 文件链接，或在原项目文件夹打开它，核对正文。

做完这一步，应该看到什么？

能在文件正文找到“后端数据库”和本机使用范围。

做不下去时，先怎么办？

只有聊天里一段文字不算文件；把找不到的文件名交给 Codex 只读检查。

图中回复里的蓝色文件名是文件定位入口；请工具返回你自己项目中 idea.md 的实际文件链接并打开核对。右侧 Review 的红绿行展示改动前后，不等于完整文件，也不是作品运行页面。无法打开时按工具报告的实际路径在文件管理器查找。

1. 让工具给出刚才两个文件的位置。

   操作后应该看到什么？

   得到自己项目中的文件位置。

   没有看到这个结果时，怎么办？

   找不到文件就回上一项确认是否真的保存。

2. 点击文件链接逐个打开。先看 idea.md 是否是自己的想法，再看规则文件有没有刚才约定的规则。

   操作后应该看到什么？

   两个文件内容正确，能在关闭后重新打开。

   没有看到这个结果时，怎么办？

   链接打不开就按实际路径在文件管理器中找，不只看聊天里的代码片段。

上面已经逐项发送并完成的，不必再发下面整段模板。需要整理本步材料时再使用；替换【】后确认，再复制到项目对话。

先检查能否读取idea.md。缺失或无访问能力时，明确缺项与需本人操作的入口，停止本步执行，不编造文件或前序结论。
只核对当前项目中上一步保存的 idea.md 和项目规则文件。返回真实路径与正文摘要；文件缺失就报告缺失，不新建练习文件、不修改现有文件。

先检查能否读取idea.md。缺失或无访问能力时，明确缺项与需本人操作的入口，停止本步执行，不编造文件或前序结论。
只核对当前项目中上一步保存的 idea.md 和项目规则文件。返回真实路径与正文摘要；文件缺失就报告缺失，不新建练习文件、不修改现有文件。

本次已选择个人学习记录全栈跟练。
请指出 idea.md 中有关前端、后端、数据库和第一版范围的原文位置。只读取，不补写不存在的内容。

找不到文件就回上一项确认是否真的保存。

应看到自己的项目描述，不是“这里可以写项目描述”这种说明文字。