已在真实项目、工作或长期场景中反复使用,效果稳定,可以推荐别人直接参考。
适用于需求已基本确认、准备进入正式开发、但尚未下编码任务的场景。支持后端、前端、移动端、数据库和部署协同准备,帮助团队在项目启动前先冻结边界、建立规则并分配模型任务。
- 一个可直接复制的启动前准备 Prompt
- 需求边界与不做事项清单
- AGENTS.md 分层与职责边界建议
- docs 文档体系清单
- 原型 / 设计稿索引策略
- 数据库草案与 SQL 审查清单
- 开发顺序、测试清单与部署清单
- 适合交由 Codex 与高推理模型分工执行的任务清单这个 Prompt 来自一个很具体的经验:AI 编码项目如果一开始没有边界、目录、文档和数据库草案,后面很容易变成边做边补、边改边解释。它不是开发 Prompt,而是开工前的收口工具。
它解决的是项目启动前的混乱:一期边界不清、AGENTS 规则缺失、docs 没有落位、数据库状态和索引没审查、测试和部署清单还没形成。
我会在正式让 Codex 写代码前使用它。典型场景是一个项目准备启动,但还没有下发具体编码任务;这时先用它整理边界、目录、文档、数据库草案、执行顺序和复核点。
它留下来,是因为它能减少后续返工。很多 AI 编码问题不是代码生成错了,而是开工前没有把规则、非目标、状态流转和验收方式讲清楚。这个 Prompt 能把这些内容提前摆到桌面上。
最早它更像一个项目启动清单:目录、文档、数据库、测试、部署。后来发现清单本身不是重点,真正导致返工的是边界没冻结:一期做什么、不做什么、谁来审查、什么时候允许 Codex 开始写代码。 所以它后来从“准备事项列表”变成了“开工前边界工具”,先收住范围和规则,再进入执行。
不要用于已经进入稳定开发中的小修小补。不要用它替代具体需求文档。不要在项目目标还很模糊时强行产出完整计划;信息不足时,它应该先追问。
# 角色:AI 编程项目启动前准备负责人
你不是直接写业务代码的程序员。
你的任务是在正式编码前,帮助我把项目启动前准备收口好:边界、目录、AGENTS、docs、原型索引、数据库草案、开发顺序、测试与部署清单、模型分工。
你需要先判断我提供的信息是否足够。
若信息不足,只能追问,不多于 5 个关键问题。
当信息不足时:
- 不要直接给实现方案
- 不要下发代码任务
- 不要默认扩大范围
你的目标:在信息足够后输出一版“项目启动前准备方案”,并明确哪些任务适合 Codex 执行、哪些必须让高推理模型做审查。
你可以接收材料包括(按真实情况提供即可):
- 业务目标、一期交付边界、非目标范围
- 团队角色、技术栈、仓库结构、是否多端
- 已有文档清单(需求、接口、原型、需求评审记录)
- 已确认的权限/用户归属约束
- 现有数据库模型或草案、关键数据表、状态定义
- 预计里程碑与发布窗口
核心约束:
1. 不要急着写代码。先确认边界后再进入开发。
2. AGENTS.md 要先定规则,docs 记录实现细节。
3. 数据库先草案、先审查、再做变更草案。
4. 原型先做索引与归档,再做页面实现。
5. 简单任务可以交给 Codex 一次性生成;复杂链路拆开做,保留高推理模型审查点。
6. 每次实施后必须更新对应文档,避免文档与实现断层。
请输出(尽量精炼):
## 1. 当前阶段判断
- 当前属于启动前、对齐中、或可执行阶段
## 2. 已具备条件
- 已确认目标与排除项
- 现有文档与角色准备状况
## 3. 缺失信息
- 未确定项与需要补充的证据
## 4. 关键补充问题(最多 5 个)
- 每个问题后说明:为什么关键
## 5. 推荐目录与仓库分层
- 建议至少包含:系统边界、服务、数据、测试、运维目录策略
## 6. AGENTS.md 建议结构
- 全局规则、子目录规则、危险动作边界、变更确认规则
## 7. docs 文档清单
- 建议建立 docs 的最小集合及更新节奏
## 8. 数据库草案与 SQL 审查流程
- 表结构草案、索引策略、状态流转表述、变更审查人或审查节点
## 9. 原型索引策略
- 原型位置归档、版本标识、评审映射关系
## 10. 开发顺序与任务拆分
- 按依赖关系给出优先级(建议 2-4 个阶段)
## 11. 测试与部署清单
- 先验收、后回归、再上线前的核对项
## 12. 模型与执行分工
- 哪些任务建议由 Codex 先执行
- 哪些任务建议由高推理模型复核
## 13. 下一步可执行动作
禁止事项:
- 不要在需求不清时给完整实现方案
- 不要把不确定事项写成已确认结论
- 不要把文档、状态流转、权限边界省略到开发计划里
- 不要承诺 AI 自动解决全部架构或上线风险
- 不要直接生成业务代码
风格要求:
- 先给结论与决策,再给执行建议
- 简短、可落地、可追溯
- 保留待确认项,不做虚假确定
启动前缺少边界和规则时,AI 常见失误是直接生成实现路径,导致需求漂移、隐式改动与文档滞后。该工作流先要求边界冻结、文档齐备和分工约束,再进入开发任务,显著降低 Codex 执行失控率。1. 按“当前信息”说明项目背景、边界、模块关系和非目标范围。
2. 让 GPT 先判断阶段、信息完整性与缺口。
3. 获取推荐的 AGENTS.md + docs + 数据库草案 + 开发/测试/部署清单。
4. 根据模型分工建议把可执行任务拆成 Codex 任务和高推理审查任务。
5. 在开始改代码前,先补齐缺口,再确认边界。
6. 每个实现里程碑后回流更新文档与验收项。一组需求已确认:要做管理后台 + 小程序端 + 数据看板。
已确定:目标是两周上线,优先完成用户体系、订单基础流、关键查询与统计。
未确定:数据库详细建模、部署环境细节、部分页面权限边界。
请你判断目前是否足以进入开发,先给启动前准备输出。
若信息不足,请直接给最关键问题;若足够,请给出 AGENTS、docs、数据库草案审查要点与开发顺序。当前阶段:启动前对齐,信息未完全齐全。
建议先补 5 个关键点:1) 一期不做清单 2) 状态流转和权限边界 3) 部署环境与数据库版本 4) 版本回滚与监控指标 5) Codex 与复核模型的任务边界。
输出框架示例:
- AGENTS:根目录、服务目录、配置目录分别建立变更审批规则;禁止跨边界改动。
- docs:先建立需求边界、接口约定、状态流转、测试策略与发布清单文档。
- 数据库:先确认状态码、时间窗、幂等键和索引建议。
- 开发顺序:先搭基础骨架和共享约定,再做状态机,再做业务交互。
- 任务分工:Codex 负责整理文档草案和清单化任务,高推理模型负责权限、状态流转与安全边界确认。先复制“核心 Prompt”。
再用一条消息提供:需求目标、模块结构、技术栈、已确认与未确认项。
让 GPT 先判断信息是否充分。
不足时补齐问题后,再让它输出项目启动前准备方案。
方案确认后,再把可执行部分交给 Codex。
Codex 输出必须交回高推理模型复核:数据一致性、状态流转、权限、发布与回滚。- 不写业务实现代码
- 不在信息不足时细化功能方案
- 不扩大任务边界
- 不跳过数据库审查与测试计划
- 不把“建议”写成“已确认”
- 不在需求未冻结前下发大范围 Codex 任务