# Codex 项目启动说明模板

核验日期：2026-07-21

在首次让 Codex 进入仓库前填写。目标是把模糊愿望变成可调查、可实施、可验收的任务。

```md
# 项目启动说明

## 用户与问题
- 目标用户：
- 当前痛点：
- 为什么现在处理：

## 本轮目标
用一句可验收的话描述结果。

## 成功标准
- [ ] 
- [ ] 
- [ ] 

## 当前仓库
- 路径：
- 分支：
- 技术栈：
- 启动命令：
- 关键文档：

## 允许修改

## 禁止修改

## 必须保留

## 已知约束
- 时间：
- 浏览器 / 设备：
- 数据与隐私：
- 兼容性：

## 质量门禁
- lint：
- typecheck：
- test：
- build：
- 手工 QA：

## 第一阶段只读调查
请先说明：
1. 当前实现位置。
2. 相关数据流与权限边界。
3. 最小修改方案。
4. 风险与需要确认的假设。

## 停止条件
涉及删除数据、生产部署、密钥、支付、权限扩大或无法逆转操作时停止并说明。
```

## 填写质量示例

“做一个更好的页面”不可验收；“在 390px 与 1440px 视口还原已提供参考图，保留现有路由和文案，核心 CTA 可点击，移动端无横向溢出”才是可执行目标。

“测试一下”也不够具体；应列出项目已有命令、关键流程和手工 QA 地址。若测试环境不可用，要明确报告未验证范围，不能用构建通过替代数据库、权限或生产流程验证。

## 启动前确认

- [ ] 目标、非目标和成功标准没有互相冲突。
- [ ] 仓库、分支、参考图和文档路径真实存在。
- [ ] 不可逆操作有明确审批人。
- [ ] Codex 可以先做只读调查，而不是立刻编辑。
- [ ] 报告格式包含完成项、文件、测试、QA、已知问题和下一步。

启动说明由任务负责人维护。范围发生变化时先更新说明并记录原因，不要让口头追加悄悄替换原验收标准。

官方来源：

- https://learn.chatgpt.com/docs/codex/quickstart
- https://learn.chatgpt.com/docs/codex/projects-and-chats