Piv

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

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

收藏
9.3k
安装
2.3k
版本
1.0.0
CLS 安全性认证2026-08-10
点击查看完整报告 >

使用说明

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 代理架构
  • 维护状态:活跃开发中,指令文件体系完整

安全解读

核心用法

FTW(First Try Works)是一个纯文档型的开发工作流编排 Skill,专为规范软件开发生命周期而设计。其核心机制是 PIV 循环(Plan-Implement-Validate),通过三种模式适配不同规模的项目需求:

  • Full 模式/ftw [prd-path] [start] [end]):基于 PRD(产品需求文档)执行完整的多阶段开发,支持从第1阶段到第4阶段的渐进式交付
  • Mini 模式/ftw mini [feature-name]):轻量化的发现驱动开发,无需 PRD,通过快速对话启动小型功能实现
  • Init 模式/ftw init [path]):初始化项目目录结构,创建 PRDs/PRPs 标准文件夹体系

该 Skill 的独特之处在于其子 Agent 架构:Orchestrator 本身不执行代码,而是通过 sessions_spawn 工具创建独立的 Executor、Validator、Debugger 子 Agent,每个子 Agent 拥有 100% 新鲜上下文,避免上下文污染。

显著优点

1. 流程标准化:强制 PRD → PRP(产品需求计划)→ 执行 → 验证的开发闭环,减少需求漂移
2. 上下文隔离:子 Agent 机制确保每个阶段的上下文独立,避免长对话中的信息累积与混淆

3. 弹性适配:Full/Mini 双模式覆盖从大型功能迭代到快速原型验证的全场景

4. 零依赖安全:纯 Markdown 文档,无外部代码执行,供应链攻击面为零

5. 透明可控:每个阶段的产物(PRP、分析报告、验证结果)均持久化到文件系统,便于审计与回滚

潜在缺点与局限性

1. 无自主执行能力:作为纯文档型 Skill,实际代码生成依赖外部 LLM Agent,本身不提供任何运行时环境
2. Git 依赖前置:要求系统预装 git,且仅支持 macOS/Linux 环境

3. PRD 门槛:Full 模式需要用户预先编写结构化的 PRD 文档,对非技术产品人员存在学习成本

4. 调试循环瓶颈:当验证失败超过 3 轮时需人工介入,复杂功能的自动化收敛能力有限

5. 社区规模小:当前 GitHub 仅 9 stars,生态成熟度与大型框架存在差距

适合的目标群体

  • 独立开发者/小团队:追求规范开发流程但无力搭建完整 DevOps 体系的个人或微型团队
  • AI 辅助编程深度用户:已习惯使用多 Agent 架构,希望将 PIV 方法论固化为可复用工作流的开发者
  • 教育场景:用于教授软件工程流程、需求工程课程的教学工具
  • 原型快速验证:需要快速将功能想法转化为可运行代码并验证可行性的产品经理

常规使用风险

1. 性能风险:多子 Agent 串行执行可能延长总体耗时,复杂项目需合理拆分阶段
2. 依赖项风险:虽然 Skill 本身无第三方依赖,但实际代码生成依赖底层 LLM 的能力与稳定性

3. 上下文传递损耗:尽管子 Agent 隔离是设计特性,但跨阶段的需求理解偏差仍需人工校验 PRP 文档

4. 文件系统污染:自动创建 PRDs/PRPs 目录及大量 Markdown 文件,建议在专用工作区运行

5. 版本兼容性baseDir 路径引用假设特定运行环境,跨平台迁移时可能需要调整配置

Piv 内容

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