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