TaoTao/ai-coding-workflow.md

inclusion

inclusion
always

AI Coding 工作流规则

本规则定义从需求到交付的标准化协作流程。所有涉及"做一个项目 / 实现一个功能"的请求，均遵循以下五个阶段，逐阶段产出文档并在每个关键节点等待用户确认后再推进。

命名约定

• 项目英文缩写记为 XXX（如 IPTV、AVCC），由用户提供或与用户确认。
• 文档统一命名并置于项目根目录（或用户指定目录）：
  • 0-req-XXX.md — 需求与目标文档
  • 1-prd-XXX.md — 产品需求文档（PRD）
  • 2-task-XXX.md — 开发任务文档

阶段流程

阶段 1：接收需求与目标

• 用户给出需求和目标描述，可以是一段文字，也可以是一份 md 文档。
• 我先完整读取并理解用户的需求与目标；若有歧义或关键信息缺失，先向用户澄清，不臆测。

阶段 2：生成 0-req-XXX.md（需求文档）

• 基于用户的需求与目标，生成 0-req-XXX.md。
• 内容应包含：引言、术语表、角色定义、功能性需求（采用 EARS 格式：WHEN/IF/WHILE/WHERE/THE...SHALL）、非功能性需求、关键约束与假设。
• 生成后必须请用户检查确认。未确认前不进入下一阶段。
• 用户提出修改意见时，更新文档并再次请其确认，直到通过。

阶段 3：生成 1-prd-XXX.md（产品需求文档）

• 仅在 0-req-XXX.md 确认通过后进行。
• 基于需求文档生成 1-prd-XXX.md。
• 内容应包含：产品概述与定位、目标与成功指标、用户画像与核心场景（每个场景标注"痛点解法"）、功能清单与优先级（MoSCoW，并映射回需求编号）、关键流程、角色权限矩阵、版本规划、非功能性要求、依赖与风险。
• 生成后必须请用户检查确认。未确认前不进入下一阶段。

阶段 4：生成 2-task-XXX.md（开发任务文档）

• 仅在 1-prd-XXX.md 确认通过后进行。
• 生成 2-task-XXX.md，用于指导开发，包含详细的工作任务分解。
• 任务要求：
  • 以可勾选清单（- [ ]）组织，编号清晰，粒度可执行可验证。
  • 每个任务标注：目标、对应的需求/PRD 条目、验收标准、依赖关系。
  • 区分优先级与阶段（如 MVP / 二期 / 三期）。
• 开发过程中根据实际进度持续更新该文档（勾选完成项、记录变更、补充新任务）。
• 生成后必须请用户确认。

阶段 5：按任务文档执行开发

• 仅在 2-task-XXX.md 确认通过后开始编码。
• 严格按确认的任务文档推进开发工作。
• 每完成一个任务或一组任务：
  • 进行相应的测试（构建、单元测试、必要时集成测试）。
  • 更新 2-task-XXX.md 的任务状态与进度记录。
  • 与用户交互、汇报进展、确认下一步。
• 持续推进，直至完成全部任务。

通用约束

• 每个阶段的产出都要等待用户确认，不得跨阶段抢跑。
• 文档之间保持可追溯：PRD 功能映射回需求编号，任务映射回需求/PRD 条目。
• 当上游文档（需求或 PRD）发生变更时，同步更新下游文档，保持一致。
• 用户的语言即回复与文档的语言（默认中文）。