flow-req-doc

模式 A: 新项目开发

```

┌─────────────────────────────────────────────────────────────────────┐

│ MCP Server (准备阶段) │

│ 需求想法 → PRD → Stitch 原型 → 页面规格 → PROMPT.md + @fix_plan.md │

└─────────────────────────────────────────────────────────────────────┘

↓

┌─────────────────────────────────────────────────────────────────────┐

│ Ralph (执行阶段) │

│ 读取配置 → 循环调用 Claude Code → 自动写代码 → 完成项目 │

└─────────────────────────────────────────────────────────────────────┘

```

模式 B: 修改/修复已有项目

```

┌─────────────────────────────────────────────────────────────────────┐

│ MCP Server (分析阶段) │

│ 恢复项目 → 分析问题 → 生成任务 → 追加到 @fix_plan.md │

└─────────────────────────────────────────────────────────────────────┘

↓

┌─────────────────────────────────────────────────────────────────────┐

│ Ralph (执行阶段) │

│ 读取新任务 → 循环调用 Claude Code → 自动修复 → 完成修改 │

└─────────────────────────────────────────────────────────────────────┘

```

1. 安装 Ralph

```bash

git clone https://github.com/frankbria/ralph-claude-code.git

cd ralph-claude-code

./install.sh

```

2. 安装 MCP Server

```bash

cd awesome-skills/mcp-server

# 使用 uv (推荐)

uv pip install -e .

# 或使用 pip (需要虚拟环境)

python -m venv .venv

source .venv/bin/activate

pip install -e .

```

3. 配置 Claude Code

在 ~/.claude/config.json 的 mcpServers 中添加：

```json

{

"mcpServers": {

"ralph-workflow": {

"command": "/path/to/venv/bin/python",

"args": ["-m", "src.ralph_workflow_server"],

"cwd": "/path/to/awesome-skills/mcp-server"

}

}

}

```

> 注意: 将 /path/to/venv/bin/python 替换为你的 Python 解释器路径，/path/to/awesome-skills 替换为实际安装路径。

4. 开始使用

重启 Claude Code，然后直接对话：

```

我: 开始一个新项目叫 my-todo-app

Claude: [调用 workflow_init]

✅ 工作流已初始化

▶️ 阶段 1: 生成需求文档

我: 我想做一个待办事项应用，支持添加、完成、删除任务

Claude: [生成 PRD 后调用 save_prd]

✅ PRD 已保存

▶️ 阶段 2: 在 Stitch 中画原型

我: [上传 Stitch 导出的 HTML]

Claude: [调用 save_prototype]

✅ 原型已保存

▶️ 阶段 3: 细化页面规格

Claude: [分析原型，生成规格，调用 save_specifications]

✅ 页面规格已保存

▶️ 阶段 4: 生成 Ralph 配置

Claude: [生成配置，调用 generate_ralph_project]

✅ Ralph 项目已生成

▶️ 阶段 5: 启动开发

请执行:

cd my-todo-app

ralph --monitor

```

修改/修复场景

```

我: 我有一个已有项目需要修改

Claude: [调用 resume_workflow]

✅ 已恢复项目工作流

🔧 修改模式已激活

我: 登录功能有 bug，用户无法正常登出

Claude: [分析问题，调用 add_fix_tasks]

✅ 任务已追加

请执行:

ralph --monitor

```

| 阶段 | 描述 | 工具 |

|------|------|------|

| 1 | 生成需求文档 (PRD) | save_prd |

| 2 | 接收 Stitch 原型 | save_prototype |

| 3 | 细化页面规格 | save_specifications |

| 4 | 生成 Ralph 项目 | generate_ralph_project |

| 5 | 启动自动化开发 | start_ralph |

新项目流程

| 工具 | 描述 |

|------|------|

| workflow_init | 初始化工作流（第一步） |

| workflow_status | 查看状态和进度 |

| save_prd | 保存 PRD 文档 |

| save_prototype | 保存 Stitch 原型 |

| save_specifications | 保存页面规格 |

| generate_ralph_project | 生成 Ralph 项目 |

| start_ralph | 显示启动命令 |

| get_prd | 获取已保存的 PRD |

| get_prototype | 获取已保存的原型 |

| get_specifications | 获取已保存的规格 |

修改/修复流程

| 工具 | 描述 |

|------|------|

| resume_workflow | 恢复已有项目的工作流 |

| analyze_project | 分析现有项目结构 |

| add_fix_tasks | 追加任务到 @fix_plan.md |

| update_prd | 更新现有 PRD（保留历史） |

| get_fix_plan | 获取当前任务清单 |

新项目流程

| Prompt | 描述 |

|--------|------|

| generate_prd | 生成 PRD 文档的指令模板 |

| generate_spec | 生成页面规格的指令模板 |

| generate_ralph_config | 生成 Ralph 配置的指令模板 |

修改/修复流程

| Prompt | 描述 |

|--------|------|

| analyze_issue | 分析问题/Bug，生成修复任务清单 |

| update_prd_prompt | 增量更新现有 PRD 文档 |

```

awesome-skills/

├── mcp-server/

│ ├── src/

│ │ └── ralph_workflow_server.py

│ ├── pyproject.toml

│ └── README.md

└── README.md

```