Mini PIV - Lightweight Feature Builder — Mini PIV - 轻量级特征构建器
v1.1.0轻量级PIV工作流 - 驱动发现的特性构建器。无需PRD。快速提问,生成PRP,带验证循环执行。适用于中小型特性,当您想要跳过PRD仪式时。
运行时依赖
安装命令
点击复制技能文档
Mini PIV Ralph - 轻量级特性构建器 参数:$ARGUMENTS 解析参数:FEATURE_NAME = $ARGUMENTS[0] 或 null(将在发现阶段询问用户) PROJECT_PATH = $ARGUMENTS[1] 或当前工作目录 哲学:快速与质量 “当你只想构建一些东西,而不需要先编写PRD。” 相同的质量流水线(执行 → 验证 → 调试),但从快速对话开始,而不是PRD。 你是编排者 - 保持精简,生成新的子代理来处理繁重的任务。 子代理生成:使用sessions_spawn工具创建新的子代理会话。 每个生成都是非阻塞的 - 你将通过announce步骤接收结果。 等待每个代理的结果,然后再继续到下一步。 必读文档(按角色) 角色 | 指令 -----|----- 编排者 | 本文件 研究代理 | {baseDir}/references/codebase-analysis.md + {baseDir}/references/generate-prp.md 执行者 | {baseDir}/references/piv-executor.md + {baseDir}/references/execute-prp.md 验证者 | {baseDir}/references/piv-validator.md 调试者 | {baseDir}/references/piv-debugger.md 视觉工作流程 ┌──────────────────────────────────────────────────────────┐ │ 1. 发现 → 询问3-5个问题 │ │ 2. 研究与PRP → 代码库分析 + PRP生成 │ │ 3. 执行 → 实现PRP │ │ 4. 验证 → PASS / GAPS_FOUND / HUMAN_NEEDED │ │ 5. 调试循环 → 修复差距(最多3次) │ │ 6. 提交 → feat(mini): {描述} │ └──────────────────────────────────────────────────────────┘ 步骤1:发现阶段 1a. 确定特性名称 如果未提供:询问用户或从上下文推断。 规范化为kebab-case。 1b. 检查现有的PRP ls -la PROJECT_PATH/PRPs/ 2>/dev/null | grep -i "mini-{FEATURE_NAME}" 如果存在,询问:“覆盖、重命名或跳过执行?” 1c. 询问发现问题 以单个对话消息呈现: 我有几个快速问题,以便我能够正确构建它:
- 这个特性做什么? 简要概述。
- 代码库的哪个部分包含它? 文件、文件夹、组件?
- 是否有特定的库、模式或现有代码需要遵循?
- “完成”是什么样的? 1-3个具体的成功标准。
- 是否有明确的范围之外的内容? 根据特性类型(UI、API、合同、集成)进行调整。
发现输入
{粘贴结构化YAML}步骤1:代码库分析
阅读{baseDir}/references/codebase-analysis.md以获取过程。 保存到:{PROJECT_PATH}/PRPs/planning/mini-{FEATURE_NAME}-analysis.md步骤2:生成PRP(分析上下文仍然加载)
阅读{baseDir}/references/generate-prp.md以获取过程。发现 → PRP转换
| 发现 | PRP部分 |
|---|---|
| 范围(Q1) | 目标 + 什么 |
| 接触点(Q2) | 实现任务位置 |
| 依赖项(Q3) | 上下文YAML,已知陷阱 |
| 成功标准(Q4) | 成功标准 + 验证 |
| 范围之外(Q5) | 什么部分的排除 |