SuperAPI AI 工具集

piv

编程与开发

查看项目

更新于 10-15 17:26

技能介绍

PIV 是一个工作流编排技能,用于系统化、多阶段的软件开发,围绕 Plan(计划)、Implement(实现)、Validate(验证)循环推进,适合按阶段逐步构建功能。它由编排器统筹,本身不直接执行 PRP,而是用 sessions_spawn 为每项任务派生全新上下文的子代理,以保持编排器轻量、子代理上下文完整。

必要用法:需先存在 PRD。参数解析分两种模式:若第一个参数以 .md 结尾,视为 PRD 文件路径,PROJECT_PATH 由 PRDs/ 目录向上推导,START_PHASE 默认 1,END_PHASE 默认从 PRD 自动检测;否则第一个参数为项目路径(默认当前工作目录),START_PHASE 默认 1,END_PHASE 默认 4,PRD_PATH 从 PROJECT_PATH/PRDs/ 自动发现。

项目初始化会创建目录:mkdir -p PROJECT_PATH/PRDs PROJECT_PATH/PRPs/templates PROJECT_PATH/PRPs/planning;并从资源复制 prp_base.md 与 workflow-template.md(若不存在)。每个阶段依次:检查或生成 PRP(先代码库分析再生成 PRP)、派生执行器、派生验证器、进入最多 3 轮调试循环、智能提交、更新 WORKFLOW.md、进入下一阶段。

限制:无 PRD 时需先创建;执行器 BLOCKED、验证器 HUMAN_NEEDED 或调试循环耗尽时需人工介入;子代理超时或失败时检查部分成果、以更简提示重试一次,仍失败则上报。具体依赖、平台与收费信息暂未提供。