1. 文档目标这份文档要解决的是三个经常被分开处理、但实际上应该连起来看的问题怎么给 Codex 足够完整的上下文怎么让 Codex 主动读取更多关键文件、目录和规则文件怎么把它的项目理解进一步沉淀成AGENTS.md读完后你应该能够让 Codex 更快建立正确项目认知避免只给少量上下文导致输出泛化让 Codex 主动补齐更多项目理解材料基于读取结果生成团队 AI 规范与AGENTS.md形成一套可反复复用的项目初始化流程2. 为什么这三件事要连起来做很多团队现在的方式是提一个需求贴几段代码直接让 Codex 开始改这样的问题是上下文不完整文件读取不系统理解结果无法沉淀下一次还要重新解释一遍而把这三件事串起来后流程会更像先给初始上下文再让 Codex 主动读更多高价值文件再让它总结项目结构、规则和边界最后产出AGENTS.md和团队规范这样后续所有协作都会更稳。3. 三件事分别解决什么问题3.1 上下文提供解决的问题Codex 不知道你到底要它做什么没有目标、约束和验证标准3.2 主动读取解决的问题你自己也不清楚还缺哪些关键信息只靠你手动挑文件容易遗漏3.3 AGENTS.md 生成解决的问题一次理解不能长期复用团队没有统一 AI 协作规则4. 这套组合方法的核心思想可以把它概括成一句话先给 Codex 足够方向再让它主动补齐项目理解最后把理解结果沉淀成规则。这三步缺一不可只有上下文没有主动读取理解可能太浅只有主动读取没有结构化上下文方向可能发散只有理解没有沉淀后续仍然重复劳动5. 推荐的整体流程1. 给出初始上下文2. 让 Codex 主动读取入口文件3. 让 Codex 继续读取模块与规则文件4. 让 Codex 追典型业务链路5. 输出项目结构化理解结果6. 提炼团队规则与边界7. 生成 AGENTS.md 草案8. 团队评审与正式入库6. 第一步先给初始上下文而不是直接放手让它乱读即使你希望 Codex 主动读取项目也不意味着完全不给方向。你至少要先告诉它当前目标是什么项目大概是什么类型你希望它先做理解不要直接改代码它最终要输出什么推荐初始上下文模板请先不要改代码先帮我建立这个项目的完整上下文。 目标 我希望你先理解项目再进一步生成适合团队使用的 AGENTS.md。 项目背景 这是一个 [项目类型 / 技术栈] 项目。 当前要求 1. 先主动读取关键文件、目录和规则文件 2. 再输出结构化项目理解结果 3. 最后基于理解结果生成 AGENTS.md 草案7. 第二步让 Codex 主动读取关键入口文件这是最稳的起点。推荐优先读取README构建文件例如pom.xml配置文件例如application.yml启动入口核心模块目录示例提示词请先主动读取这个项目的关键入口文件帮助我建立第一层上下文。 请优先阅读 1. README 2. pom.xml 3. application.yml / bootstrap.yml 4. 启动类 5. 核心业务模块根目录 输出 1. 项目结构概览 2. 技术栈 3. 模块大致职责 4. 接下来建议继续读取哪些位置8. 第三步让 Codex 继续读取规则文件和协作文档如果项目里已经有协作规则不让它读这些文件就等于主动丢掉高价值上下文。常见规则文件AGENTS.mdCLAUDE.mdREADMEdocs目录中的规范文档脚本说明、部署说明、SQL 工具说明示例提示词请继续主动检查这个项目是否存在规则文件和协作文档。 优先关注 1. AGENTS.md 2. CLAUDE.md 3. README 4. docs 目录下的规范文档 5. 脚本和部署说明 输出 1. 找到了哪些规则文件 2. 每个文件约束了什么 3. 哪些规则必须优先遵守9. 第四步让 Codex 主动追“典型业务链路”只看目录和规则还不够项目理解一定要下钻到真实调用链。推荐追踪对象一个典型接口一个典型查询链路一个典型保存链路示例提示词在理解完项目结构和规则后请继续主动追踪一个典型业务链路。 目标链路 订单分页查询 请输出 1. Controller 入口 2. Service 调用链 3. Mapper / XML 位置 4. 查询条件在哪一层处理 5. 哪些文件是这个链路的关键上下文10. 第五步让 Codex 输出结构化项目理解结果不要让理解停留在“它看过了”而要输出结构化结果便于后续沉淀。推荐输出结构项目定位技术栈模块与目录职责典型业务链路规则与约束高风险区域适合沉淀成AGENTS.md的规则示例提示词请把你当前主动读取后的理解结果按结构化方式输出 1. 项目定位 2. 技术栈 3. 模块职责 4. 典型链路 5. 已发现的规则和约束 6. 高风险区域 7. 适合写入 AGENTS.md 的规则草案11. 第六步基于理解结果提炼团队规则项目理解完成后下一步不是立即写代码而是先把它提炼成规则。建议提炼的内容AI 工作方式修改边界高风险操作约束测试与验证要求Git 协作要求示例提示词请基于你当前对项目的理解提炼一份团队 AI 协作规则草案。 要求覆盖 1. AI 使用目标 2. 修改边界 3. 高风险操作约束 4. 验证要求 5. Git commit / 分支 / 回滚要求12. 第七步生成 AGENTS.md 草案这一步才是最终沉淀动作。一个好的 AGENTS.md 至少应包含项目说明模块说明AI 工作原则修改规则Git 协作规则高风险场景规则测试与验证要求禁止事项示例提示词请基于你刚才的项目理解和团队规则草案生成一份 AGENTS.md。 要求 1. 内容结构化 2. 贴近真实项目 3. 包含 Git 协作规则 4. 包含修改边界、验证要求和禁止事项13. 一份组合式通用提示词下面这段可以在新项目初始化时直接用。请先不要改代码先帮我建立这个项目的完整协作上下文并最终生成 AGENTS.md 草案。 请按下面顺序进行 1. 先读取 README、构建文件、配置文件、启动类 2. 再读取核心业务模块目录 3. 再检查 AGENTS.md、CLAUDE.md、docs 中的规则文件 4. 再主动追踪一个典型业务链路 5. 输出结构化项目理解结果 6. 提炼团队 AI 协作规则 7. 最后生成 AGENTS.md 草案 输出要求 1. 当前项目定位和技术栈 2. 模块职责 3. 业务链路 4. 已发现规则 5. 高风险区域 6. 团队 AI 协作规则草案 7. AGENTS.md 草案14. Java / Spring Boot 项目实战实例场景你接手一个 Spring Boot 项目希望让 Codex 快速进入状态并最终产出团队规则文件。推荐执行路径第一步给初始上下文这是一个 Java / Spring Boot MyBatis 项目。 请先不要改代码先帮我建立完整上下文并最终生成 AGENTS.md 草案。第二步让它主动读取请主动读取 1. README 2. pom.xml 3. application.yml 4. 启动类 5. yudao-module-system 和 yudao-module-member 核心目录 6. AGENTS.md / CLAUDE.md / docs 中的规则文件第三步让它追典型链路请继续主动追踪一个典型业务链路 用户分页查询 输出 1. Controller 2. Service 3. Mapper / XML 4. 关键约束 5. 高风险区域第四步生成 AGENTS.md请基于你当前的理解生成一份适用于该项目的 AGENTS.md 草案。这样做的价值不是一次性问答而是一次完整的项目上下文建立过程15. 团队初始化实战实例场景团队准备在一个新仓库里系统引入 Codex。推荐做法先由一位负责人运行组合式提示词产出第一版项目理解结果产出第一版团队规则草案产出AGENTS.md草案团队评审后正式入库图示初始上下文Codex 主动读取项目输出项目理解结果提炼团队规则生成 AGENTS.md团队评审正式入库并长期维护16. 常见误区16.1 误区一只给上下文不让它继续主动读取问题理解容易停留在表层16.2 误区二只让它读目录不让它追链路问题很难真正理解业务结构16.3 误区三读完就结束不做沉淀问题下一次还要重新解释16.4 误区四一上来就让它直接生成 AGENTS.md问题没有足够项目理解支撑规则容易空泛17. 注意事项先给方向再让 Codex 主动读取主动读取要有顺序不要盲扫一定要让它继续追规则文件和典型链路生成 AGENTS.md 前先让它输出结构化理解结果团队规则必须人工评审不要直接无脑落库18. 高质量提示词模板18.1 组合初始化模板请先不要改代码先帮我完成项目上下文建立并最终生成 AGENTS.md 草案。 请按顺序 1. 读取关键入口文件 2. 读取模块目录 3. 读取规则文件 4. 追踪典型业务链路 5. 输出项目理解结果 6. 提炼团队规则 7. 生成 AGENTS.md18.2 规则提炼模板请基于当前项目理解结果提炼一份团队 AI 协作规则。 要求覆盖 1. 修改边界 2. 高风险约束 3. Git 协作要求 4. 测试与验证要求 5. 禁止事项18.3 AGENTS 生成模板请基于当前项目结构、规则和风险点生成一份 AGENTS.md。 要求 1. 内容结构化 2. 贴近真实项目 3. 可直接入库19. 团队落地建议如果你想把这套方法推广到团队里建议这样做把这套流程作为新项目初始化步骤固化一份组合式提示词团队统一 review 第一版 AGENTS.md后续随着项目演进持续更新20. 一句话总结“上下文 主动读取 AGENTS.md 生成”的组合版本质上是在把一次性的 AI 问答升级成一套长期可复用的项目理解与规则沉淀机制。21. 快速上手清单先给初始上下文再让 Codex 主动读取入口文件再让它读取规则文件和典型链路再输出结构化项目理解结果再提炼团队规则最后生成 AGENTS.md 草案
Codex 上下文 + 主动读取 + AGENTS.md 生成组合版
1. 文档目标这份文档要解决的是三个经常被分开处理、但实际上应该连起来看的问题怎么给 Codex 足够完整的上下文怎么让 Codex 主动读取更多关键文件、目录和规则文件怎么把它的项目理解进一步沉淀成AGENTS.md读完后你应该能够让 Codex 更快建立正确项目认知避免只给少量上下文导致输出泛化让 Codex 主动补齐更多项目理解材料基于读取结果生成团队 AI 规范与AGENTS.md形成一套可反复复用的项目初始化流程2. 为什么这三件事要连起来做很多团队现在的方式是提一个需求贴几段代码直接让 Codex 开始改这样的问题是上下文不完整文件读取不系统理解结果无法沉淀下一次还要重新解释一遍而把这三件事串起来后流程会更像先给初始上下文再让 Codex 主动读更多高价值文件再让它总结项目结构、规则和边界最后产出AGENTS.md和团队规范这样后续所有协作都会更稳。3. 三件事分别解决什么问题3.1 上下文提供解决的问题Codex 不知道你到底要它做什么没有目标、约束和验证标准3.2 主动读取解决的问题你自己也不清楚还缺哪些关键信息只靠你手动挑文件容易遗漏3.3 AGENTS.md 生成解决的问题一次理解不能长期复用团队没有统一 AI 协作规则4. 这套组合方法的核心思想可以把它概括成一句话先给 Codex 足够方向再让它主动补齐项目理解最后把理解结果沉淀成规则。这三步缺一不可只有上下文没有主动读取理解可能太浅只有主动读取没有结构化上下文方向可能发散只有理解没有沉淀后续仍然重复劳动5. 推荐的整体流程1. 给出初始上下文2. 让 Codex 主动读取入口文件3. 让 Codex 继续读取模块与规则文件4. 让 Codex 追典型业务链路5. 输出项目结构化理解结果6. 提炼团队规则与边界7. 生成 AGENTS.md 草案8. 团队评审与正式入库6. 第一步先给初始上下文而不是直接放手让它乱读即使你希望 Codex 主动读取项目也不意味着完全不给方向。你至少要先告诉它当前目标是什么项目大概是什么类型你希望它先做理解不要直接改代码它最终要输出什么推荐初始上下文模板请先不要改代码先帮我建立这个项目的完整上下文。 目标 我希望你先理解项目再进一步生成适合团队使用的 AGENTS.md。 项目背景 这是一个 [项目类型 / 技术栈] 项目。 当前要求 1. 先主动读取关键文件、目录和规则文件 2. 再输出结构化项目理解结果 3. 最后基于理解结果生成 AGENTS.md 草案7. 第二步让 Codex 主动读取关键入口文件这是最稳的起点。推荐优先读取README构建文件例如pom.xml配置文件例如application.yml启动入口核心模块目录示例提示词请先主动读取这个项目的关键入口文件帮助我建立第一层上下文。 请优先阅读 1. README 2. pom.xml 3. application.yml / bootstrap.yml 4. 启动类 5. 核心业务模块根目录 输出 1. 项目结构概览 2. 技术栈 3. 模块大致职责 4. 接下来建议继续读取哪些位置8. 第三步让 Codex 继续读取规则文件和协作文档如果项目里已经有协作规则不让它读这些文件就等于主动丢掉高价值上下文。常见规则文件AGENTS.mdCLAUDE.mdREADMEdocs目录中的规范文档脚本说明、部署说明、SQL 工具说明示例提示词请继续主动检查这个项目是否存在规则文件和协作文档。 优先关注 1. AGENTS.md 2. CLAUDE.md 3. README 4. docs 目录下的规范文档 5. 脚本和部署说明 输出 1. 找到了哪些规则文件 2. 每个文件约束了什么 3. 哪些规则必须优先遵守9. 第四步让 Codex 主动追“典型业务链路”只看目录和规则还不够项目理解一定要下钻到真实调用链。推荐追踪对象一个典型接口一个典型查询链路一个典型保存链路示例提示词在理解完项目结构和规则后请继续主动追踪一个典型业务链路。 目标链路 订单分页查询 请输出 1. Controller 入口 2. Service 调用链 3. Mapper / XML 位置 4. 查询条件在哪一层处理 5. 哪些文件是这个链路的关键上下文10. 第五步让 Codex 输出结构化项目理解结果不要让理解停留在“它看过了”而要输出结构化结果便于后续沉淀。推荐输出结构项目定位技术栈模块与目录职责典型业务链路规则与约束高风险区域适合沉淀成AGENTS.md的规则示例提示词请把你当前主动读取后的理解结果按结构化方式输出 1. 项目定位 2. 技术栈 3. 模块职责 4. 典型链路 5. 已发现的规则和约束 6. 高风险区域 7. 适合写入 AGENTS.md 的规则草案11. 第六步基于理解结果提炼团队规则项目理解完成后下一步不是立即写代码而是先把它提炼成规则。建议提炼的内容AI 工作方式修改边界高风险操作约束测试与验证要求Git 协作要求示例提示词请基于你当前对项目的理解提炼一份团队 AI 协作规则草案。 要求覆盖 1. AI 使用目标 2. 修改边界 3. 高风险操作约束 4. 验证要求 5. Git commit / 分支 / 回滚要求12. 第七步生成 AGENTS.md 草案这一步才是最终沉淀动作。一个好的 AGENTS.md 至少应包含项目说明模块说明AI 工作原则修改规则Git 协作规则高风险场景规则测试与验证要求禁止事项示例提示词请基于你刚才的项目理解和团队规则草案生成一份 AGENTS.md。 要求 1. 内容结构化 2. 贴近真实项目 3. 包含 Git 协作规则 4. 包含修改边界、验证要求和禁止事项13. 一份组合式通用提示词下面这段可以在新项目初始化时直接用。请先不要改代码先帮我建立这个项目的完整协作上下文并最终生成 AGENTS.md 草案。 请按下面顺序进行 1. 先读取 README、构建文件、配置文件、启动类 2. 再读取核心业务模块目录 3. 再检查 AGENTS.md、CLAUDE.md、docs 中的规则文件 4. 再主动追踪一个典型业务链路 5. 输出结构化项目理解结果 6. 提炼团队 AI 协作规则 7. 最后生成 AGENTS.md 草案 输出要求 1. 当前项目定位和技术栈 2. 模块职责 3. 业务链路 4. 已发现规则 5. 高风险区域 6. 团队 AI 协作规则草案 7. AGENTS.md 草案14. Java / Spring Boot 项目实战实例场景你接手一个 Spring Boot 项目希望让 Codex 快速进入状态并最终产出团队规则文件。推荐执行路径第一步给初始上下文这是一个 Java / Spring Boot MyBatis 项目。 请先不要改代码先帮我建立完整上下文并最终生成 AGENTS.md 草案。第二步让它主动读取请主动读取 1. README 2. pom.xml 3. application.yml 4. 启动类 5. yudao-module-system 和 yudao-module-member 核心目录 6. AGENTS.md / CLAUDE.md / docs 中的规则文件第三步让它追典型链路请继续主动追踪一个典型业务链路 用户分页查询 输出 1. Controller 2. Service 3. Mapper / XML 4. 关键约束 5. 高风险区域第四步生成 AGENTS.md请基于你当前的理解生成一份适用于该项目的 AGENTS.md 草案。这样做的价值不是一次性问答而是一次完整的项目上下文建立过程15. 团队初始化实战实例场景团队准备在一个新仓库里系统引入 Codex。推荐做法先由一位负责人运行组合式提示词产出第一版项目理解结果产出第一版团队规则草案产出AGENTS.md草案团队评审后正式入库图示初始上下文Codex 主动读取项目输出项目理解结果提炼团队规则生成 AGENTS.md团队评审正式入库并长期维护16. 常见误区16.1 误区一只给上下文不让它继续主动读取问题理解容易停留在表层16.2 误区二只让它读目录不让它追链路问题很难真正理解业务结构16.3 误区三读完就结束不做沉淀问题下一次还要重新解释16.4 误区四一上来就让它直接生成 AGENTS.md问题没有足够项目理解支撑规则容易空泛17. 注意事项先给方向再让 Codex 主动读取主动读取要有顺序不要盲扫一定要让它继续追规则文件和典型链路生成 AGENTS.md 前先让它输出结构化理解结果团队规则必须人工评审不要直接无脑落库18. 高质量提示词模板18.1 组合初始化模板请先不要改代码先帮我完成项目上下文建立并最终生成 AGENTS.md 草案。 请按顺序 1. 读取关键入口文件 2. 读取模块目录 3. 读取规则文件 4. 追踪典型业务链路 5. 输出项目理解结果 6. 提炼团队规则 7. 生成 AGENTS.md18.2 规则提炼模板请基于当前项目理解结果提炼一份团队 AI 协作规则。 要求覆盖 1. 修改边界 2. 高风险约束 3. Git 协作要求 4. 测试与验证要求 5. 禁止事项18.3 AGENTS 生成模板请基于当前项目结构、规则和风险点生成一份 AGENTS.md。 要求 1. 内容结构化 2. 贴近真实项目 3. 可直接入库19. 团队落地建议如果你想把这套方法推广到团队里建议这样做把这套流程作为新项目初始化步骤固化一份组合式提示词团队统一 review 第一版 AGENTS.md后续随着项目演进持续更新20. 一句话总结“上下文 主动读取 AGENTS.md 生成”的组合版本质上是在把一次性的 AI 问答升级成一套长期可复用的项目理解与规则沉淀机制。21. 快速上手清单先给初始上下文再让 Codex 主动读取入口文件再让它读取规则文件和典型链路再输出结构化项目理解结果再提炼团队规则最后生成 AGENTS.md 草案
