AI 开发工作流

ralphy-spec

规范驱动开发 + AI 迭代执行
OpenSpec + Ralph 循环，一条命令搞定

🔄
Ralph Loop AI 通过迭代自我纠正，直到任务完成
📋
OpenSpec 结构化规范在编码前锁定意图
⚡
Ralphy-Spec 通过自主代理工作流交付生产级项目——突破上下文窗口限制
快速开始 查看源码

快速开始

01 安装 (cd 你的项目)
npx ralphy-spec init
02 使用命令
/ralphy:plan → 从需求创建规范
/ralphy:implement → 迭代循环构建
/ralphy:validate → 验证验收标准
/ralphy:archive → 完成并归档
创建的文件
.cursor/prompts/
├── ralphy-plan.md
├── ralphy-implement.md
├── ralphy-validate.md
└── ralphy-archive.md

openspec/
├── specs/
├── changes/
└── project.md
示例
# Plan
/ralphy:plan Add user authentication with JWT

# Implement
/ralphy:implement add-user-auth

# Validate
/ralphy:validate

# Archive
/ralphy:archive add-user-auth
/ralphy:plan → 从需求创建规范
/ralphy:implement → 迭代循环构建
/ralphy:validate → 验证验收标准
/ralphy:archive → 完成并归档
创建的文件
.claude/commands/
├── ralphy-plan.md
├── ralphy-implement.md
├── ralphy-validate.md
└── ralphy-archive.md

openspec/
├── specs/
├── changes/
└── project.md
示例
# Plan
/ralphy:plan Add payment processing with Stripe

# Implement
/ralphy:implement add-payments

# Validate & Archive
/ralphy:validate && /ralphy:archive add-payments
"Follow AGENTS.md to plan [feature]"
"Follow AGENTS.md to implement [change]"
"Follow AGENTS.md to validate"
"Follow AGENTS.md to archive [change]"
创建的文件
AGENTS.md

openspec/
├── specs/
├── changes/
└── project.md

.ralphy/
├── config.json
└── ralph-loop.state.json
配合 Ralph 循环运行器
npm install -g @th0rgal/ralph-wiggum

ralph "Follow AGENTS.md to implement add-api. \
  Output <promise>DONE</promise> when complete." \
  --max-iterations 20

工作原理

01

Ralph Wiggum 循环

AI 重复接收相同提示直到任务完成。每次迭代，它都能看到文件中的之前工作并自我纠正。

while !done; do
  ai "Build X. Output DONE when complete."
done
02

OpenSpec

先有规范后有代码。结构化的规范和验收标准确保 AI 知道要构建什么。

openspec/
├── specs/      # Truth
├── changes/    # Work
└── archive/    # Done
工作流程
规划 PRD → 规范
→
实现 循环
→
验证 测试
→
归档 合并
为什么有效
需求模糊 → 规范锁定意图
AI 中途停止 → 循环重试
无法验证 → 测试验证
手动设置 → 一条命令

致谢

Ralph Methodology Geoffrey Huntley opencode-ralph-wiggum @Th0rgal OpenSpec Fission-AI