用 Codex 接手陌生项目,先问这四个问题

拿到一份能运行的代码,却不知道从哪里改,先让 Codex 读一遍项目,给出带文件路径的说明,会比立即发一个大改造需求更容易核对。

重点是把“看懂项目”和“已经运行验证”分开。

先发这四个问题

1
2
3
4
5
6
7
8
9
本轮只读项目,不改文件、不装依赖,也不运行程序或测试。

1. 项目做什么?入口和关键文件在哪里?
2. 本地怎样运行,需要哪些依赖?
3. 有什么检查命令,对应哪些测试文件?
4. 哪些信息缺失,哪些结论还不能确认?

用实际文件路径支撑回答。
区分文档记载、代码分析和运行验证。说明后先停下。

这里的只读边界是为了这一步检查。后面需要运行或修改时,再按具体任务给出范围。官方提示指南也建议提供相关上下文与清晰目标。OpenAI Prompting

用一个小项目看回答是否具体

原演示读取了商品表检查工具,得到几条可以核对的结果:

  • check_products.py 的 main() 是入口。
  • sample.csv 是模拟输入。
  • 使用说明写了运行命令和输出位置。
  • test_products.py 定义了6项测试。
  • 输出目录已经存在时,程序主动停止,避免覆盖旧报告。

这比“项目结构清晰、功能完善”有用,因为每条都能回到文件里确认。

但读到6个测试,不等于这轮运行了6个测试。2026年10月11日的检查只读文件并分析代码,没有安装依赖、执行程序或测试;检查前后项目文件内容一致。

看懂后再给一个小修改

比如:“在保留现有检查规则和不覆盖旧报告的前提下,为报告补一个统计摘要。”接着写明输入、预期输出和验收方式。

一个熟悉项目里的小改动不必每次完整走四问;这套方法更适合接手不熟悉的代码,或者先弄清运行条件。

原笔记发表于2026年10月11日,博客于10月27日整理;只读检查的事实沿用原记录,没有将它改写成新的运行测试。