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