메뉴
Ralph Evolution - 自动化闭环开发系统 整合 decision-record、bug-analyzer、prd-to-code、prd-evolution 和 ralpha 形成自驱动开发工作流：决策→调研→PRD→代码→测试→Bug分析→优化
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
PRD 驱动的完整开发工作流 - 从用户故事分析到自动化测试的端到端流程。 当用户需要"一条龙开发"、"全自动开发"、"从需求到代码"、"先分析PRD再开发"、 "多模型分析后自动开发"、"完整开发流程"、"从需求分析到测试"或任何涉及 PRD分析→需求整合→代码生成→自动化测试的连续工作时，**必须**使用此技能。 整合多模型聚合、Kimi深度整合、PRD生成、多模型代码审查、代码开发、自动化测试等能力。 **新增**: 智能决策大脑(th-workflow-decision-engine) - 自动判断何时使用GitNexus代码分析、 unified-search联网搜索、多模型聚合，测试失败时智能选择修复策略。
PRD驱动工作流的决策大脑 - 智能判断何时使用搜索、代码分析、多模型聚合。 作为子Skill被 th-prd-driven-dev-workflow 调用，负责工具选择和策略决策。
动态 Agent 生成器（母体模式）。当用户需要处理复杂项目时，自动分析需求并生成定制化专业 Agent 团队。接收项目描述、技术栈、版本号、约束条件，输出完整的 Agent 配置和启动命令。触发词：需要专业团队、生成 Agent、创建定制化 Agent、复杂项目团队、动态生成 Agent。
Arch Linux 系统特性（PEP 668、AUR Helpers）
浏览器交互自动化：网页测试、表单填写、截图、数据提取。触发词：打开网页、填写表单、网页截图。
系统化代码审查：安全性、性能、可维护性、正确性、测试覆盖。触发词：代码审查、review 代码、PR 审查。
| name | th-ralph-evo |
| version | 1.0.0 |
| description | Ralph Evolution - 自动化闭环开发系统 整合 decision-record、bug-analyzer、prd-to-code、prd-evolution 和 ralpha 形成自驱动开发工作流：决策→调研→PRD→代码→测试→Bug分析→优化 |
| triggers | ["启动自动化开发","创建智能开发团队","启动ralph闭环","自动化开发流程","智能开发系统","闭环开发","ralph evo"] |
角色: 智能开发编排中枢 核心价值: 从需求到代码的自动化闭环，持续迭代优化 版本: v1.0 (Multi-Agent Orchestrator)
┌─────────────────────────────────────────────────────────────────────────────┐
│ Ralph Evolution 自动化闭环 │
└─────────────────────────────────────────────────────────────────────────────┘
[输入层] [处理层] [输出层]
┌──────────┐ ┌──────────────┐ ┌────────────┐
│决策记录 │─────────────▶│ 中央编排器 │──────────▶│ PRD 文档 │
│decision │ │Orchestrator │ │tree.md │
│-record │ └──────┬───────┘ └────────────┘
└──────────┘ │
│ ▼
│ ┌────────────────┐
│ │ th-deep-coder2 │
│ │ 深度调研 │
│ └───────┬────────┘
│ │
▼ ▼
┌────────────────────────────────────────────────────────────┐
│ 自动化执行引擎 │
├────────────────────────────────────────────────────────────┤
│ ┌──────────────┐ ┌──────────────┐ ┌────────────────┐ │
│ │ prd-evolution│──▶│ prd-to-code │──▶│ ralpha │ │
│ │ 版本管理 │ │ 多代理实现 │ │ worktree管理 │ │
│ └──────────────┘ └──────────────┘ └────────────────┘ │
│ │ │
└───────────────────────────────────────────────────┼─────────┘
▼
┌─────────────────────────────────────────────────────────────┐
│ 质量保障层 │
├─────────────────────────────────────────────────────────────┤
│ ┌──────────────┐ ┌──────────────┐ ┌─────────────────┐ │
│ │ 自动化测试 │──▶│ th-bug │──▶│ 反馈至决策层 │ │
│ │ │ │ -analyzer │ │ (闭环优化) │ │
│ └──────────────┘ └──────────────┘ └─────────────────┘ │
└─────────────────────────────────────────────────────────────┘
用户输入 (零散需求/抱怨)
│
▼
┌────────────────────┐
│ decision-record │ ← 自动触发，无需等待用户完整描述
│ 需求演进与追踪 │
└────────┬───────────┘
│
▼
┌────────────┐
│ 功能主题 │ ← AI主动归纳主题
├────────────┤
│ 1级解读 │ ← 表面层方案
│ 2级解读 │ ← 系统层方案
│ N级解读 │ ← 深层剖析
│ 本地意见 │ ← 代码库分析
│ 外部意见 │ ← 多模型聚合
│ 最终方案 │ ← 用户确认
└─────┬──────┘
│
▼
┌────────────┐
│ PRD 生成 │ ← 自动转换为 PRD
└────────────┘
触发条件:
decision_record:
- 文件变更监听: ~/src/docs/decisions/*.md
- 状态变化: 草稿 → 已确认
- 自动动作: 启动 deep-coder2 调研
prd_evolution:
- PRD 状态: 已确认 → 待实现
- 自动动作: 创建 prd-to-code 团队
ralpha:
- PRD 就绪信号
- 自动动作: 创建 worktree 并行开发
bug_analyzer:
- 测试失败信号
- 代码覆盖率低于阈值
- 自动动作: 分析影响并修复
┌────────────────────────────┐
│ 用户确认 │
└────────────┬───────────────┘
│
┌────────────────┼────────────────┐
│ ▼ │
│ ┌──────────────┐ │
│ │ PRD 实现 │ │
│ └──────┬───────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ │
│ │ 自动化测试 │ │
│ └──────┬───────┘ │
│ │ │
▼ ▼ ▼
┌────────────────────────────────────────┐
│ 质量评估节点 │
├────────────────────────────────────────┤
│ 测试通过? → 覆盖率>90%? → 安全扫描? │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ [是] [是] [通过] │
│ │ │ │ │
│ └───────────┴───────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ │
│ │ 完成闭环 │ │
│ └──────────────┘ │
│ │
│ 任一检查失败: │
│ │ │
│ ▼ │
│ ┌──────────────┐ │
│ │ bug-analyzer │ ← 自动分析影响 │
│ │ 分析修复 │ 生成修复方案 │
│ └──────┬───────┘ │
│ │ │
│ ▼ │
│ 更新 PRD / 创建热修复 worktree │
│ │ │
│ └───────────────────────────┘
│ │
│ ▼
│ 回到开发阶段
└────────────────────────────────────────┘
用户输入:
启动自动化开发 - 用户认证模块
系统自动执行:
1. 检查决策记录
├── 读取 ~/src/docs/decisions/INDEX.md
├── 查找相关决策记录
└── 若无，询问是否创建
2. 检查 PRD 状态
├── 读取 prd-evolution tree.md
├── 确认是否有待实现 PRD
└── 若无，从 decision-record 生成
3. 启动深度调研 (可选)
├── 触发 th-deep-coder2
├── 收集技术方案
└── 整合到 PRD
4. 创建实现团队
├── 使用 orchestrator 创建团队
├── 根据 PRD 技术栈选择代理类型
└── 分配 worktree
5. 启动可视化面板
└── 打开 dashboard 显示实时状态
┌─────────────────────────────────────────────────────────────┐
│ 多代理并行执行 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Worktree 1 │ │ Worktree 2 │ │ Worktree N │ │
│ │ 数据层 │ │ 逻辑层 │ │ UI 层 │ │
│ │ │ │ │ │ │ │
│ │ data-agent │ │ logic-agent │ │ ui-agent │ │
│ │ (并行) │ │ (等待data) │ │ (并行) │ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
│ │ │ │ │
│ └────────────────┼────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────┐ │
│ │ test-agent │ │
│ │ (TDD 驱动) │ │
│ └──────┬──────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────┐ │
│ │ 质量检查: security-reviewer + code-reviewer │ │
│ └────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────┐ │
│ │ 自动化测试 │ │
│ └──────┬──────┘ │
│ │ │
└──────────────────────────┼─────────────────────────────────┘
│
┌────────────┴────────────┐
▼ ▼
[测试通过] [测试失败]
│ │
▼ ▼
┌──────────┐ ┌──────────────┐
│ 合并代码 │ │ bug-analyzer │
│ 标记完成 │ │ 分析并修复 │
└──────────┘ └──────────────┘
│
▼
更新 PRD / 重试
测试失败触发:
1. bug-analyzer 分析
├── 读取测试失败日志
├── 使用 GitNexus 分析影响范围
├── 定位根因
└── 生成修复方案
2. 决策分支
├── 若影响小: 直接修复
├── 若影响大: 创建 decision-record 讨论
└── 若需架构调整: 更新 PRD-evolution
3. 自动修复执行
├── 创建 hotfix worktree
├── 实施修复
├── 回归测试
└── 合并或废弃
4. 学习记录
├── 记录 bug 模式到知识库
├── 更新测试用例
└── 反馈到 decision-record
┌──────────────────────────────────────────────────────────────────────┐
│ Ralph Evolution 实时监控面板 │
├──────────────────────────────────────────────────────────────────────┤
│ │
│ [决策状态] [PRD 版本树] [团队状态] │
│ ┌────────────┐ ┌──────────────┐ ┌──────────┐ │
│ │ 活跃决策 │ │ prd-v1.0 │ │ 运行中 │ │
│ │ 5个 │ │ ├──feature-A│🔵 │ 3/5 │ │
│ │ 待确认 │ │ ├──feature-B│🔵 │ │ │
│ │ 2个 │ │ └──feature-C│🟡 │ 空闲 │ │
│ └────────────┘ └──────────────┘ │ 2/5 │ │
│ └──────────┘ │
│ [当前 Worktrees] [测试状态] [Bug 分析] │
│ ┌────────────────┐ ┌──────────────┐ ┌──────────┐ │
│ │ auth-layer │ │ 单元测试 │ │ 待分析 │ │
│ │ ├── data │✅ │ 98% ✅ │ │ 0 │ │
│ │ ├── logic │🏃 │ │ │ │ │
│ │ └── ui │✅ │ 集成测试 │ │ 已修复 │ │
│ │ │ │ 85% ⚠️ │ │ 3 │ │
│ │ payment-layer │ │ │ │ │ │
│ │ ├── data │✅ │ E2E 测试 │ │ 复现中 │ │
│ │ └── logic │✅ │ 12/15 ✅ │ │ 1 │ │
│ └────────────────┘ └──────────────┘ └──────────┘ │
│ │
│ [影响分析] │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ 最近变更: auth-layer/data/models/user.ts │ │
│ │ 影响范围: d=1 (3个文件) | d=2 (8个文件) | 风险: MEDIUM │ │
│ └──────────────────────────────────────────────────────────────┘ │
│ │
│ [系统日志] │
│ 2026-03-23 14:30:15 [INFO] Worktree 'auth-layer' 测试通过 │
│ 2026-03-23 14:28:02 [WARN] payment-layer 集成测试覆盖率低于90% │
│ 2026-03-23 14:25:44 [INFO] decision-record '性能优化' 已确认 │
│ │
└──────────────────────────────────────────────────────────────────────┘
| 命令 | 说明 |
|---|---|
ralph-evo dashboard | 启动实时监控面板 |
ralph-evo status | 查看当前状态摘要 |
ralph-evo pause | 暂停自动化流程 |
ralph-evo resume | 恢复自动化流程 |
ralph-evo reset | 重置状态（保留历史） |
~/.claude/skills/th-ralph-evo/
├── SKILL.md # 本文件
├── scripts/
│ ├── orchestrator.mjs # 中央编排器 (核心)
│ ├── dashboard.mjs # 可视化面板
│ ├── decision-monitor.mjs # 决策文件监控
│ ├── prd-sync.mjs # PRD 状态同步
│ └── bug-analyzer-bridge.mjs # Bug分析桥接
├── templates/
│ └── workflow-config.yaml # 工作流配置模板
└── docs/
└── architecture.md # 架构详细设计
decision-record (需求输入)
│
▼ 自动触发
th-deep-coder2 (深度调研)
│
▼ 数据流入
prd-evolution (版本管理)
│
▼ 状态变更触发
prd-to-code (多代理实现)
│
▼ 工作分配
ralpha (worktree管理)
│
▼ 质量反馈
th-bug-analyzer (Bug分析)
│
└───────┐
▼
反馈至决策层 (闭环)
# workflow-config.yaml
workflow:
name: "用户认证模块开发"
triggers:
decision_record:
path: "~/src/docs/decisions/user-auth.md"
auto_investigate: true
prd:
id: "prd-user-auth-v1"
auto_create: true
evolution:
enable_version_tree: true
team:
type: "multi-agent"
workers:
- name: "data-agent"
layer: "data"
model: "typescript-reviewer"
- name: "logic-agent"
layer: "logic"
model: "typescript-reviewer"
- name: "ui-agent"
layer: "ui"
model: "typescript-reviewer"
- name: "test-agent"
layer: "test"
model: "tdd-guide"
quality_gates:
test_coverage: 90
security_scan: true
code_review: true
feedback:
auto_bug_analyze: true
create_decision_on_failure: true
# 启动 Ralph Evolution
ralph-evo start --project user-auth --from-decision
# 或从现有 PRD 开始
ralph-evo start --project user-auth --from-prd prd-user-auth-v1
用户: 启动自动化开发 - 实现用户认证系统
AI:
1. 读取 decision-record 中关于用户认证的决策
2. 检查 PRD 状态
3. 启动深度调研 (询问用户是否进行)
4. 创建多代理团队
5. 打开可视化面板
6. 开始并行开发
最后更新：2026-03-23 | 版本：v1.0 (自动化闭环系统)