第10篇:创建 MASTER_INDEX.md
给项目资料画一张地图
当项目资料越来越多时,最麻烦的不是找不到文件,而是不知道哪个文件能作为依据。MASTER_INDEX.md 就是项目资料地图。它可以告诉 Codex合同资料在哪,施工方案在哪,进度计划在哪,哪些资料是原始备份,哪些资料是 AI 输出,哪些资料状态不明。没有这个索引,Codex 每次都要重新猜资料位置,输出也容易引用错文件。
怎么用MASTER_INDEX.md
MASTER_INDEX.md 应放在 00_项目总控 目录下。初版不用追求完整,可以先把一级目录和已识别资料列出来。后续每次新增资料、归档资料、生成重要成果后,再持续更新。它不是普通文件清单,而是管理索引。每一类资料最好写清:资料名称、所在目录、资料状态、主要用途、是否需要人工确认。
相关操作
- 先进入 00_项目总控 目录,新建 MASTER_INDEX.md
- 列出项目工作仓一级目录
- 根据 99_原始资料备份 和各业务目录中的资料,初步填写资料类别
- 对版本不清、来源不明、是否有效不确定的资料,统一标注“待项目部确认”
- 让 Codex 根据目录结构生成初版索引,但不要让它移动文件
推荐的模板
# MASTER_INDEX.md
## 1. 资料索引说明
本文件用于记录项目管理工作仓中的主要资料类别、存放位置、资料状态和用途。
## 2. 一级目录索引
| 序号 | 目录名称 | 主要用途 | 备注 |
|—|—|—|—|
| 1 | 00_项目总控 | 项目背景、规则、总索引、总控台账 | 长期维护 |
| 2 | 01_合同及招投标资料 | 合同、招标、投标、技术协议 | 高风险资料 |
| 3 | 02_施工组织设计及专项方案 | 施工策划、专项方案、技术措施 | 需版本识别 |
| 4 | 90_Codex输出文件 | AI 初稿、台账、审查报告 | 人工确认后使用 |
| 5 | 99_原始资料备份 | 原始资料备份 | 只读不改 |
## 3. 重点资料清单
| 资料名称 | 所在目录 | 资料状态 | 主要用途 | 是否需确认 |
|—|—|—|—|—|
| 待填写 | 待填写 | 待确认 | 待填写 | 是 |
可以直接给codex的提示词
请根据当前项目管理工作仓的目录结构,生成 00_项目总控/MASTER_INDEX.md 的初版内容建议。
要求:
1. 只读取目录和文件信息,不得移动、重命名、删除或修改任何原始文件;
2. 按资料类别归纳,不要只做机械文件列表;
3. 对合同、施工组织设计、进度计划、资源管理、质量安全、设计变更、会议函件、AI 输出资料分别归类;
4. 对版本不明、状态不明、是否有效不明的资料,标注“待项目部确认”;
5. 输出结果应包含资料名称、所在目录、资料状态、主要用途、需确认事项。
一些注意事项和经验
- 不要把 MASTER_INDEX.md 写成所有文件的流水清单
- 不要让 Codex 根据文件名直接判断“最终版”“审批版”,除非文件内容和资料来源能支持
- 索引可以不完整,但不能把不确定内容写成确定
- 资料新增后,索引必须更新,否则很快失效
- 索引初版不要追求一次完美。工程项目资料复杂,第一版只要能把主要资料类别和关键不确定项识别出来,就已经有价值
- 真正好用的 MASTER_INDEX.md,是随着项目推进持续更新的。每次收件箱归档、台账更新、专题分析完成,都应检查是否需要同步更新索引
到这里你应该……
- 00_项目总控 下已经建立 MASTER_INDEX.md
- 索引覆盖一级目录和主要资料类别
- 资料状态不明的内容已标注待确认
- Codex 后续任务可以通过该索引快速找到资料位置