mini-piv

Mini PIV Ralph 是一个轻量级的功能构建工作流技能，专为希望跳过传统 PRD（产品需求文档）编写 ceremony 的开发团队设计。它采用 PIV（Plan-Implement-Validate）方法论，通过对话驱动的发现阶段快速捕捉需求，自动生成 PRP（项目需求计划），并协调多个子代理完成执行、验证和调试的完整闭环。

核心用法围绕六个步骤展开：首先是发现阶段，通过 3-5 个关键问题快速明确功能范围、触及点、依赖关系和成功标准；随后进入研究与 PRP 生成阶段，由专门的子代理分析代码库并生成结构化需求文档；接着执行阶段将 PRP 转化为实际代码；验证阶段独立检查所有需求；如有缺口则进入最多三轮的调试循环；最后自动提交 git commit。整个过程采用"你是指挥者"的哲学，主代理保持精简，通过 sessions_spawn 创建 fresh sub-agents 处理重体力劳动。

显著优点在于极高的效率和灵活性。相比完整的 PIV 工作流，Mini PIV 省去了繁重的文档编写过程，通过自然语言对话即可启动开发，特别适合小到中型功能迭代。其内置的验证循环和调试机制确保了代码质量，而明确的角色分离（Researcher、Executor、Validator、Debugger）保证了专业性和准确性。此外，它完全透明可审计，所有中间产物（PRP、分析报告）都保存在项目目录中。

潜在缺点包括适用范围限制：对于大型功能或多阶段项目，缺乏 PRD 可能导致架构考虑不周。依赖子代理协作可能带来上下文切换开销，且对复杂业务逻辑的理解深度可能不如人工编写的详细文档。此外，它需要项目已具备规范的 git 工作流和清晰的代码结构，否则代码库分析阶段可能效果不佳。

适合的目标群体主要是敏捷开发团队、独立开发者以及需要快速原型验证的场景。特别适合那些"就是想快速构建点什么而不想先写文档"的开发者，以及已有成熟代码库、需要频繁添加中小型功能的技术团队。对于遵循 GitHub Flow 或类似轻量级分支策略的团队尤为合适。

使用风险方面，首先是 git 操作风险：技能会执行 git add -A 和 git commit，虽然会生成描述性提交信息，但仍需用户确认变更内容。其次是覆盖风险：当检测到同名 PRP 文件时会询问处理方式，但误操作可能导致现有规划丢失。性能方面，多轮次的子代理创建和验证循环可能消耗较多 token 和时间。依赖项上，系统必须预装 git 二进制文件，且目前仅支持 Darwin 和 Linux 系统。最后，虽然技能本身安全，但生成的 PRP 指导的代码实现仍需人工审查，特别是涉及安全敏感操作（如数据库迁移、API 认证）时。