tzachbon/smart-ralph

解决的问题

Smart Ralph 是一个为 AI 编码代理（特别是 Claude Code 和 Codex）设计的规范驱动开发框架。它防止代理在没有计划的情况下直接进入编码，而是强制执行研究、需求收集和技术设计的结构化流程，直到开始实现为止。这确保了复杂功能经过充分思考，并可在多个会话中恢复或审计。

工作原理

该项目实现了一个多代理工作流，不同专业代理负责开发的不同阶段：

1. 分诊：将大目标拆分为更小的、依赖关系感知的规范（史诗）。
2. 研究：分析现有代码库，并在互联网上搜索可行性。
3. 需求：定义用户故事和验收标准。
4. 原型：（可选）在临时环境中测试特定设计问题。
5. 设计：定义架构和技术权衡。
6. 任务：将设计分解为一系列可执行任务。
7. 执行：逐个实现任务，为每个任务使用全新上下文，并应用质量门控（POC、重构、测试和 linting）。

它还包含一个代码库索引功能，可扫描项目以创建可搜索的组件规范，帮助研究代理更高效地找到现有代码。

适用人群

使用 Claude Code 或 OpenAI Codex 的开发者，希望采用更严谨、架构导向的 AI 辅助功能开发方式，而非简单的基于提示的代码生成。

主要亮点

• 规范驱动工作流：强制执行研究 → 需求 → 设计 → 任务 → 实现的顺序。
• 状态持久化：将进度记录在 .progress.md 和 tasks.md 中，支持会话中断后恢复工作。
• 代码库索引：自动扫描控制器、服务和模型，为 AI 创建可搜索的索引。
• 多代理专业化：为不同阶段使用不同角色（如 triage-analyst、product-manager、architect-reviewer）。
• 灵活执行：支持详细“正常”模式（含审批检查点）和快速“快速”模式，以实现更快迭代。