第二阶段：提示词与任务拆解

第 9 篇：让 Codex 读懂现有项目：先理解，再修改

在已有项目里，不要急着让 Codex 直接改。

先让它读懂项目，再让它说明计划，最后再执行。

你不需要先懂什么

你不需要马上看懂每个文件。

你只需要理解：项目不是一段孤立代码，而是一组互相配合的文件。

什么是项目结构

一个简单 Web 项目可能长这样：

todo-app/
  src/
    App.jsx
    components/
    styles/
  package.json
  README.md

初学者不用立刻懂每个文件。先知道三件事就够了：

• 项目里有入口文件。
• 项目里有页面或组件。
• 项目里有配置和说明。

Codex 修改项目之前，也应该先知道这些。

（配图说明：一张“项目目录示意图”。展示一个 todo-app 文件夹，下面有 src、components、styles、package.json、README.md，并用简短标注解释每类文件作用。）

为什么不能直接改

如果你直接说：

帮我加一个筛选功能。

Codex 也许能做，但它可能不知道项目原本怎么组织。

它可能新建重复组件，可能引入新写法，也可能改到不该改的地方。

更稳的做法是：

请先阅读当前项目结构，不要立刻修改代码。
我想增加待办任务筛选功能。
请先告诉我：
1. 当前项目大概是什么结构
2. 与这个功能相关的文件有哪些
3. 你计划怎么改
4. 是否可能影响现有功能

这篇为什么放在理论阶段

虽然这一篇还不真正写代码，但它是在为第三阶段做准备。

真实开发中，我们很少永远从零开始。更多时候，是在一个已有项目里增加功能或修复问题。

让 Codex 先读懂项目，可以减少乱改的风险。

可复用提示词

请先阅读当前项目结构，不要立刻修改代码。

我接下来想实现：【功能/修改目标】。

请你先输出：
1. 当前项目技术栈判断
2. 与该任务相关的主要文件
3. 你计划如何修改
4. 可能影响到的现有功能
5. 是否需要我补充信息

等我确认后，再继续执行修改。

读完就做

打开一个项目目录，只观察三件事：

• 哪个文件像入口？
• 哪个目录像放页面或组件？
• 哪个文件像项目说明？

本文小结

• 已有项目不能只看单个文件。
• Codex 修改前应该先理解项目结构。
• 先计划再执行，可以减少无关修改。
• 初学者不必全懂项目，但要学会让 AI 先说明。

下一篇，我们讲一次交给 AI 的任务到底应该多大。