文章目录
- [1 完整工作流](#1 完整工作流)
- [2 环境搭建](#2 环境搭建)
-
- 2.1电脑上创建文件夹
- [2.2 codex中创建项目](#2.2 codex中创建项目)
- [2.3 把当前目录初始化为 Git 仓库](#2.3 把当前目录初始化为 Git 仓库)
- [2.4 创建一个AGENTs.md](#2.4 创建一个AGENTs.md)
- [3. 产品方案设计](#3. 产品方案设计)
-
- [3.1 与AI讨论产品设计](#3.1 与AI讨论产品设计)
- [3.2 整理成产品设计文档](#3.2 整理成产品设计文档)
- [3.3 可选的 Demo 环节](#3.3 可选的 Demo 环节)
- [4. 技术方案设计](#4. 技术方案设计)
-
- [4.1 技术方案讨论](#4.1 技术方案讨论)
- [4.2 整理成技术方案](#4.2 整理成技术方案)
- [5. 写代码](#5. 写代码)
- [6. 人工验证](#6. 人工验证)
- [7 参考文献](#7 参考文献)
1 完整工作流
| 阶段 | 主要目的 | 关键产出 |
|---|---|---|
| 1. 环境搭建 | 让项目、版本控制和协作规则就绪 | Git 仓库、AGENTS.md |
| 2. 产品设计 | 明确做什么、不做什么 | MVP 范围、产品设计文档、可选 Demo |
| 3. 技术设计 | 明确怎么做，尤其是技术和架构方向 | 技术方案文档 |
| 4. 产品实现 | 让 AI 编写代码并自行测试 | 可运行版本、测试结果、提交记录 |
| 5. 人工验证 | 检查真实体验和边界情况 | 验收结果、下一轮修复指令 |
2 环境搭建
2.1电脑上创建文件夹
在电脑上，新建一个目录，我这里新建的是codex_test1
2.2 codex中创建项目
2.3 把当前目录初始化为 Git 仓库
- 第一条工程指令：把当前目录初始化为 Git 仓库。
使用git status验证仓库是否初始化成功。
2.4 创建一个AGENTs.md
随后创建项目级 AGENTS.md，它相当于给 Agent 的项目说明书。新会话开始时，Agent 会优先读取其中的项目背景和开发规范。
创建一个AGENTs.md ,写下以下内容，最后提交一个commit
- 每次改动后必须创建对应的 Git commit，便于追踪和回滚。
- 每次改动后必须编写或更新测试，并在交付前完成验证。
3. 产品方案设计
3.1 与AI讨论产品设计
我想做一个电子书阅读器，打算从MVP版本开始。你觉得这一版做哪些功能比较合适呢？
讨论产品时，不必看到一句就提交一次。可以先把问题集中记在输入框中，完整阅读方案后统一反馈，减少反复对话。
1.选择TXT格式；
2.不需要目录；
3.日间主题；
4.桌面版
5.书签先不做
总之，我们先做最基本功能，你觉得现在的想法有什么问题吗
3.2 整理成产品设计文档
我同意你的建议，接下来来帮我整理一份产品设计文档吧。不用太详细，把整体方向和主要功能梳理出来就可以。
- 生成的设计文档
3.3 可选的 Demo 环节
Demo 是一个可以实际操作的前端页面，用来验证界面和交互。通常只实现前端，数据可以模拟，后端逻辑暂时不接。
Demo 的两个价值：
- 提前验证产品设计，发现仅靠文字很难察觉的问题。
- 给 AI 提供更直观的目标，使后续实现更接近预期。
是否做 Demo 的判断标准：
- 后端实现成本高时，更适合先做 Demo，把界面和交互确定下来。
- 后端实现成本低时，可以跳过 Demo，直接做完整产品。
- 案例中的电子书阅读器逻辑简单，因此没有必要单独做 Demo。
4. 技术方案设计
4.1 技术方案讨论
- 可以继续在当前会话讨论，也可以新开会话，让技术设计更聚焦。
- 长上下文对模型的影响不必过度担心，但新会话通常更清晰。
- 这里选择新开一个会话
- 让 AI 先阅读产品设计文档，再讨论技术栈和架构，而不是直接进入详细实现。
- 案例中讨论了 Electron 和 Tauri，最终选择：
- Electron
- React
- TypeScript
- Vite
- Electron Forge
- 方向确认后，让 AI 把技术方案写入
docs文件夹。 - 技术方案不需要一开始就写到最细，重点是先保证技术选型和整体架构方向正确
在这个目录下面有一份产品设计文档。请你读一遍这个产品设计文档，然后告诉我用什么技术站设计，这个产品比较合适， 不用给出过于详细的设计，我们就先探讨一下， 我听说 Electron还可以， 你怎么看呢，
4.2 整理成技术方案
- 生成技术方案文档的
5. 写代码
在正式写代码前，先让 AI 获得验证结果的能力。
- Codex 案例中安装了 Computer Use 和 Chrome 两个插件。
- Computer Use 用于操作电脑。
- Chrome 插件用于查看和验证网页界面。
- 其他编程 Agent 也应配置对应的插件或 Skill。
- 正式实现的提示词应要求 AI：
- 阅读产品设计文档。
- 阅读技术方案文档。
- 按文档要求实现产品。
- 创建 Git commit。
-> 编写或更新测试。- 在交付前完成自测。
6. 人工验证
即使 AI 完成自测，也不代表产品一定没有 Bug。案例中首次执行 npm start 时就出现了"操作失败，请稍后重试"的错误，需要继续让 AI 修复。
因此最后必须亲自运行产品，并完成真实操作验证。