（11530期）PIV – Plan Implement Validate – 分阶段开发自动化编排系统

分阶段开发自动化编排系统 PIV工作流编排器，支持PRD到PRP的分阶段软件开发，通过子Agent实现规划-执行-验证闭环，适合复杂特性迭代 使用说明 核心用法 PIV (Plan-Implement-Validate) 是一个系统化的多阶段软件开发工作流编排器，设计用于将大型特性拆解为可管理的阶段并自动化执行。 工作流程 启动方式： PRD路径模式：piv /path/to/feature.md [起始阶段] [结束阶段] 项目路径模式：piv /project/path [起始阶段] [结束阶段] 七阶段循环： PIV初始化 - 创建PRDs/PRPs目录结构，复制模板文件 PRP检查/生成 - 通过子Agent执行代码库分析并生成阶段PRP（产品需求计划） 执行器派遣 - 调用piv-executor子Agent执行PRP，输出执行摘要 验证器派遣 - 调用piv-validator子Agent独立验证，输出验证报告 调试循环（如需要）- 最多3轮调试迭代修复问题 智能提交 - 生成语义化Git commit，带Built with FTW标识 阶段迭代 - 更新WORKFLOW.md并进入下一阶段 架构特点 纯编排器设计：自身不执行代码，通过sessions_spawn创建独立子Agent 上下文隔离：每个子Agent获得100%新鲜上下文，避免污染 模板驱动：PRP基于标准化模板生成，确保一致性 显著优点 系统化分阶段开发：将复杂特性拆解为可验证的阶段，降低认知负荷 自动化验证闭环：每个阶段强制经过执行→验证→调试→提交的完整周期 质量门禁机制：验证失败自动触发调试循环，3次失败后人工介入 可追溯文档流：WORKFLOW.md记录完整执行历史，PRPs/目录保留所有计划 零执行风险：自身仅含Markdown指导文档，无实际代码执行 潜在缺点与局限性 依赖外部模板：需要{baseDir}/assets/prp_base.md等模板文件存在 Git依赖硬性要求：必须安装git，且项目需在版本控制下 子Agent可靠性：实际执行质量取决于piv-executor/piv-validator等子Agent实现 调试深度受限：固定3轮调试上限，复杂问题可能需人工接管 PRD前置要求：无PRD时无法启动，不支持从零创建项目 平台限制：仅支持Darwin/Linux（metadata声明） 适合人群 开发复杂多阶段特性的软件团队 需要PRD→代码可追踪流程的合规场景 采用多Agent协作开发模式的技术团队 希望自动化验证减少人工代码审查的工作流 常规风险 子Agent超时：执行或验证Agent可能超时，需人工检查部分成果 PRP与代码脱节：若代码库变化快，生成的PRP可能过时 验证标准不一致：不同Validator Agent可能对"通过"定义有差异 提交污染风险：自动化Git commit若配置不当可能影响主干历史 维护依赖：个人开发者项目(T3来源)，长期维护稳定性需关注 原始说明 PIV workflow orchestrator - Plan, Implement, Validate loop for systematic multi-phase software development. Use when building features phase-by-phase with PRPs, automated validation loops, or multi-agent orchestration. Supports PRD creation, PRP generation, codebase analysis, and iterative execution with validation.