分阶段开发自动化编排系统

PIV工作流编排器，支持PRD到PRP的分阶段软件开发，通过子Agent实现规划-执行-验证闭环，适合复杂特性迭代

基本信息

• 技能名称?PIV - Plan Implement Validate
• 中文名称?分阶段开发自动化编排系统
• 作者?smokealot420
• 分类?专业技能
• 版本?1.1.0
• 标签?workflow, orchestration, software-development, prd, prp, multi-agent, git, automation, code-generation, validation

使用方法

使用说明
核心用法
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基于标准化模板生成，确保一致性
   显著优点
8. 系统化分阶段开发 ：将复杂特性拆解为可验证的阶段，降低认知负荷
9. 自动化验证闭环 ：每个阶段强制经过执行→验证→调试→提交的完整周期
10. 质量门禁机制 ：验证失败自动触发调试循环，3次失败后人工介入
11. 可追溯文档流 ：WORKFLOW.md记录完整执行历史，PRPs/目录保留所有计划
12. 零执行风险 ：自身仅含Markdown指导文档，无实际代码执行
    潜在缺点与局限性
13. 依赖外部模板 ：需要 {baseDir}/assets/prp_base.md 等模板文件存在
14. Git依赖硬性要求 ：必须安装git，且项目需在版本控制下
15. 子Agent可靠性 ：实际执行质量取决于piv-executor/piv-validator等子Agent实现
16. 调试深度受限 ：固定3轮调试上限，复杂问题可能需人工接管
17. PRD前置要求 ：无PRD时无法启动，不支持从零创建项目
18. 平台限制 ：仅支持Darwin/Linux（metadata声明）
    适合人群
    开发复杂多阶段特性的软件团队
    需要PRD→代码可追踪流程的合规场景
    采用多Agent协作开发模式的技术团队
    希望自动化验证减少人工代码审查的工作流
    常规风险
    子Agent超时 ：执行或验证Agent可能超时，需人工检查部分成果
    PRP与代码脱节 ：若代码库变化快，生成的PRP可能过时
    验证标准不一致 ：不同Validator Agent可能对"通过"定义有差异
    提交污染风险 ：自动化Git commit若配置不当可能影响主干历史
    维护依赖 ：个人开发者项目(T3来源)，长期维护稳定性需关注