第8篇：创建 PROJECT_CONTEXT.md
让 Codex 先认识项目背景
很多人让 Codex 写施工方案、周报、函件，结果内容看起来完整，但总觉得不贴项目。原因往往不是 AI 不会写，而是它根本不知道你是谁、项目处于什么阶段、施工单位承担什么范围、当前最重要的工作是什么。PROJECT_CONTEXT.md 就是给 Codex 的项目入场交底。它不需要写成长篇报告，但必须把关键背景说清楚。
为什么要用 PROJECT_CONTEXT.md
每次在聊天里临时告诉 Codex 项目背景，容易遗漏，也容易前后不一致。把背景写成固定文件后，Codex 每次任务前都可以先读取它。
这份文件相当于 AI 的项目说明书。它告诉 Codex：本项目是什么、你站在什么角色、现在处于什么阶段、哪些事情是重点、哪些内容不能乱判断。
它该放在哪里？
我建议把 PROJECT_CONTEXT.md 放在 00_项目总控 目录下。路径示例：00_项目总控/PROJECT_CONTEXT.md，这也是codex所有总控性质文件官方建议的存放位置。不要放在 90_Codex输出文件里。因为它不是 AI 临时成果，而是后续所有任务都要读取的控制文件。
如何操作
- 第一步，在 00_项目总控 目录下新建文件：PROJECT_CONTEXT.md。
- 第二步，按固定结构写入项目背景。不要追求文采，只要清楚、准确、可更新。
- 第三步，不确定的数据不要硬写。例如工期、工程量、资源数量，如果资料中没有明确依据，就写
“待项目部确认”。 - 第四步，让 Codex 检查这份文件是否足以支撑后续工作。
- 第五步，项目阶段变化、范围变化、重点任务变化后，及时更新这个文件。
我的PROJECT_CONTEXT.md 提示词
# PROJECT_CONTEXT.md
## 1. 项目基本信息
– 项目名称：待填写
– 项目类型：风电 / 光伏 / 输变电 / 其他
– 项目地点：待填写
– 建设单位：待填写
– 施工单位：待填写
## 2. 当前使用者角色
– 当前使用者视角：施工单位工程管理人员 / 项目总工 / 项目管理人员
– Codex 工作定位：工程管理辅助工具，不替代审批和最终决策
## 3. 当前项目阶段
– 当前阶段：前期策划 / 施工实施 / 并网调试 / 竣工收尾 / 待确认
– 当前阶段重点：待填写
## 4. 主要工程范围
– 风电工程：待填写
– 光伏工程：待填写
– 输变电工程：待填写
– 其他工程：待填写
## 5. 当前重点工作
– 资料总索引建立
– 施工策划资料缺口识别
– 专项方案清单建立
– 项目风险问题台账建立
– 其他：待填写
## 6. 工作边界
– Codex 不得编造工程量、工期、人员、设备、合同条款；
– 涉及合同责任、工期责任、费用责任、安全质量结论时，只能做资料梳理和风险提示；
– 资料中没有明确依据的内容，应标注“资料中未见明确依据”；
– 需要人工确认的内容，应标注“待项目部确认”。
检查提示词建议
请读取“00_项目总控/PROJECT_CONTEXT.md”，检查该文件是否足以支撑后续 Codex 工程管理工作。
请重点检查：
1. 项目名称、项目类型、项目地点是否清楚；
2. 当前使用者角色是否明确；
3. 当前项目阶段是否明确；
4. 主要工程范围是否清楚；
5. 当前重点工作是否具体；
6. 是否存在未经确认却写成确定事实的内容；
7. 是否需要补充“待项目部确认”事项；
8. 是否能支撑后续资料索引、台账建立、施工策划审查、合同风险分析等工作。
本次只输出检查意见，不得直接修改文件。
我们如何验收成果
- 检查项目名称是否准确。不要用简称代替正式项目名称，除非正式名称太长且在文件中已说明。
- 检查角色是否清楚。施工单位、总包单位、专业分包、业主、监理视角完全不同，不能混写。
- 检查项目阶段是否清楚。前期策划、施工实施、并网调试、竣工收尾，对 AI 输出要求不同。
- 检查当前重点工作是否具体。不要只写“加强项目管理”，而要写“施工组织设计完善、专项方案清单建立、资料缺口识别”等具体任务。
- 检查不确定内容是否标注“待项目部确认”。
一些注意事项和经验
- 不要把 PROJECT_CONTEXT.md 写成宣传稿。它不是给领导看的汇报材料，而是给 Codex 用的工作交底。
- 不要把未经确认的工程量、工期节点、资源数量写成确定事实。
- 不要长期不更新。项目进入新阶段后，旧背景会误导 Codex。
- PROJECT_CONTEXT.md 第一版可以很短，但必须真实。宁可写“资料中暂未明确”，也不要为了完整而编。
- 每次启动重要任务前，可以先让 Codex 读取 PROJECT_CONTEXT.md，再开展分析。这样比每次在聊天里临时解释稳定得多。
- 如果 Codex 输出内容总是偏通用，我们的第一反应不是继续催它写细，而是检查 PROJECT_CONTEXT.md 是否太空、太虚、太旧。
到这里你应该能……
- 00_项目总控 下已建立 PROJECT_CONTEXT.md
- 项目名称、角色、阶段、工程范围已写清
- 当前重点工作不是空话，而是具体任务
- 不确定内容已标注“待项目部确认”
