第11篇:Codex的第一次只读检查
让 Codex 先诊断,不要急着改文件
第一次让 Codex 接触项目资料时,最忌讳直接说“帮我整理一下”。这句话太宽,AI 可能会开始生成、改写、移动或建议大量动作。更稳妥的做法是先做只读诊断。也就是让 Codex 只看目录和文件,不做任何修改,先判断资料结构、缺口、版本问题和风险点。先诊断,再动手,这是工程资料 AI 化的基本顺序。
如何操作
这个操作适合在工作仓、90 输出区、99 备份区、三大控制文件初步建立后执行。你要明确告诉 Codex:本次只能读取,不得新增、修改、删除、移动任何文件。
它的输出成果建议放在 90_Codex输出文件/01_资料诊断报告 中,文件名可以是“日期_资料管理_项目资料初步诊断报告_v1.md”。
- 打开 Codex,并选择已经建立好的项目管理工作仓
- 要求 Codex 先读取 PROJECT_CONTEXT.md、CODEX_RULES.md、MASTER_INDEX.md
- 明确本次任务为“只读诊断”,不得改文件
- 让 Codex 输出资料类别、目录问题、版本问题、缺口问题、风险提示
- 人工查看诊断结果,确认哪些问题真实存在,哪些需要补充资料
输出成果的建议结构
# 项目资料初步诊断报告
## 1. 本次检查范围
– 检查目录:待填写
– 检查方式:只读检查
– 是否修改文件:否
## 2. 已识别资料类别
– 合同及招投标资料:待填写
– 施工组织设计及专项方案:待填写
– 进度计划资料:待填写
– 资源管理资料:待填写
– 质量安全资料:待填写
– 会议函件资料:待填写
## 3. 发现的主要问题
| 序号 | 问题类别 | 问题描述 | 影响 | 建议处理 |
|—|—|—|—|—|
| 1 | 待填写 | 待填写 | 待填写 | 待填写 |
## 4. 需项目部确认事项
– 待填写
## 5. 下一步建议
– 待填写
可以直接给codex的提示词
请先读取 00_项目总控/PROJECT_CONTEXT.md、CODEX_RULES.md、MASTER_INDEX.md。
本次任务仅进行项目资料只读诊断,不得新增、修改、删除、移动、重命名任何文件。
请输出《项目资料初步诊断报告》,内容包括:
1. 当前工作仓目录结构是否清晰;
2. 已识别到的主要资料类别;
3. 原始资料、AI 输出资料、正式业务资料是否存在混放风险;
4. 文件命名、版本状态、资料来源是否存在不清楚的问题;
5. 当前缺少哪些支撑施工策划、进度资源、质量安全、合同分析的资料;
6. 需要项目部人工确认的事项;
7. 下一步建议操作。
凡无法确认的内容,必须标注“待项目部确认”。
注意事项和经验
- 提示词中必须写明“不得修改、删除、移动、重命名文件”
- 不要让第一次任务直接生成正式方案或正式台账
- 诊断报告中出现的判断,要检查是否有依据,不要直接照单全收
- 如果 Codex 提出移动文件建议,也应先人工确认,再另设任务执行
- 第一次只读诊断的价值,不是让 AI 立刻产生成果,而是先摸清资料现场。工程项目管理中,资料状态往往比文字生成更重要
- 凡是新项目、新资料包、新专题开始前,第一步都先做只读诊断。这样能避免 AI 在资料状态不明的情况下直接写出看似完整、实际依据不足的成果
到这里你应该……
- Codex 已完成只读诊断
- 没有任何文件被修改、移动、删除或重命名
- 已形成项目资料初步诊断报告
- 报告中列出了资料缺口和待确认事项