Skip to content

编写自动化研发模板 PRD 文档 #107

@XiaoCooder

Description

@XiaoCooder

问题

当前缺少一份清晰的 PRD 文档,用于定义“自动识别 Issue、完成代码编写、多 Agent 评审、提交 PR”的端到端自动化研发流程。

由于没有统一文档,后续实现时容易出现流程边界不清、Agent 职责不明确、评审循环不可控、失败恢复策略缺失等问题。

建议改动

新增一份 PRD 文档,描述新的自动化研发流程,至少覆盖:

  • 自动识别待处理 Issue 的规则
  • Issue 信息解析与任务拆解方式
  • 代码编写 Agent 的职责边界
  • 多 Agent 评审流程
  • Agent 评审循环控制策略
  • 评审通过、评审失败、超出循环次数时的处理方式
  • 自动提交 PR 的触发条件
  • PR 描述、关联 Issue、变更摘要、测试结果的生成规则
  • 异常、冲突、权限不足、测试失败等场景的处理方式
  • 可观测性、日志、状态记录与人工介入点

验收标准

  • 新增 PRD 文档,明确描述完整自动化研发流程
  • 文档中包含 Issue 识别、编码、多 Agent 评审、PR 提交流程
  • 文档中明确 Agent 评审循环控制规则,包括最大循环次数、退出条件和失败处理
  • 文档中定义各类 Agent 的职责边界
  • 文档中包含主要异常场景和人工介入策略
  • 文档内容足够指导后续代码实现

前置 Discussion

待补充。如该流程涉及公开 API、权限模型、任务调度模型或 Agent 执行边界,应先补充相关 Discussion 链接。

为什么重要

该 PRD 可以为后续实现提供统一产品和技术边界,避免直接进入编码后出现流程不一致、Agent 行为不可控、PR 自动化风险过高等问题。

它也有助于维护者评估该能力是否符合项目方向,并提前确认安全边界、权限边界和人工介入机制。

补充信息

新功能目标流程:

  1. 自动识别可处理的 Issue
  2. 分析 Issue 并拆解实现任务
  3. 自动完成代码修改
  4. 启动多个 Agent 进行代码评审
  5. 根据评审结果进行修复循环
  6. 达到通过条件后自动提交 PR
  7. 在 PR 中附带实现摘要、测试结果和关联 Issue

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions