展开知识库目录
把项目交给 AI 前，先让它盘点目录、规则和构建命令
AI 接手项目前先做四件事：列出目录结构、读规则文件、找出构建和测试命令、确认当前未提交改动。盘点完再派活，能避免它改错地方或覆盖已有工作。
先读目录结构和关键文件
接手一个没看过的项目，最危险的不是不会改，而是 AI 凭着文件名猜。“utils.js 应该跟工具函数有关”这种猜测，猜对九次，猜错一次就够你难受。所以在派活之前，先让 AI 做一次盘点。
盘点包括四件事：目录和入口、规则文件、构建测试命令、当前未提交的改动。做完这份盘点，你对项目的熟悉程度直接上一个台阶，AI 再动手也不会乱跑。
这些情况适合用，另外几种先停一下
适合用
- 第一次接手别人的项目
- 项目很大或结构不熟，怕 AI 改错地方
- 需要在项目里做改动，但不知道构建和测试命令
先别急着用
- 项目是你自己刚写的，结构了然于心
- 只读文档、不碰代码，不需要盘点到文件级
派活前先盘点目录、规则、命令和未提交改动，划定禁改区
为什么这样安排
Codex 官方建议在大项目里用 AGENTS.md 固化项目信息；这里把“进项目先读规则”官方建议扩展成四步盘点，先摸清再动手。
- 01
顶层盘点
让 AI 列出顶层目录、入口文件、README 要点，每个主要目录一句话说明。
- 02
规则文件抄底
检查 AGENTS.md、CLAUDE.md、README、package.json，把关键约定逐条列出。
- 03
命令带来源
构建、测试、启动命令必须注明出处，找不到就标“未在文档中找到”，不许瞎猜。
- 04
未提交改动设禁区
运行 git status / git diff 列出未提交改动，明确告知 AI 这些文件禁止修改。
复制前先替换 {占位}
项目盘点提示词（复制后改 {占位}）
我刚接手这个项目（路径：{项目路径}），在我派任何任务之前，请先做一次完整盘点：
1. 顶层目录和入口文件，每个主要目录用一句话说明用途；
2. README、AGENTS.md、CLAUDE.md 中最重要的约定，逐条列出；
3. 构建、测试、启动、格式化的具体命令（如 npm run build / npm test），从哪里读到的；
4. 运行 git status 和 git diff，列出当前未提交的改动，这些文件视为禁止修改；
5. 最后用 5 句话总结：这个项目怎么跑起来、哪里是核心、哪里容易踩坑。项目盘点结果（示例）
下面是已经填过变量的示例。复制时请换成自己的文件名、数字和材料位置，别把示例数据原样交出去。
看清格式再改
项目盘点结果（示例）
项目：xiaohe 静态站点生成器 目录：scripts/（构建脚本）、content/（内容源）、assets/（样式与脚本）、output/（生成产物） 规则：README 写明“产物不手改，只能改源文件后 rebuild”；无 AGENTS.md 命令：npm run build / npm run verify / npm run preview 未提交改动：content/stage-b-knowledge.mjs（禁止修改） 风险点：output/ 是生成物目录，不手改
先对症状，别一上来重写整段提示词
它改错了模块
- 常见原因
- 没先盘点目录，凭文件名猜
- 怎么修
- 先做项目盘点，任务里指名“相关文件是 X 和 Y”。
跑错命令
- 常见原因
- 没从 package.json/README 确认
- 怎么修
- 让它把命令来源写出来，找不到就说找不到，别猜。
覆盖了你的未提交改动
- 常见原因
- 没先看 git status
- 怎么修
- 盘点步骤里强制要求列出未提交改动，并声明这些文件禁止触碰。
最后五分钟，逐项打勾
这篇具体参考了什么
正文按公开教程和官方文档重新整理，并换成了可以直接操作的中文场景。产品能力、规则和投稿要求会更新，真正执行前请再打开原始页面核对一次。