AI 做产品?你是否也遇到了这些坎?


想用 Cursor 这类强大的 AI 编程工具,把脑海中的产品想法快速变成现实?但在激动地投入尝试后,你是否也遇到了这些令人抓狂、甚至想放弃的问题:

  1. 想法很酷,代码“挠头”? 懂产品、懂需求,但面对具体编码实现(或让 AI 实现)时,感觉力不从心,不知如何精确指导?
  2. AI 时好时坏,像开“盲盒”? 它有时能秒出惊艳代码,有时却生成一堆看似正确、实则隐藏 Bug 的“定时炸弹”?
  3. “修复”变“破坏”? 满怀希望让 AI 修改一个问题,结果它却“举一反三”地破坏了其他正常工作的代码,越改越糟心?
  4. 过程失控,结果难料? 感觉自己像在和 AI “摔跤”,而不是高效协作,项目进度和质量都难以把控?
  5. 雄心勃勃开始,灰头土脸放弃? 因为反复的挫败感和不确定性,最初那个让你兴奋不已的项目,最终停留在某个无法推进的节点,成了又一个“有缘再见”?


如果你对以上任何一点深有同感,那么问题很可能不在于 AI 能力不足,而在于我们缺少一套有效的“人机协同作战地图”和“AI 行为约束手册”。


这份文档,就是为解决这些痛点而生。它专为懂产品、懂需求,但编程经验相对有限,渴望利用 AI 独立完成产品开发的你(比如产品经理、设计师、运营人员或跨界学习者)量身定制。


它不教你高深的编程技巧,而是提供:

  1. 一套结构化的项目落地流程: 从想法验证到部署维护,步步为营。
  2. 一份核心的 AI 协作规范 (.cursor-guidelines.md): 给 AI “立规矩”,让合作更顺畅。
  3. 一系列即插即用的 Prompt 模板: 精准引导 AI,获取高质量输出。
  4. 一套面向新手的审查与测试心法: 即使代码看得不全懂,也能有效把控质量。

目标只有一个: 帮你更有章法、更有信心地驾驭 AI,让它真正成为你手中可靠的创造工具,而不是难以预测的“黑盒子”,从而实实在在地把你的产品想法落地!



文档使用说明

1、定位与背景:

(1)本文档旨在为利用 AI 进行编程协同、独立完成项目落地提供一套结构化的方法论与实践指引。

(2)自己有七年 B 端为主、兼具 C 端经验的产品经理背景,23- 24 年在前公司深度参与 AI+电商领域的项目实践。虽然在具体编码层面属于初学者,但对软件工程的生命周期、需求管理、以及各阶段的交付标准有深入理解。这份指南正是融合了产品管理的结构化思维与 AI 编程的初步实践经验,试图为与 AI 高效、可控地共创价值探索一条路径;

(3)在技术架构、数据库、部署等笔者过往实践较少的领域,本文档记录了借助 AI 探索并形成推荐方案的过程,希望能为背景类似的开发者提供借鉴。


2、实践基础:

(1)本指南的方法论已在 Cursor、Trae 等 AI 编程工具的辅助下,应用于两个微信小程序和一个 Web 应用的实践,并通过与 DeepSeek、Gemini 2.5 Pro、GPT-4 等先进模型的深度探讨进行了迭代完善;


3、使用建议:

(1)鉴于自己的背景,本文档及配套 Prompt 在需求工程(想法验证、MRD、PRD)阶段着墨较多,力求通过清晰的需求定义来弥补编码经验的不足,为 AI 提供高质量的输入。

(2)在技术实现层面,则更侧重于明确约束、引导 AI 基于最佳实践和新手友好原则提供解决方案及理由

(3)建议使用者根据自身的背景和具体项目需求,批判性地审视并调整本文档中的 Prompt 和流程细节。初期项目不妨直接采用以熟悉流程、建立“手感”,关键在于在实践中持续总结、迭代,形成最适合自己的 AI 协同模式


AI 编程感悟与原则


1、洞察 AI 边界,善用其能: 认识到 AI 在上下文理解、长程记忆上的局限性。关键在于通过结构化的文档(如 MRD->PRD->TDD 的依赖传递) 为其提供清晰、连贯的“记忆”和“指引”,最大化利用其在特定任务上的优势;

2、确立开发者主导地位: 始终铭记 AI 是助手而非决策者。开发者需扮演架构师、质检员和最终整合者的角色,对 AI 的输出进行严格的引导、审核与筛选。绝不盲从,保持批判性思维。

3、 精准沟通,赋能 AI: AI 的表现高度依赖于输入的质量。清晰、具体、上下文丰富的 Prompt 是获取高质量输出的前提。学会“对 AI 说人话,更要说内行话”。

4、 分而治之,降低复杂度: 将宏大目标拆解为 AI 更易于处理的、小而美的任务块,是控制风险、保证质量、实现快速迭代的有效策略。

5、 验证闭环,永不信任: AI 可能犯错,且错误有时极其隐蔽。理解、审查、多层次测试(单元、集成、手动) 是不可或缺的质量保证环节,形成“生成-验证-反馈-修正”的闭环。

6、 拥抱迭代,持续优化: 将 AI 的每次输出视为待完善的草稿。通过多轮提问、修正和共同探索,逐步逼近理想状态。耐心和迭代是 AI 协作的常态。

7、 巧用工具,放大效能: 深入学习并利用 Cursor 等先进 AI 编程工具的特性(代码感知、上下文注入、智能建议等),让工具与方法论相得益彰。

8、 保持敏锐,与 AI 共进化: AI 技术日新月异,保持对新工具、新能力的关注和学习,是持续提升 AI 协同效能的关键。


为了将这些原则系统性地融入日常开发,构建了 .cursor-guidelines.md 文件。它不仅是规则的集合,更是我们与 AI 建立高效、可靠协作关系的契约蓝本,是实现“让 AI 成为合格副驾驶”目标的核心支撑。



AI 编程协同项目落地



在理解了 AI 编程的基本原则之后,为了确保项目能够有序、高效地推进,我们需要在正式开始具体流程之前,先构建一个清晰、规范的基础框架;

基础框架包含了对应的项目文件组织结构,作为核心“规则书”的 .cursor-guidelines.md 文件的概览及其重要性,以及项目中各类关键文档的职责分工

明确框架的好比在动工前拥有了详细的建筑图纸和施工规范。它不仅能帮助我们(以及 AI)在后续的开发过程中保持方向一致、信息规整,更能显著提升 AI 协作的效率和准确性,为最终成功落地项目奠定坚实的基础;


your-project-repo/
├── .git/
├── .cursor-guidelines.md # (推荐) 项目编码规范 & AI 协作指南 (含 Prompt 建议)
├── docs/ # 【中心文档库】存放详细、深入、结构化的项目文档
│ ├── README.md # ** docs 目录的索引/目录页 ** (解释此目录下各文档内容和链接)
│ ├── PRD.md # 产品需求文档 (活文档, 包含功能ID、模块关联、状态、版本变更等)
│ ├── architecture/ # 存放整体架构设计文档与图表
│ │ ├── README.md # 架构部分概述/索引
│ │ ├── overview.md # 系统整体架构描述
│ │ ├── frontend.md # 前端总体设计
│ │ ├── backend.md # 后端总体设计
│ │ └── assets/ # (可选, 方式1a) 存放架构图等 *架构专用* 资源
│ │ └── backend_arch_v1.png
│ ├── setup_guide.md # 项目环境搭建指南 (详细版)
│ ├── deployment.md # 部署流程说明
│ └── assets/ # (推荐, 方式1b) 存放跨文档共享的图片、图表等 *通用* 资源
│ └── shared_component_diagram.png
├── src/ # 【源代码】
│ ├── features/ # 按功能/业务模块组织
│ │ ├── authentication/ # --- 认证模块 ---
│ │ │ ├── index.ts # 模块出口
│ │ │ ├── components/ # 模块相关组件
│ │ │ ├── services/ # 模块相关服务/逻辑
│ │ │ └── README.md # 【模块级文档】认证模块特定的技术笔记、实现要点 (就近原则)
│ │ │ └── images/ # (可选, 方式2) 模块特定图片存放处 (如果不用中央 assets)
│ │ │ └── auth_flow.png
│ │ ├── products/ # --- 产品模块 ---
│ │ │ ├── index.ts
│ │ │ ├── api/ # 后端 API 相关
│ │ │ ├── store/ # 前端状态相关
│ │ │ ├── _docs/ # (可选) 模块内更详细的文档子目录 (替代或补充 README.md)
│ │ │ │ └── api_design.md # 产品模块 API 设计细节
│ │ │ └── README.md # 产品模块概述、使用说明等
│ │ └── ... # 其他功能模块...
│ ├── core/ # 核心库、共享工具、通用服务等
│ │ └── utils/
│ └── main.ts # 应用主入口 (或 index.ts, app.ts 等)
└── README.md # 【项目根 README】项目简介、核心特性、快速启动指南、指向 docs/README.md 的链接等


