第二册 Codex 提示词卡片

使用原则

第二册和第一册不一样。

第一册常常是：

请帮我做一个小工具。

第二册更应该是：

请先读项目。
请先解释。
请先检查。
请先告诉我会改哪些文件。

因为第二册开始，你已经有一个项目了。

不要让 AI 一上来大改。

每张卡片都尽量遵守 4 个原则：

原则	意思
先读	先看项目结构和当前状态
先解释	用小白能懂的话说明
小步改	一次只改一个明确目标
必验收	改完必须告诉我怎么检查

卡片 1：让 Codex 画项目地图

我是完全不会代码的新手。请你先不要改代码。

请阅读当前项目结构，并用小白能懂的话告诉我：
1. 这个项目大概是什么类型。
2. 主要页面文件在哪里。
3. 配置文件有哪些。
4. package.json 在哪里。
5. 运行项目应该看哪个命令。
6. 如果我要改页面，通常会改哪些文件。
7. 如果我要保存数据，可能会涉及哪些文件。

请最后给我一张“项目地图表”。

卡片 2：让 Codex 找启动命令

请你先不要改代码。

请帮我查看这个项目应该怎样启动。
请重点看 package.json 里的 scripts。

请告诉我：
1. 应该在哪个文件夹运行命令。
2. 应该运行哪条命令。
3. 启动成功后浏览器可能打开哪个地址。
4. 如果启动失败，我应该复制哪些错误信息给你。

卡片 3：终端报错求助

我运行项目时终端报错了。

我运行的命令是：

我期待发生什么：

实际发生什么：

终端错误信息如下：

请你先判断这个错误属于：
文件夹不对 / 命令不对 / 依赖没装 / 端口冲突 / 环境变量缺失 / 代码报错 / 其他

请不要直接大改代码。
请先告诉我最可能的原因和最小修复步骤。

卡片 4：浏览器页面打不开

项目终端看起来已经启动了，但浏览器页面打不开或显示错误。

终端显示的地址是：

我在浏览器打开的地址是：

浏览器显示的内容是：

请帮我判断：
1. 是地址输错了吗？
2. 是端口不对吗？
3. 是项目还没真正启动成功吗？
4. 是页面代码报错吗？

请先给我检查步骤，不要直接重写项目。

卡片 5：解释 package.json

请你先不要改代码。

请解释这个项目的 package.json。
请用完全不会代码的人也能听懂的话说明：
1. scripts 是什么。
2. dependencies 是什么。
3. devDependencies 是什么。
4. 哪个命令用来启动项目。
5. 哪些依赖看起来和页面有关。
6. 哪些依赖看起来和构建或开发工具有关。

请不要展开讲太深，只讲我运行和维护这个项目需要知道的部分。

卡片 6：依赖安装前先确认

你建议安装新的依赖前，请先解释：
1. 为什么需要这个依赖。
2. 不安装能不能完成第一版。
3. 这个依赖会不会让项目变复杂。
4. 安装后可能改哪些文件。
5. 安装后我应该怎样验收。

如果不是必须，请先给我不新增依赖的方案。

卡片 7：环境变量检查

请你先不要改代码。

请检查这个项目是否需要环境变量。
请告诉我：
1. 需要哪些环境变量名。
2. 它们大概用来做什么。
3. 哪些值不能公开。
4. 是否需要 .env 或 .env.local 文件。
5. 如果环境变量缺失，项目会出现什么现象。

请不要要求我把真实密钥发给你。

卡片 8：判断要保存什么数据

我想让这个小工具保存数据。

请你先不要写代码。
请先帮我判断应该保存什么。

我的小工具是：
用户输入：
工具输出：
我希望以后还能看到的内容：

请用表格告诉我：
1. 哪些数据必须保存。
2. 哪些数据可以先不保存。
3. 哪些数据可能敏感。
4. 第一版是否适合用浏览器本地保存。
5. 刷新页面后应该怎样验收保存是否成功。

卡片 9：添加历史记录前的计划

我想给这个小工具加历史记录。

请你先不要改代码。
请先阅读项目并给我一个最小修改计划。

要求：
1. 第一版只做浏览器本地保存。
2. 保存输入、输出和生成时间。
3. 页面显示历史记录列表。
4. 刷新后历史记录还在。
5. 可以删除单条记录。
6. 不做登录、云数据库、部署、会员、支付。
7. 不重写整个项目。

请告诉我准备改哪些文件，以及每个文件为什么要改。

卡片 10：开始添加历史记录

现在请按刚才的计划添加历史记录功能。

请严格控制范围：
1. 不做登录。
2. 不接云数据库。
3. 不改项目主题风格。
4. 不重写原来的生成逻辑。
5. 优先保证原来的输入、生成、输出功能还在。

完成后请告诉我：
1. 改了哪些文件。
2. 新增了什么状态或保存逻辑。
3. 怎样启动项目。
4. 我应该怎样测试保存、刷新保留和删除。

卡片 11：历史记录验收

请你帮我验收历史记录功能。

请不要建议新功能。
请只检查：
1. 原来的生成功能是否还在。
2. 能不能保存一条历史记录。
3. 历史记录是否显示在页面上。
4. 刷新页面后记录是否还在。
5. 能不能删除单条记录。
6. 删除后刷新，记录会不会回来。

请给我一张通过 / 不通过的验收表。

卡片 12：检查 AI 改了哪些文件

请你先不要继续改代码。

请检查这次修改后，项目有哪些文件被修改、新增或删除。
请用小白能懂的话解释：
1. 每个文件原来大概是做什么的。
2. 这次为什么要改它。
3. 哪些改动和历史记录有关。
4. 有没有看起来超出本次目标的改动。
5. 现在是否适合留下 Git 保存点。

卡片 13：留下 Git 保存点

现在项目可以正常启动，原功能还在，历史记录通过了保存、刷新保留和删除测试。

请帮我留下一个 Git 保存点。

保存点说明请使用：
完成历史记录本地保存和删除

执行前请先告诉我要运行哪些命令。
执行后请告诉我保存点是否成功，以及以后怎样确认这个保存点存在。

卡片 14：项目改坏后的安全求助

项目现在可能被改坏了。

请先不要删除、覆盖或回退文件。
请先帮我检查：
1. 当前 Git 状态。
2. 最近有哪些保存点。
3. 当前错误是什么。
4. 有哪些恢复方案。
5. 每种方案会影响哪些文件。

请先解释方案和风险，不要直接执行危险操作。

卡片 15：第二册总验收

请你帮我做第二册项目验收。

请不要建议新功能，先只检查：
1. 项目怎样运行。
2. 原功能是否还在。
3. 历史记录是否能保存。
4. 刷新后历史记录是否还在。
5. 是否能删除记录。
6. 删除后刷新是否不会回来。
7. AI 改了哪些文件。
8. 是否已经留下 Git 保存点。
9. 下一步只改什么。

请用表格给我验收结果，并把不通过的项目对应到第二册哪一课。

卡片 16：让 AI 控制范围

接下来请你像项目教练一样帮助我。

我完全不会代码，所以请你：
1. 每次改代码前先说明要改什么。
2. 一次只改一个小目标。
3. 如果我提出太大的需求，请主动帮我缩小。
4. 不要把第二册项目变成复杂系统。
5. 改完必须告诉我怎样运行、怎样验收、是否适合留下 Git 保存点。

当前目标是让小工具能运行、能保存、能解释、能继续改。