Piv

⚙️ PIV 循环驱动的智能开发编排

结构化开发框架,采用PIV循环(计划-实现-验证)和子代理并行执行,支持完整多阶段编排或轻量级探索驱动开发

收藏
9.3k
安装
2.3k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

FTW (First Try Works) 综合评估

核心用法

FTW 是一个基于 PIV 循环(Plan-Implement-Validate) 的结构化开发框架,通过 /ftw 命令提供三种运行模式:

完整模式(Full PIV)

基于 PRD(产品需求文档)进行多阶段开发,支持自动发现 PRD 文件和指定阶段范围:

/ftw [prd-path.md] [start] [end]     # 指定 PRD 和阶段
/ftw [project-path]                   # 自动发现 PRD

轻量模式(Mini)

无需 PRD,通过对话驱动快速开发小型功能:

/ftw mini [feature-name] [path]

初始化模式(Init)

快速搭建 PIV 目录结构:

/ftw init [project-path]

显著优点

1. 代理并行化架构:独立子代理分别负责执行(Executor)、验证(Validator)和调试(Debugger),实现关注点分离
2. 上下文预算管理:编排器仅保留 15% 上下文,每次子代理获得 100% 新鲜上下文,避免上下文污染

3. 弹性错误处理:内置 3 轮调试循环、重试机制和人工介入升级路径

4. 标准化交付物:PRD → PRP(阶段计划)→ Analysis → Implementation 的清晰链路

5. 双模式覆盖:既支持企业级多阶段项目,也支持快速原型开发

潜在局限

1. 外部依赖:必须配合 git 使用,且依赖特定目录结构和参考文件
2. 学习曲线:需理解 PIV 概念、PRP 格式及子代理角色分工

3. 平台限制:目前仅支持 macOS 和 Linux

4. 超时风险:子代理可能超时,需人工介入处理边缘情况

5. 上下文切换成本:频繁 spawn 子代理在简单任务上可能 overhead 较高

适合人群

  • 团队技术负责人:需要标准化交付流程的中大型项目
  • 全栈开发者:追求"一次做对"的结构化开发实践者
  • AI 辅助编程用户:希望最大化 LLM 能力、减少反复试错的开发者
  • 代码审查严格的环境:需要完整验证周期和可追溯变更的场景

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 子代理失败 | Executor/Validator/Debug 超时或崩溃 | 自动重试一次,失败后人工介入 |
| PRD 缺失 | 完整模式无 PRD 会直接拒绝 | 明确错误提示,引导用户创建 |
| 目录权限 | init 模式需写权限 | 检查返回状态,失败时提示 |
| 验证循环耗尽 | 3 轮调试后仍未通过 | 升级人工决策,保留问题清单 |
| 上下文误解 | 子代理未读指令文件 | 强制前置读取检查(CRITICAL 标注)|

来源与可信度

  • 来源:GitHub 开源项目(github.com/SmokeAlot420/ftw)
  • 设计理念:融合软件工程最佳实践(Plan-Do-Check-Act 循环)与 LLM 代理架构
  • 维护状态:活跃开发中,指令文件体系完整

Piv 内容

assets文件夹
references文件夹
手动下载zip · 22.4 kB
prp_base.mdtext/markdown
请选择文件