技能简介
PIV是一个分阶段软件开发流程编排工具,采用计划(Plan)-实现(Implement)-验证(Validate)循环模式。
业务背景
PIV帮助团队将复杂功能开发拆解为计划、实现、验证三个阶段,通过自动编排子代理分工协作,让多步骤开发任务有序推进。业务人员只需提供需求文档,系统即可生成阶段执行计划并协调各角色完成任务,降低跨环节沟通成本,确保开发过程可控可追溯。
落地案例:某产品团队需开发新模块,产品经理先编写PRD文档。开发负责人使用PIV指定该文档路径启动流程,系统自动分析代码库结构并生成PRP阶段计划,随后依次调度分析代理、编码代理、测试代理完成各阶段任务,最终输出验证结果与执行摘要。若中途发现问题,可从指定阶段重新介入,无需从头开始。
能做什么
- 按阶段执行多步骤软件开发任务
- 自动生成PRP(阶段执行计划)文档
- 分析代码库结构并制定实施策略
- 协调多个子代理完成不同角色任务
- 支持从指定阶段开始或结束开发流程
使用说明
1. 安装技能
clawhub install piv
2. 初始化项目
首次使用需在项目目录创建PIV文件夹结构:
mkdir -p PRDs PRPs/templates PRPs/planning
3. 准备PRD文档
在PRDs/目录下创建产品需求文档(以.md结尾),文档中需包含各阶段(Phase)的范围定义。
4. 启动编排
方式一:指定PRD路径
piv PRDs/feature-name.md [起始阶段] [结束阶段]
方式二:自动发现PRD
piv [项目路径] [起始阶段] [结束阶段]
参数说明:
起始阶段:从第几阶段开始(默认1)结束阶段:到第几阶段结束(默认4或自动检测)
5. 工作流程
每个阶段自动执行:代码库分析 → 生成PRP → 执行PRP → 验证结果。编排器会创建专门的子代理处理各阶段任务。
输入与输出
见下方输入与输出表格。
| 项目 | 内容 |
|---|---|
| 输入 | PRD文档路径(必需)、项目路径、起始阶段编号、结束阶段编号 |
| 输出 | 阶段执行计划(PRP)、代码分析报告、执行摘要、验证结果 |
| 适用人群 | 软件开发团队、技术负责人、项目经理 |
| 不包含 | 代码直接编辑功能、自动化测试执行、CI/CD集成 |
风险提示
- 需预先创建PRD文档,无PRD时无法启动
- 依赖git环境,请确保已安装git
- 多阶段任务可能耗时较长,建议分阶段执行
- 子代理执行结果需人工复核确认
来源信息
原始链接:GitHub
来源类型:github
常见问题
Q1:分阶段开发编排 适合哪些场景?
A:适合需要「PIV是一个分阶段软件开发流程编排工具,采用计划(Plan)-实现(Im」的场景,尤其是希望快速验证并落地的团队与个人。
Q2:第一次使用应该先做什么?
A:先明确目标任务,再按照页面中的“能做什么”和“使用说明”完成最小可行流程。
Q3:如何判断是否值得长期使用?
A:建议连续使用 1-2 周,对比效率、稳定性和协作成本,再决定是否纳入长期工具栈。
