核心功能与用法
Mini PIV Ralph 是一款面向中小型功能开发的轻量级 PIV（Product-Implementation-Validation）工作流工具。其核心设计哲学是"快速启动、质量不减"——当开发者希望跳过传统 PRD（产品需求文档）的繁琐流程时，可通过简短的对话式问答直接进入开发执行。
标准使用流程
1. 启动与参数解析：支持直接传入功能名称（自动转为 kebab-case）和项目路径，或留空由系统交互式询问
2. 发现阶段（Discovery）：通过 5 个结构化问题快速捕获需求范围、代码触点、依赖库、完成标准和排除项
3. 研究与 PRP 生成：派生子代理完成代码库分析，自动生成 PRP（Product Requirements Proposal）文档
4. 执行阶段：Executor 子代理基于 PRP 实施开发，遵循 ULTRATHINK → Execute → Validate → Verify 流程
5. 验证与调试循环：Validator 独立验证所有需求，未通过则进入最多 3 轮 Debugger 修复循环
6. 智能提交：自动生成规范化的 git commit，包含功能描述和 Mini PIV 标识
显著优势
- 零 PRD 负担：通过自然语言对话替代正式需求文档，显著降低启动门槛
- 质量闭环保障：保留完整 PIV 核心流程（执行→验证→调试），不因轻量而牺牲代码质量
- 子代理隔离：每个阶段派生独立会话，避免上下文污染，支持并行观察
- 智能冲突检测：自动检查现有 PRP 并提示覆盖/重命名/跳过选项
- 模板化输出：基于标准模板生成结构化文档，确保一致性
局限性与注意事项
- 适用范围受限：明确限定于中小型功能，大型多阶段项目仍需使用完整 PIV 工作流
- 深度依赖子代理：执行质量高度依赖 Research/Executor/Validator/Debugger 等子代理的实现成熟度
- 调试次数上限：硬性限制 3 轮调试循环，复杂问题可能需人工介入
- Git 依赖：要求目标环境必须安装 git
- 仅支持 macOS/Linux：Windows 用户需额外适配
适合人群
- 快速原型开发者和需要验证技术方案的工程师
- 熟悉现有代码库、无需详尽文档的老练开发者
- 敏捷团队中负责独立功能模块的开发者
- 对"PRD 形式主义"感到疲惫、希望直接编码的实践派
常规风险提示
| 风险场景 | 说明 |
|---------|------|
| 子代理执行失败 | Executor 阻塞时需人工介入决策 |
| 验证无法自动完成 | Validator 标记 HUMAN_NEEDED 时需用户确认 |
| 调试耗尽 | 3 轮后仍失败将升级为持久问题清单 |
| 路径权限 | 需确保 PROJECT_PATH 有读写权限 |
| Git 状态污染 | 执行前建议确认工作目录干净 |
该工具在"速度"与"规范"之间取得精巧平衡，是成熟开发团队提升迭代效率的有力补充。