关键说明:

.cursor-guidelines.md: 存放开发规范和 AI 协作规则,指导开发过程。
README.md (根目录): 项目的入口点,提供概览和快速启动信息。
docs/: 存放需要详细阐述的文档。docs/README.md 是该目录的导航页。
PRD.md: 放在 docs/ 中,作为持续更新的活文档,并包含与代码模块的关联信息。
模块级文档 (README.md 或 _docs/): 放在 src/features/ 下对应模块内,记录该模块特有的技术细节、决策或注意事项,方便 AI 在处理该模块代码时获取最相关的上下文。
图片/资源 (assets/ 或 images/):
推荐使用 docs/assets/ 存放跨文档共享的资源。
架构图等可以放在 docs/architecture/assets/ (方式 1a) 或通用的 docs/assets/ (方式 1b)。
如果图片仅被单一模块文档引用,可以放在该模块的 images/ 目录下 (方式 2)。你可以根据项目情况选择最适合的方式或混合使用。


1、项目结构设计理念:

  1. 中心化与就近化结合: 全局性文档(PRD、架构)存放于 docs/,便于宏观查阅;与特定代码模块紧密相关的技术笔记则放在 src/features/*/README.md,实现“文档随代码”,方便开发和 AI 理解局部上下文。
  2. 关注点分离:docs/ 存放“是什么”、“为什么设计”;src/ 存放“如何实现”;.cursor-guidelines.md 关注“如何协作”;根 README.md 负责“快速上手”。职责清晰。
  3. 可扩展性: 模块化的 src/features/ 结构便于未来功能的扩展和维护。


2、核心协作规范 (.cursor-guidelines.md 概述)

(1).cursor-guidelines.md 是本方法论的“灵魂”所在,它将前述的 AI 编程感悟转化为具体、可执行的操作指令和行为规范。它不是一份束之高阁的文档,而是需要 AI 和开发者在每一次交互、每一次代码生成、每一次文档更新中都参照执行的“契约”

(2)作为与 AI 协作的全局指导,可配置在 cursor 对应的规则里面,也可作为对应的每个项目初始文档建立,用于存放发规范和 AI 协作规则,指导开发过程。目前我测试下来,如果放在设置里面,貌似不会一直被引用。

(3)其核心价值体现在:

  1. 约束 AI 行为,提高可预测性: 通过明确 AI 的角色、沟通方式和工作流程,减少 AI 的“自由发挥”,使其行为更符合项目预期。
  2. 统一标准,保证质量与一致性: 无论是编码风格、错误处理,还是文档要求,统一的标准有助于 AI 生成更高质量、更一致的产出。
  3. 沉淀最佳实践,赋能开发者: 将与 AI 高效协作的模式、Prompt 技巧固化下来,帮助开发者(尤其是新手)快速掌握与 AI 共舞的要领。

(4).cursor-guidelines.md文档内容

## 1. 项目概述与 AI 角色

**项目目标:** [在此简要描述项目核心目标,例如:构建一个用于管理个人任务的 Web 应用]

**AI 角色定义:**
你是一位专业的编程助手,也是本项目主要开发者(用户)的积极主动的合作伙伴。你的职责是促进高效开发,确保高质量的代码和文档,并根据本项目的标准和目标来预见需求。请假定用户需要清晰的解释,并且可能在梳理思路或需求方面需要帮助。

**核心目标:**
协助开发者完成*本项目*开发的所有阶段,严格遵守本文档中定义的指南。优先考虑清晰性、简洁性(遵循 MVP 原则)、代码质量以及保持文档最新。始终保持积极主动的沟通,并确保开发者理解建议和行动背后的原因。

## 2. 通用交互原则

* **主动沟通:** 不要仅仅等待明确的指令。如果你发现潜在的问题、模糊之处或必要的后续步骤(例如更新文档),请主动提出。
* **清晰第一:** 用简单明了的中文解释你的推理过程、建议的解决方案以及潜在的利弊。避免不必要的术语。如果必须使用技术术语,请进行简要解释。
* **简化(MVP 焦点):** 在提出解决方案或编写代码时,始终倾向于能够有效满足核心需求的最简单方法。避免过早优化或不必要的复杂化。
* **提问:** 如果需求、上下文或指令不清晰或不完整,请在继续之前提出具体的澄清问题。
* **确认理解:** 在执行重要操作(例如大规模重构、实现复杂功能)之前,简要总结你的理解和计划,以确保与开发者保持一致。
* **语言:** 始终使用**中文**进行沟通。

## 3. 工作流程协议

### 3.1 任务启动与上下文收集

1. **先读上下文:** 在回应任何请求或开始任何任务之前,**务必**按以下顺序查阅相关的项目文档:
* 根目录的 `README.md` (了解整体项目背景)。
* 本 `.cursor-guidelines.md` 文件 (了解流程和标准)。
* `docs/` 目录下的相关部分 (例如 `docs/PRD.md`, `docs/architecture/`)。
* 如果任务涉及特定模块,查阅 `src/` 目录下对应的模块级 `README.md` 或 `_docs/`。
* 当前打开的文件和对话历史记录。
2. **识别缺失信息:** 如果文档或请求中缺少必要信息,请明确说明需要什么,并请求开发者澄清,或者建议创建/更新相关文档。

### 3.2 处理需求与功能请求

1. **澄清需求:** 确保完全理解需求。提出问题以解决模糊之处 (例如:“当您说‘用户资料’时,具体需要包含哪些字段?”)。
2. **分析影响:** 简要评估请求对现有代码库和架构的影响(参考相关文档)。
3. **提出简化方案:** 提出 1-3 个清晰、可行的实施选项,优先考虑简洁性和 MVP 原则。对每个选项,简要解释其方法、优缺点。推荐最简单、最合适的选项。
4. **确认方案:** 在开始实施之前,获得开发者对所选方案的明确确认。

### 3.3 编码与实现

1. **规划步骤:** 在编写重要代码前,简要列出实施步骤或将受影响的文件/模块。
2. **遵循编码规范与标准 (核心要求):**
* **始终应用通用原则:** 必须严格遵守本文档第 4 节定义的**通用编码原则**(例如:清晰性、简洁性、一致性、模块化、DRY 等)。这是最低要求。
* **检查并应用具体规范 (若已定义):** 在编码前,请检查本文档第 4 节是否**已经**为本项目定义了具体的:
* 编程语言及版本
* 代码格式化工具 (Formatter) 及其配置
* 代码检查工具 (Linter) 及其配置
* 详细的编码约定(如命名风格、错误处理方式等)
* 如果**已定义**,请**严格遵循**这些具体的规范。
* **使用配置好的工具:** 代码编写或修改完成后,**务必运行**项目中已配置的**代码格式化工具**和 **Linter 工具**(一旦它们在第 4 节中被指定并配置好),并修正它们报告的问题。
* **处理未定义的具体规范:** 如果第 4 节**尚未定义**某种具体的约定(例如特定语言的命名风格):
* 请默认采用该语言**社区广泛接受的最佳实践或通用约定**。
* 在您生成的或修改的代码块内部保持**风格一致性**。
* (可选,推荐) 您可以向开发者**提示**:“请注意,项目中尚未在 `.cursor-guidelines.md` 第 4 节明确规定 [具体方面,如 TypeScript 的接口命名风格],我暂时采用了社区通用实践。建议后续补充明确。”
3. **简洁与模块化:** 编写清晰、简洁、易于理解和维护的代码。将复杂逻辑分解为更小、功能单一、高内聚低耦合的单元(函数、类、模块等)。
4. **考虑测试:** 在编写功能代码时,应同步考虑其可测试性。如果适用,请生成或更新相关的单元测试、集成测试,并提及测试覆盖的关键场景。
5. **代码文档:**
* 为复杂的逻辑、算法或重要的设计决策添加清晰的**行内注释**或块注释,解释“**为什么**”这样写(即设计意图或权衡),而不仅仅是复述代码“**做了什么**”(除非代码本身的操作非常晦涩难懂)。
* 为所有公开的 API、函数、类、方法、重要类型或接口等添加符合项目约定(或社区标准,如 JSDoc/TSDoc,具体标准待第 4 节明确)的**文档注释** (Doc Comments),清晰说明其用途、参数(类型、含义)、返回值和可能抛出的异常。

### 3.4 调试与问题解决

1. **收集信息:** 请求必要的详细信息:确切的错误消息、相关的代码片段、重现问题的步骤、预期行为与实际行为。
2. **分析原因:** 解释你识别问题可能原因的推理过程,引用具体的代码行或逻辑。
3. **提出解决方案:** 提供清晰、有针对性的修复方案。解释*为什么*这个修复方案应该有效。
4. **迭代调整:** 准备好初步修复方案可能不完美的情况。根据开发者的反馈进行沟通,如有必要进行进一步分析,并完善解决方案。

### 3.5 任务完成与跟进

1. **总结工作:** 简要说明已完成的工作。
2. **文档检查/更新:** **极其重要**,评估所做更改是否需要更新文档。
* 提出具体的更新建议 (例如:“我们是否应该更新模块 X 的 `README.md`?”,“API 签名已更改,我们更新下相关的 API 文档/注释吧。”)。
* 如果开发者要求且可行,执行文档更新(更新后需经开发者审核)。
3. **记录考量:** 简要提及任何潜在的副作用、未来可改进的领域或现在可能相关的后续任务。

## 4. 编码标准与规范

### 4.1 核心原则

* **清晰性与可读性 (Clarity & Readability):**
* 代码首先是写给人看的,其次才是给机器执行的。努力让代码逻辑清晰、易于理解。
* 避免过于晦涩或“聪明”的代码技巧,除非有充分的理由和注释。
* **简洁性 (Simplicity - KISS Principle):**
* 保持简单,避免不必要的复杂性 (Keep It Simple, Stupid)。用最直接、最简单的方式解决问题。
* **一致性 (Consistency):**
* 一旦项目确定了具体的编码风格和规范(无论是什么),就应在整个项目中严格遵守,保持一致。
* **模块化 (Modularity):**
* 将代码分解为小的、功能单一的、可重用的单元(函数、类、模块等),降低耦合度。
* **不重复自己 (DRY - Don't Repeat Yourself):**
* 避免复制代码段。将重复的逻辑抽象成函数或可重用的组件/模块。

### 4.2 实践指南

* **有意义的命名 (Meaningful Naming):**
* 为变量、函数、类、文件等选择能够准确反映其意图的描述性名称。避免使用模糊或过于简短的缩写。
* **注释 (Commenting):**
* 注释应当解释代码“为什么”这样做(设计决策、复杂逻辑的原因),而不是简单复述代码“做了什么”。
* 对于公共 API、函数、类等,添加标准的文档注释(如 JSDoc/TSDoc 等,具体格式待定)。
* **错误处理 (Error Handling):**
* 必须考虑并实现健壮的错误处理机制。预见可能出错的地方,并进行恰当处理(记录日志、向用户反馈、优雅降级等)。具体策略待定。
* **避免魔法值/字符串 (Avoid Magic Values/Strings):**
* 将代码中直接使用的、含义不明的数字或字符串定义为有意义的具名常量。
* **配置与代码分离 (Configuration Separation):**
* 将应用程序的配置(如数据库连接字符串、API 密钥、功能开关等)与代码逻辑分开,通常放在配置文件或环境变量中。

## 5. 文档标准

* **主要信息来源:** 始终查阅根目录 `README.md`、`docs/README.md` (作为索引页)、`docs/` 子目录下的相关页面,以及模块级的 `README.md` / `_docs/`。
* **文档更新触发条件:** 在以下情况下**必须**考虑更新文档:
* 添加新功能。
* 显著改变现有功能的行为。
* 修改 API 签名(请求/响应)。
* 更改配置或环境变量。
* 重构核心逻辑,影响了其使用方式或理解。
* **文档更新职责:** 在代码更改后,**主动提出建议或执行**对所有相关文档(代码注释、模块 README、中心文档)的更新。
* **风格:** 使用 Markdown。保持语言清晰简洁。在有帮助的地方使用图表/图片(遵循项目的资源存储约定)。
* **链接:** 在适当时,在文档文件之间建立链接(例如 PRD 功能链接到架构图),并从代码注释链接到相关的文档部分。确保链接保持有效。


3、根 README.md生成对应的 prompt:

## 任务目标
为项目 "[请填写您的项目名称]" 生成一份结构完整、信息全面的根目录 `README.md` 文件。
**请注意:** 本文档是“活文档”,会随项目进展分阶段完善。初次生成时,请根据当前可用的信息填充,对尚不明确的部分可使用占位符或留空,并可在注释中提示用户后续补充。

## 参考信息
* **当前项目阶段:** [请选择或描述:项目初始化 / 初步开发 / 活跃开发 / 已发布]
* 项目名称: [请填写您的项目名称]
* 项目简介: [请用一两句话描述项目是做什么的,核心价值是什么 - 可参考 MRD/PRD]
* 核心功能: [列出已知的主要功能 - 可参考 PRD]
* 技术栈信息: [引导 AI 参考 `docs/architecture/tech_stack.md` 或相关 TDD 部分,总结已知的技术栈]
* 项目状态: [例如:构思中、开发中 (vX.Y)、已发布 vA.B]
* [其他当前阶段可用的信息,如仓库地址、部署地址等]

## 内容要求 (请生成包含以下章节的 Markdown 内容,按当前阶段填充)
1. **项目标题:** (H1 标题)
2. **徽章 (Badges):** (预留位置或添加基础占位符)
3. **项目简介:** (根据项目阶段和参考信息编写)
4. **核心功能列表:** (列出当前阶段明确的功能点,可标注状态)
5. **技术栈概览:** (列出已确定的技术,链接到详细文档)
6. **快速开始 (Quick Start):**
* **环境要求:** (列出当前已知的必要依赖)
* **安装:** (提供当前有效的安装命令)
* **本地运行 (开发模式):** (提供当前有效的运行命令)
* **运行测试 (如果适用):** (提供当前有效的测试命令,如果已有)
7. **文档:** (提供指向 `docs/README.md` 或 `docs/index.md` 的链接)
8. **部署:** (根据当前阶段提供信息:占位符、链接到 `docs/deployment.md`、或实际部署地址)
9. **贡献指南 (可选):** (根据项目阶段添加占位符或基本说明)
10. **许可证 (License):** (说明项目许可证)

## 交互要求
* **阶段适应性:** 根据指定的“当前项目阶段”,智能判断各部分内容的详略程度,合理使用占位符。
* **结构完整:** 即使内容不全,也要保持 README 的标准结构。
* **遵守指南:** 在生成过程中,请严格遵守项目根目录下 `.cursor-guidelines.md` 文件中定义的**通用交互原则**。
* **语言:** 使用中文输出。

---


(1)目标读者:
  1. 任何人(包括未来的你、潜在的协作者、甚至 AI 快速了解项目)


(2)内容:项目的入口和门面。
  1. 包含:项目标题、一句话简介、核心功能列表、如何快速启动和运行项目 (Quick Start)、项目状态、指向 docs/ 目录的链接以获取更详细信息、贡献指南(如果开源)、许可证。
  2. 特点: 简洁、引导性强,侧重于“是什么”和“怎么跑起来”。


(3)不同阶段 readme 文档通常需要包含、补充或修正的内容:
  1. 阶段 0:项目初始化 (仓库创建,仅有 "Hello World" 或项目骨架)
  2. 此时状态: 刚刚创建项目,代码非常基础,甚至只有一个空框架。
  3. README 内容 (创建基础版):
  4. 项目标题: (必须) 明确的项目名称。
  5. 一句话简介: (必须) 用一句话说明这个项目的核心想法或目标(可以非常初步)。
  6. 状态说明: (推荐) 标注项目当前状态,如 "孵化中"、"规划中"。
  7. 基础设置/运行指令 (如果可能): (必须,即使很简单)
  8. 如何克隆仓库 (git clone ...)。
  9. 安装最基本依赖的命令(如果有,如 npm install)。
  10. 运行这个 "Hello World" 或骨架的命令(如有,如 npm run dev)。
  11. 许可证 (License): (推荐) 预留位置或指定一个(如 MIT)。
  12. 目的: 建立项目的基本标识,提供能让开发者(包括您自己)克隆并验证项目初始状态的最基本指令。
  13. 阶段 1:初步开发阶段 (MRD/PRD 初稿完成,基础代码结构搭建,核心模块开始开发)
  14. 此时状态: 对要做什么有了更清晰的认识 (MRD/PRD),代码结构开始形成,确定了主要技术栈。
  15. README 内容 (补充和修正):
  16. 完善简介: (修正) 根据 MRD/PRD 的内容,让项目简介更准确、更有吸引力。
  17. 核心功能列表 (高级别): (补充) 从 PRD 中提取 V1.0 的主要功能点,简要列出。
  18. 技术栈概览: (补充) 简要列出已确定的主要技术(语言、框架、数据库/BaaS、部署平台等),可以链接到 docs/architecture/tech_stack.md(如果该文档已开始编写)。
  19. 详细的本地开发设置: (修正/补充) 提供更完整的安装依赖、配置环境(如 .env 文件说明)、运行开发服务器、访问应用的方式等指令。
  20. 文档链接: (补充) 添加指向 docs/ 目录(或 docs/README.md)的链接,引导查阅详细文档。
  21. 贡献指南 (占位): (补充) 可以先创建一个标题,表示未来会添加贡献说明。
  22. 目的: 提供更丰富的项目背景信息,指导开发者配置好本地开发环境,了解项目的主要构成和目标。
  23. 阶段 2:活跃开发阶段 (MVP 核心功能开发中或接近完成)
  24. 此时状态: 大部分核心功能已经实现,项目结构稳定,测试和部署开始提上日程。
  25. README 内容 (补充和修正):
  26. 更新功能列表: (修正) 标记各功能的状态(如 已完成、开发中)。
  27. 添加测试指令: (补充) 如何运行单元测试、集成测试等。
  28. 添加部署信息: (补充) 简要说明如何部署,或者提供指向 Vercel/Netlify 项目地址或 docs/deployment.md 的链接。
  29. 更新或确认技术栈: (修正) 如果开发过程中技术选型有微调,及时更新。
  30. 完善贡献指南 (如果需要): (补充) 如果希望他人参与,可以开始添加具体的贡献流程、代码风格要求等。
  31. 目的: 反映项目当前的开发进度,提供测试和初步部署的信息,为可能的协作打下基础。
  32. 阶段 3:发布后或持续维护阶段 (MVP 发布或后续版本迭代)
  33. 此时状态: 项目已有可交付的版本,或进入长期维护和迭代。
  34. README 内容 (补充和修正):
  35. 添加版本信息: (补充) 标注当前的稳定版本号。
  36. 更新功能列表: (修正) 突出当前版本的主要特性。
  37. 截图/Demo (可选): (补充) 加入少量截图或 GIF/视频演示链接,让用户更直观地了解产品。
  38. 最终确认部署链接: (修正) 提供准确的线上访问地址。
  39. 确保所有链接有效: (修正) 检查文档、贡献、许可证等链接是否都正确。
  40. 更新快速启动 (如果需要): (修正) 确保快速启动指令对最终用户或新加入的开发者仍然有效。
  41. 目的: 作为产品/项目的正式介绍页面,服务于最终用户和新的贡献者,提供最准确、最新的信息。


(4)用户与 AI 的互动方式:
  1. 初始创建 (阶段 0): 用户提供项目名和初步想法,使用 README Prompt,AI 会生成一个包含标题、初步简介、基础运行指令(如果 AI 能推断或用户提供)以及大量占位符的初版 README。
  2. 后续更新 (阶段 1-3): 随着项目进展,用户主动发起对 README 的更新请求,例如:
  3. “请帮我更新 README.md 中的‘核心功能列表’,根据 docs/PRD_v1_draft.md 中 v1.0 的范围来写。”
  4. “我们确定了技术栈,请更新 README.md 的‘技术栈概览’部分,内容参考 docs/architecture/tech_stack.md。”
  5. “请在 README.md 中添加‘运行测试’的指令:npm run test。”
  6. “项目 v1.0 发布了,请在 README.md 开头添加版本号信息,并更新部署链接为 [新链接]。”


4、不同文档差异

文件/目录 (File/Folder)

主要目的 (Primary Purpose)

关键内容/示例 (Key Contents/Examples)

主要读者 (Primary Audience)

README.md (根目录)

项目入口与概览:提供项目基本信息和快速启动指南。

项目名称/简介、核心特性、如何安装/运行/测试 (Quick Start)、技术栈概览(可选)、指向 docs/ 的链接、贡献指南、许可证。

任何人(开发者、用户、AI 初次接触)

.cursor-guidelines.md

开发流程与 AI 协作规范:定义如何在本 K 项目中进行开发和协作。

AI 角色定义、交互原则、工作流程协议(需求/编码/调试/文档)、通用编码原则、文档标准、(可引用 docs/architecture/ 中的具体技术规范)。

开发者、AI

docs/ (目录)

项目详细文档库:存放所有深入、结构化、持久化的项目文档。

PRD、架构设计、部署指南、配置说明、深度教程、API 设计原则等。

开发者、项目经理、运维、AI(深入了解时)

docs/README.md (或 index.md)

文档库索引/目录:作为 docs/ 目录的导航页,方便查找。

docs/ 内主要文档的列表、简要说明和链接。

开发者、项目经理、运维、AI

docs/PRD.md

产品需求定义:详细描述“产品做什么”,包括功能、用户故事等。

项目目标、用户画像、功能详述(含 Feature ID、状态)、用户流程图、验收标准、非功能需求、版本变更历史。

产品经理、开发者、测试、AI

docs/architecture/ (目录)

系统架构与技术设计:描述系统“如何构建”,包括结构和技术选型。

架构图、组件说明、技术栈选型详情 (语言/框架/数据库)、数据模型定义、API 设计原则、关键技术决策记录 (ADR)。

开发者、架构师、运维、AI

docs/architecture/tech_stack.md (示例)

技术栈选型详情(可选独立文件):集中记录使用的技术和版本。

主要语言、框架、数据库、缓存、消息队列、关键库及其版本号和选择理由。

开发者、架构师、运维、AI

docs/setup_guide.md

详细环境搭建指南:指导如何从零配置可运行的开发环境。

系统依赖列表、环境变量设置、数据库初始化脚本、特殊工具安装与配置步骤。

新开发者、运维

docs/deployment.md

部署流程说明:描述如何将应用发布到生产或其他环境。

构建命令、部署脚本用法、服务器要求与配置、CI/CD 流水线解释、回滚策略。

开发者、运维

src/ (目录)

源代码实现:包含项目所有可执行逻辑和核心代码。

按功能模块 (features/)、核心库 (core/)、工具函数 (utils/) 组织的代码文件、主入口文件。

开发者、AI(代码分析/生成时)

src/.../README.md 或 _docs/

模块级技术文档:记录特定代码模块内部的设计、实现要点或笔记。

模块职责说明、复杂算法/逻辑解释、模块内部特定配置、内部接口说明、使用示例、开发者遇到的坑或技巧 (与该模块代码紧密相关)。

维护该模块的开发者、AI(处理该模块时)



AI 编程协同落地流程



接下来,我们将详细拆解一个借助 AI 进行协同的、从想法到产品落地并持续迭代的完整流程。

对应的包含了以下八个关键开发阶段:1. 想法验证与初步构思,2. 需求定义 (MRD),3. 产品设计与规格定义 (PRD),4. 技术设计与规划 (TDD),5. 开发与迭代,6. 测试与质量保证,7. 部署,以及 8. 维护与迭代。



1、想法验证与初步构思 (Idea Validation & Brainstorming):

(1)目标 (Goal): 将脑海中模糊的、可能仅有点状的初始想法,通过结构化的提问与探讨,进行初步的可行性验证、核心价值挖掘和概念澄清,为后续更严肃的需求定义(MRD)降低方向性风险奠定认知基础

(2)核心输入 (Input): 开发者脑海中的原始 Idea(可能只是一句话或一个模糊的概念)。

(3)关键活动与 AI 协作 (Key Activities & AI Collaboration):

  1. 此阶段 AI 的角色是**“产品壁打ち伙伴” (Sparring Partner) 和“初级市场分析师”**。
  2. 使用下方的 “想法验证 Prompt” 启动与 AI 的对话。
  3. 通过 AI 的引导性提问,深入挖掘想法背后的核心问题,探索潜在的目标用户及其痛点,构思使用场景,并尝试提炼核心价值主张
  4. 利用 AI 的知识库进行初步的市场扫描,了解是否存在明显竞品或替代方案。
  5. 引导性地思考简化方案与 MVP (最小可行产品) 的可能性。
  6. 整个过程强调开放性发散性,但也需 AI 协助聚焦,避免漫无边际。请始终参照 .cursor-guidelines.md 中的通用交互原则与 AI 沟通。

(4)主要产出与流向 (Output & Flow):

  1. 产出形式通常是非正式的笔记、备忘录、或是对话记录总结,内容包含:初步澄清的核心概念、粗略的用户画像、明确的核心问题与价值主张、关键使用场景、MVP 构想、初步风险识别等。
  2. 这些产出物将作为下一阶段撰写 MRD 的关键素材和输入

(5)核心 Prompt:

# 请求:想法验证与初步构思助力 (MRD 准备阶段)

## 我的初步想法
[请在此处尽可能清晰地描述您脑海中的那个初始想法,哪怕只有一两句话。例如:“我想做一个能自动记录会议并生成摘要的应用。” 或者 “一个能帮我找到附近最佳咖啡馆的工具。”]

## 任务目标
请扮演一个经验丰富的产品顾问和市场分析师的角色,帮助我(一个想法尚不成熟的个人开发者)对上述初步想法进行验证、澄清和拓展。目标是探索这个想法的可行性、明确核心价值,并为后续撰写更正式的市场需求文档 (MRD) 做好准备。

## 请与我进行以下方面的探讨与互动:
1. **想法澄清与挖掘:**
* 针对我的想法,提出深入的问题,帮助我更清晰地阐述它的核心概念。(例如:“您能详细说明一下‘自动记录’是指什么吗?”“‘最佳’咖啡馆是按什么标准定义的?”)
* 这个想法主要想解决什么**一个**核心问题?(尝试聚焦)
2. **目标用户探索:**
* 引导我思考:谁最可能从这个想法中受益?他们有什么特征?(例如:“您设想谁会最常用这个会议摘要应用?是管理者、普通员工还是学生?”)
* 尝试一起勾勒出 1-2 个非常粗略的用户画像或用户类型描述。
* 这些潜在用户目前是如何解决这个问题的?现有方案有什么不足?(激发思考差异化)
3. **问题与价值定位:**
* 深入探讨这个“问题”对潜在用户的痛点程度如何?是“维生素”(有了更好)还是“止痛药”(必需品)?
* 帮助我提炼这个想法的核心价值主张:它能带来什么独特的、关键的好处?(用一句话概括)
4. **使用场景构思:**
* 一起设想几个用户会实际使用这个产品的具体场景或故事。(例如:“想象一下,小明开完一个重要的客户会议后,会如何使用这个摘要应用?”)
* 在这些场景中,用户最核心的操作会是什么?
5. **初步市场/可行性扫描 (利用 AI 知识):**
* 基于您的知识库,是否存在非常类似或直接竞争的产品/概念?它们做得怎么样?(提供参考信息)
* 从技术或资源角度看,这个想法的初步可行性如何?(进行非常初步的、非深入的技术可行性判断)
6. **简化与 MVP 思考:**
* 这个想法中最核心、最不可或缺的功能是什么?如果只能做一个功能来验证市场反应,应该是什么?
* 如何将这个想法简化成一个最小可行产品 (MVP) 的概念?需要哪些最基础的元素?
7. **总结与后续步骤:**
* 总结我们讨论的关键点、明确下来的核心概念、潜在的用户群和价值主张,以及初步识别的风险或挑战。
* 根据讨论结果,建议下一步是基于这些讨论内容着手准备 MRD 草稿,还是需要针对特定方面(如用户调研、竞品分析)做进一步的独立思考或信息搜集?

## 交互要求
* **引导与启发:** 请以提问和引导为主,鼓励我发散思考,同时帮助我聚焦核心问题。避免直接给出“正确答案”。
* **积极与支持:** 在这个非常早期的想法萌芽阶段,请保持积极和支持的态度,营造一个开放的讨论氛围。
* **遵守指南:** 请遵循项目 `.cursor-guidelines.md` 中定义的通用交互原则(清晰、简化、主动、中文沟通)。


2、需求定义 (MRD市场需求文档):

(1)目标 (Goal): 基于第一阶段验证和构思的成果,系统性地梳理和定义产品的市场定位、目标用户、核心价值、高阶功能范围及成功标准,形成一份结构化的 MRD 文档,作为产品后续设计的战略输入和边界约束

(2)核心输入 (Input): 阶段一产出的想法备忘录、用户画像草稿、初步分析等。

(3)关键活动与 AI 协作 (Key Activities & AI Collaboration):

  1. AI 角色转变为**“文档助理”和“结构化思考辅助”**。
  2. 使用下方的 “MRD Prompt (v2.0)”,将阶段一的关键信息作为输入,让 AI 生成 MRD 文档的结构化初稿
  3. 针对 AI 生成的初稿,进行审阅和迭代:利用 AI 进一步澄清目标、细化用户描述、提炼价值主张、评估高阶功能的合理性与优先级。可以提出如:“针对这个目标用户,还有哪些潜在需求我们没考虑到?” 或 “这个高阶功能是否真正服务于核心价值主张?”等问题。
  4. (可选质量增强步骤) 如您在文档说明中提到,可以将 AI (如 Cursor) 生成的 MRD 初稿,输入到其他大模型(如 Gemini, GPT, DeepSeek)中,请求它们扮演“评审专家”的角色,提出改进意见或潜在盲点。将这些反馈整合后,再返回给 Cursor 进行最终的文档完善。
  5. 全程交互需遵循 .cursor-guidelines.md 规范。

(4)主要产出与流向 (Output & Flow):

  1. 产出物是一份结构化的 MRD 文档(建议保存为 docs/MRD.md)。
  2. 这份文档明确了“为什么做”和“做给谁”,为下一阶段 PRD 的“做什么”提供了清晰的方向和基础

(5)核心 Prompt:

## 任务目标
为项目 "[请填写您的项目名称]" 生成一份结构完整、内容充实的市场需求文档 (MRD) 的初稿,文件保存至 `docs/MRD_v1_draft.md`。

## 参考信息
* **核心输入:** [请在此处尽可能详细地描述您的项目初始想法、期望解决的问题、您能想到的目标用户等。如果已有笔记或零散想法,请一并粘贴。]
* 请同时参考项目根目录的 `README.md` (如果已存在)。

## 内容要求 (请AI主动分析并填充以下章节)
1. **项目目标与愿景:** 基于我的初步想法,提炼并清晰阐述项目希望达成的核心目标和长期愿景。
2. **目标用户画像:** 分析并详细描述 1-2 类最核心的目标用户群体:他们的特征、典型场景、使用动机、以及当前面临的主要痛点。
3. **核心问题与价值主张:** 明确本项目旨在解决用户的哪几个**关键**问题,并提炼出独特且有吸引力的核心价值主张。
4. **市场机会与竞争分析 (AI辅助):**
* 请进行初步的市场调研(利用你的知识库),分析该领域可能存在的市场机会或趋势。
* 识别 1-3 个潜在的主要竞争对手或替代方案,并简要分析它们的优劣势。
5. **高阶功能列表 (概念性):** 基于目标和价值主张,建议 3-7 个实现 MVP (最小可行产品) 所需的**高阶**功能模块或核心用户旅程。
6. **成功衡量指标 (建议):** 建议 2-4 个可以初步衡量产品是否成功的关键指标 (Key Metrics),并说明理由。

## 交互要求
* **主动性:** 请充分发挥你的分析能力,不仅是整理信息,更要提出见解、建议和追问。如果我的初始想法模糊或矛盾,请明确指出并引导我思考澄清。
* **遵守指南:** 在生成过程中,请严格遵守项目根目录下 `.cursor-guidelines.md` 文件中定义的**通用交互原则**和**文档标准**。
* **聚焦:** 保持内容聚焦于市场和用户需求层面,避免过早深入产品细节。
* **语言:** 使用中文输出。

---


3、产品设计与规格定义 (PRD产品需求文档):

(1)目标 (Goal):

将 MRD 中定义的高阶需求和目标,转化为具体、详细、可执行的产品功能规格说明。PRD 是开发团队(包括 AI)理解“要做什么”以及“如何算完成”的核心依据,并包含初步的版本规划和迭代蓝图

(2)核心输入 (Input):

已定稿或基本稳定的 MRD 文档 (docs/MRD.md)。可能的界面草图或交互想法笔记。

(3)关键活动与 AI 协作 (Key Activities & AI Collaboration):

  1. AI 角色类似于**“初级产品经理”或“需求分析师”**。
  2. 使用下方的 “PRD Prompt (v2.0)”,以 MRD 为核心输入,引导 AI 生成包含版本规划、用户故事、验收标准等的 PRD 初稿。
  3. 重点与 AI 协作细化功能:将 MRD 的高阶功能分解为具体的 User Stories;为每个 Story 编写清晰的描述和可测试的 Acceptance Criteria (AC)。可以反复提问:“这个 AC 是否足够具体?能否覆盖所有主要场景?”
  4. 与 AI 共同规划版本和迭代:讨论 MVP 范围的合理性,梳理功能的依赖关系和优先级,形成初步的 Roadmap。
  5. 如果需要,可以让 AI 辅助构思用户流程描述界面布局(基于文本描述)。
  6. 交互需遵循 .cursor-guidelines.md 规范。

(4)主要产出与流向 (Output & Flow):

  1. 产出物是PRD 文档(建议保存为 docs/PRD.md,并持续维护为活文档)。
  2. PRD 是连接需求与实现的关键桥梁,直接指导下一阶段的技术设计 (TDD) 和后续的开发与迭代 (Stage 5)


(5)三方 AI 完善校验,反向补充
  1. 可以使用 gemini、gpt、deepseek 等工具,把对应的文档输入,让他提出改进意见;
  2. 根据改进意见完善后再补充到 cursor 文档告知cursor;

(6)核心 Prompt:

## 任务目标
为项目生成一份包含版本规划的产品需求文档 (PRD) 的初稿,文件保存至 `docs/PRD_v1_draft.md`。

## 参考信息
* **核心输入:** 项目的 MRD 文件 (`docs/MRD_v1_draft.md` 或最终版)。请**务必**基于 MRD 中的目标、用户、高阶功能进行展开。
* 参考项目根目录的 `README.md` (如果存在)。
* [在此处或引导 AI 查阅任何关于界面草图、交互想法的笔记或图片]

## 内容要求 (请AI主动规划并填充以下章节)
1. **修订历史:** (创建基础格式)
2. **概述:** (从 MRD 引入项目目标、核心价值、目标用户)
3. **版本规划与迭代路线图 (Roadmap):**
* **MVP (v1.0) 范围定义:** 根据 MRD 和 MVP 原则,明确建议哪些核心功能/用户故事应包含在第一个可发布版本 (v1.0) 中。
* **后续版本设想 (v1.1 / v2.0):** 初步设想 v1.0 之后可能迭代的功能方向或主题。
* **迭代路线图建议:** 尝试将 v1.0 的功能需求分解为 2-4 个逻辑开发阶段(或 Sprint),说明每个阶段的核心目标。
4. **功能需求详述 (聚焦 v1.0):**
* **针对 v1.0 范围内的每个核心功能/用户故事:**
* 编写详细的功能描述。
* (如果 MRD 中已有高阶功能,请细化) 编写具体的用户故事 (User Stories),遵循 "作为一个 [角色], 我想要 [完成某个动作], 以便 [获得某种价值]" 的格式。
* 为每个用户故事编写清晰、可测试的验收标准 (Acceptance Criteria)。
5. **用户流程 (核心流程):** 选择 v1.0 中的 1-2 个关键用户流程(如注册登录、核心任务流),使用文字或简单的步骤列表描述其主要交互路径。
6. **非功能性需求 (初步):** 提及 v1.0 需要考虑的基本非功能性需求(如易用性、基本的安全性考虑)。

## 交互要求
* **主动规划:** 在版本规划和路线图部分,请展现产品规划的思路,提出合理的建议和分期方式。
* **遵守指南:** 在生成过程中,请严格遵守项目根目录下 `.cursor-guidelines.md` 文件中定义的**通用交互原则**和**文档标准**。
* **聚焦 v1.0:** 功能详述部分应主要围绕第一个版本 (MVP) 展开。
* **语言:** 使用中文输出。

---


4、技术设计与规划 (TDD文档):


(1)目标 (Goal): 基于 PRD 定义的产品需求,以及开发者(您)的背景和偏好,设计系统的技术实现方案。核心是进行对新手友好的技术选型(语言、框架、数据库/BaaS、部署平台等),并勾勒出初步的系统架构,为后续编码提供清晰的“施工图”。

(2)核心输入 (Input): PRD 文档 (docs/PRD.md),开发者背景描述(新手、运维经验少等),明确的技术偏好或限制(如有)。

(3)关键活动与 AI 协作 (Key Activities & AI Collaboration):

  1. AI 角色转变为**“技术顾问”或“初级架构师”,特别需要具备“同理心”**,理解新手开发者的痛点。
  2. 使用下方的 “TDD Prompt (v2.1)”,清晰告知 AI 所有背景信息和需求,引导其推荐技术方案。
  3. 重点关注 AI 对 BaaS 和 Vercel/Netlify 等简化方案的推荐理由及权衡分析。针对这些推荐进行深入提问:“Supabase 的免费额度够用吗?” “如果未来用户量增长,从 Vercel 迁移会困难吗?” “这个 BaaS 能满足 PRD 里 XX 功能对实时性的要求吗?”
  4. 让 AI 辅助生成初步的数据模型草稿(例如,基于 BaaS 的表结构建议)或API 设计思路(如果需要)。
  5. 与 AI 共同绘制或描述一个简洁的架构图/说明
  6. 开发者基于 AI 的建议和解释,结合自己的理解和偏好,做出最终的技术选型决策。交互需遵循 .cursor-guidelines.md。

(4)主要产出与流向 (Output & Flow):

  1. 产出物是技术设计相关的文档,建议存放在 docs/architecture/ 目录下,可能包括 overview.md, tech_stack.md 等。
  2. 这份技术蓝图将直接指导下一阶段的开发与迭代 (Stage 5),包括代码结构创建、库的选择与使用等。

(5)核心 Prompt:

## 任务目标
为项目的技术设计文档 (TDD) 生成核心部分初稿,特别是技术选型和部署策略,建议添加到 `docs/architecture/` 目录下 (例如 `overview_draft.md` 或 `tech_stack_draft.md`)。

## 背景与约束
* **核心输入:** 项目的 PRD 文件 (`docs/PRD_v1_draft.md` 或最终版)。请根据其功能需求、用户量预期(如有)和非功能性需求进行技术选型。
* **开发者背景:** 请特别注意,本项目的开发者是**个人开发者,编程经验有限,尤其不熟悉复杂的服务器运维、数据库管理和后端部署**。因此,技术选型应**优先考虑易用性、低运维成本和快速部署**的方案。
* [在此处提及任何已知的技术偏好或限制,例如“希望使用 JavaScript 技术栈”]

## 内容要求 (请AI推荐并解释以下内容)
1. **技术栈核心建议 (考虑新手友好):**
* **主要编程语言/框架:** 基于 PRD 和开发者背景,推荐合适且学习曲线相对平缓的主要语言和前后端框架 (如 Next.js/Nuxt.js/SvelteKit 等全栈框架,或 Vercel 支持良好的组合)。说明选择理由。
* **数据库与后端 (BaaS 优先):**
* **强烈建议**评估并推荐使用 BaaS (Backend-as-a-Service) 平台,如 **Supabase**, Firebase, Appwrite 等。
* 解释为什么 BaaS 适合本项目(例如:提供托管数据库、用户认证、文件存储、实时 API 等,极大降低后端开发和运维复杂度)。
* 如果选择了 BaaS,简述其核心功能如何满足 PRD 中的主要需求。
* (备选) 如果 BaaS 不完全适用,推荐最简单的数据库方案(如 SQLite 文件数据库,或云数据库的免费/低配版),并说明如何简化管理。
* **代码格式化与检查工具建议:** 为推荐的语言建议主流的格式化工具 (Formatter) 和代码检查工具 (Linter),**并简要说明它们的核心价值(例如:如何帮助统一代码风格、预防常见错误)及推荐的标准配置。** *(<- 此处已修改)*
2. **部署策略建议 (一键式部署优先):**
* **强烈建议**评估并推荐使用简化部署的平台,如 **Vercel**, Netlify,或者其他类似的 PaaS/Serverless 平台。
* 解释为什么这些平台适合本项目(例如:与 Git 集成良好、自动构建部署、免费额度、无需管理服务器)。
* 简述基本的部署流程(例如:连接 Git 仓库 -> 配置构建命令 -> 自动部署)。
3. **架构概述 (草图或描述):** 基于以上选型,用简单的文字描述或列表形式,勾勒出系统主要组成部分(如前端应用、BaaS 服务、部署平台)及其基本交互关系。
4. **选型权衡 (简要):** 简要提及使用 BaaS 和 Vercel/Netlify 等简化方案可能带来的好处(开发快、运维少)和潜在的限制(平台锁定、复杂场景下的灵活性、成本模型等)。

## 交互要求
* **同理心:** 充分考虑开发者是新手的痛点,推荐的方案必须以**易于上手和维护**为首要标准。
* **解释充分:** 对于推荐的每一项技术或平台(尤其是 BaaS 和 Vercel/Netlify),都要清晰解释其优势和适用原因。**对于工具的推荐,也要简述其核心价值。** *(<- 此处对应修改)*
* **遵守指南:** 在生成过程中,请严格遵守项目根目录下 `.cursor-guidelines.md` 文件中定义的**通用交互原则**。
* **语言:** 使用中文输出。

---


5、开发与迭代 (AI 编程核心环节):


(1)目标 (Goal): 基于 PRD 和 TDD,将产品功能通过编写代码的方式逐步实现出来,产出可工作、符合质量要求的软件。这是 AI 编程工具发挥核心价值的阶段。

(2)核心输入 (Input): PRD 文档 (docs/PRD.md),TDD/架构文档 (docs/architecture/*),模块级文档 (src/.../README.md),.cursor-guidelines.md。

(3)关键活动与 AI 协作 (Key Activities & AI Collaboration):

  1. AI 角色是**“编码助手”、“代码审查员(初级)”、“调试伙伴”**。
  2. 遵循“小步快跑”原则: 将 PRD 中的用户故事或功能点拆分为更小的编码任务。
  3. 使用精确指令与上下文: 向 AI (如 Cursor) 发出具体的编码请求,明确功能、输入输出、依赖关系,并利用工具特性(如选中代码、@文件)提供充足上下文。
  4. AI 生成代码: 让 AI 生成函数、类、组件、配置文件、甚至基础的模块骨架代码。
  5. 开发者审查与验证 (核心环节 - 新手策略):
  6. 绝不直接复制代码!
  7. 利用 AI 解释: 要求 AI 逐段、逐行解释代码逻辑和意图。
  8. 聚焦行为测试: 编写(或让 AI 生成并解释)单元测试用例,重点理解测试场景是否覆盖需求,然后运行测试验证代码行为。
  9. 手动调试与验证: 运行程序,手动操作,结合 console.log 或调试器(可让 AI 辅助使用)观察执行流程和变量值。
  10. 利用工具: 运行 Linter/Formatter 检查代码规范和基础错误。
  11. 对比学习: 让 AI 提供相关库/函数的官方文档链接,对比示例代码。
  12. 逻辑审查: 从 PRD 需求出发,在高层次上判断代码逻辑是否合理。
  13. AI 辅助重构与优化: 对于已有的或 AI 生成的初步代码,让 AI 辅助进行重构以提高可读性、性能(需谨慎评估建议)或应用特定设计模式。
  14. AI 辅助调试: 遇到 Bug 时,将错误信息、相关代码片段提供给 AI,请求分析原因和修复建议。
  15. 创建/更新模块文档: 在开发过程中,及时在对应模块的 README.md 或 _docs/ 中记录重要的设计决策、复杂逻辑解释或注意事项。可让 AI 辅助生成初稿。
  16. 版本控制: 每次完成一个小功能或重要修改后,使用 Git 提交代码。
  17. 全程遵循 .cursor-guidelines.md 第 3.3 节“编码与实现”的详细规范。

(4)主要产出与流向 (Output & Flow):

  1. 产出物是位于 src/ 目录下的可工作的源代码、相关的单元测试代码、以及更新后的模块级文档
  2. 开发完成的功能模块将进入下一阶段的测试与质量保证 (Stage 6)

(注:此阶段没有单一的核心 Prompt,而是根据具体任务(生成、重构、调试、解释、测试等)使用不同的、具体的指令与 AI 交互。)


6、测试与质量保证 (Testing & QA):

(1)目标 (Goal):

系统性地验证已开发的功能是否符合 PRD 定义的需求和验收标准,确保软件质量,发现并报告 Bug,为最终部署发布提供信心。

(2)核心输入 (Input):

开发完成的功能代码 (src/),PRD 文档 (docs/PRD.md,特别是验收标准),TDD/架构文档(了解组件交互)。

(3)关键活动与 AI 协作 (Key Activities & AI Collaboration):

  1. AI 角色是**“测试用例设计师”、“测试代码生成器”、“初步缺陷分析师”**。
  2. 执行已有测试: 运行开发阶段编写的单元测试和集成测试。
  3. AI 辅助生成测试用例:
  4. 基于 PRD 验收标准或代码逻辑,让 AI 建议更全面的测试场景(包括正常、异常、边界情况)。
  5. 让 AI 将这些场景转化为具体的单元测试代码 (使用 Jest, Pytest 等) 或集成测试/端到端测试的步骤大纲或代码框架 (使用 Cypress, Playwright, Supertest 等)。参考之前提供的“AI 辅助测试”的 Prompt 示例。
  6. AI 辅助生成测试数据: 让 AI 根据需要生成符合特定格式的 Mock 数据或测试账户。
  7. 开发者手动探索性测试: 模拟真实用户场景,进行全面的手动测试,特别关注用户体验、易用性和 PRD 未明确覆盖的边缘情况。这是 AI 难以替代的关键环节。
  8. Bug 管理: 发现 Bug 后,记录清晰的 Bug报告(问题描述、复现步骤、预期与实际结果)。
  9. AI 辅助 Bug 分析: 对于难以定位的 Bug,可以将 Bug 报告信息和相关代码提供给 AI,请求初步的原因分析或调试方向建议。
  10. 交互需遵循 .cursor-guidelines.md 规范。

(4)主要产出与流向 (Output & Flow):

  1. 产出物是测试报告(或测试执行结果)、Bug 列表
  2. 发现的 Bug 需要返回到开发与迭代 (Stage 5) 进行修复,形成“开发-测试”的循环。
  3. 当主要功能通过测试,达到发布标准后,流程进入下一阶段部署 (Stage 7)

(注:此阶段同样是使用多种具体 Prompt 与 AI 交互,辅助测试用例设计、代码生成和问题分析。)


7、部署 (Deployment):

(1)目标 (Goal): 将通过测试的应用程序代码,安全、可靠地发布到目标环境(如 Vercel, Netlify, 或其他平台),让最终用户可以访问。

(2)核心输入 (Input): 经过测试的稳定代码 (src/),TDD 中确定的部署策略和平台 (docs/architecture/*),可能的配置文件或环境变量。

(3)关键活动与 AI 协作 (Key Activities & AI Collaboration):

  1. AI 角色是**“部署配置助手”、“脚本生成器”**。
  2. 根据 TDD 策略进行配置: 参照 TDD 中推荐的部署平台(如 Vercel, Netlify)和流程进行操作。
  3. AI 辅助生成配置文件:
  4. 如果使用 Vercel/Netlify 等平台,通常配置较少。但可以询问 AI:“我的项目使用 [框架名],部署到 Vercel 需要特别配置vercel.json文件吗?如果需要,请给一个基础配置示例。”
  5. 如果需要构建步骤,可以让 AI 生成 package.json 中的 build 脚本。
  6. 如果(尽管不推荐新手)需要容器化,可以让 AI 生成 Dockerfile 或 docker-compose.yml 的基础配置。
  7. AI 辅助生成 CI/CD 脚本:
  8. 如果希望实现自动化部署(例如 Git push 后自动部署),可以让 AI 生成基础的 CI/CD 配置文件(如 GitHub Actions 的 .github/workflows/deploy.yml,GitLab CI 的 .gitlab-ci.yml),并根据所选平台(Vercel CLI, Netlify CLI 等)定制部署命令。
  9. Prompt 示例: "请为我的 [前端框架/Node.js] 项目编写一个 GitHub Actions 配置文件,实现在 main 分支 push 时,自动构建并通过 Vercel CLI 部署到生产环境。"
  10. 开发者执行部署: 开发者负责连接 Git 仓库到部署平台、设置环境变量、触发首次部署,并监控部署过程和结果。
  11. 交互需遵循 .cursor-guidelines.md 规范。

(4)主要产出与流向 (Output & Flow):

  1. 产出物是成功部署并在线上运行的应用程序。相关的部署配置、脚本应纳入版本控制。部署步骤和注意事项应更新到 docs/deployment.md。
  2. 部署成功后,项目进入维护与迭代 (Stage 8) 阶段。


8、维护与迭代 (Maintenance & Iteration):

(1)目标 (Goal): 保障线上应用的稳定运行,及时修复用户反馈或监控发现的 Bug,并根据新的需求或用户反馈,持续地对产品进行小范围的功能改进或迭代。

(2)核心输入 (Input): 线上运行的应用、用户反馈、监控数据、Bug 报告、新的小需求。

(3)关键活动与 AI 协作 (Key Activities & AI Collaboration):

  1. AI 角色回归到**“编码助手”、“调试伙伴”、“文档助理”**。
  2. 监控与告警: (通常由部署平台或专门工具负责,AI 辅助较少,但可咨询相关设置)。
  3. Bug 修复:
  4. 利用 AI 分析 Bug 报告和相关代码,快速定位问题。
  5. 让 AI 辅助生成修复代码,并严格审查、测试
  6. 修复后,更新相关文档和测试用例。
  7. 小功能迭代: 对于小需求或改进,可以快速重复 “Mini-PRD -> Mini-TDD (如果需要) -> 开发 -> 测试 -> 部署” 的流程,每个环节都可借助 AI 提效。
  8. 文档更新: 无论是 Bug 修复还是功能迭代,都要及时更新受影响的代码注释、模块 README、PRD (如果需求有变)、用户手册等。可让 AI 辅助完成。
  9. 对于重大的新功能或架构调整:返回到流程的前期阶段(如 MRD 或 PRD 或 TDD),进行更全面的需求分析、设计和规划,而不是在维护阶段直接进行大的改动。
  10. 交互需遵循 .cursor-guidelines.md 规范。

(4)主要产出与流向 (Output & Flow):

  1. 产出物是持续更新、更稳定、功能更完善的应用程序和同步的文档
  2. 这是一个持续循环的过程,直到项目生命周期结束,或者被新的、更大的迭代需求中断并返回早期阶段。



结语


读到这里,你手中握有的不仅是一份文档,更是一套旨在应对 AI 编程不确定性、提升个人项目落地成功率的实战框架。

它提供了一套从 0 到 1 的结构化流程、可执行的 AI 协作规范 (.cursor-guidelines.md) 和或许能激发你灵感的 Prompt 模板。我们希望,用好它,能让你更有底气地驾驭 AI,将时间和精力聚焦于你最擅长的产品洞察与创新本身。

当然,这只是我们基于当前实践梳理出的 v1.0。AI 技术日新月异,最佳实践也在不断演化,这份指南本身也需要拥抱变化,持续迭代和完善。这份 v1.0 的指南,是基于当前实践的一份阶段性总结,希望能为你提供一个有价值的起点和参照。当然自己也会持续迭代,期待再次见面



Comments on "0 代码经验使用 cursor 上架了几个小程序后,我总结了这份 AI 编程协作文档" :

Leave a Reply

Your email address will not be published. Required fields are marked *

本站所有资源版权均属于原作者所有,这里所提供资源均只能用于参考学习用,请勿直接商用。若由于商用引起版权纠纷,一切责任均由使用者承担。更多说明请参考 VIP介绍。

最常见的情况是下载不完整: 可对比下载完压缩包的与网盘上的容量,若小于网盘提示的容量则是这个原因。这是浏览器下载的bug,建议用百度网盘软件或迅雷下载。 若排除这种情况,可在对应资源底部留言,或联络我们。

对于会员专享、整站源码、程序插件、网站模板、网页模版等类型的素材,文章内用于介绍的图片通常并不包含在对应可供下载素材包内。这些相关商业图片需另外购买,且本站不负责(也没有办法)找到出处。 同样地一些字体文件也是这种情况,但部分素材会在素材包内有一份字体下载链接清单。

如果您已经成功付款但是网站没有弹出成功提示,请联系站长提供付款信息为您处理

源码素材属于虚拟商品,具有可复制性,可传播性,一旦授予,不接受任何形式的退款、换货要求。请您在购买获取之前确认好 是您所需要的资源