curdx-ralph

curdx-ralph

English

给 Claude Code 装上一套真正能落地的开发工作流：先识别任务，再规划，再自主执行，再分层验证，必要时还能暂停和恢复。

它解决的不是“怎么写提示词”，而是“怎么把任务稳定做完”

用 Claude Code 做开发，真正麻烦的通常不是生成代码，而是这些环节：

• 小任务到底该直接改，还是先规划？
• 大任务怎么拆波次，怎么避免一口气改乱？
• 做完以后谁来跑 lint、类型检查、测试和回归？
• 上下文快耗尽了，如何不中断地接着做？

curdx-ralph 把这些步骤收束成一套统一命令：

• 自动判断任务该走 /curdx:quick 还是 /curdx:start
• 为复杂任务生成可审批的 .plan.md
• 按波次并行分派执行代理
• 每波结束后自动做分层验证
• 上下文逼近上限时自动暂停，并支持 /curdx:resume
• 用状态文件和状态栏把“做到哪一步了”持续暴露出来

你会立刻想用它的原因

1. 入口足够简单

npx curdx-ralph init

安装完以后，你只需要记住两个入口：

/curdx:quick <小任务>
/curdx:start <正式需求>

2. 它不只会“做”，还会“验”

内置的验证分层会根据项目技术栈选择合适命令：

• L1: 编译 / lint / 类型检查
• L2: 单元测试
• L3: API 集成测试
• L4: Chrome DevTools MCP 浏览器验证

不是所有项目都强行跑四层。前后端能力和项目配置会被自动识别，再决定启用哪些验证层。

3. 它知道怎么在真实项目里活下来

• 自动检测 JavaScript、TypeScript、Java、Python、Go、Rust
• 自动推断构建工具、测试命令、lint 命令、类型检查命令
• 自动写入项目级配置，避免每次重新解释上下文
• 自动监控上下文窗口占用，避免做到一半直接“断片”

30 秒上手

前置条件

• 已安装 Claude Code
• 本机 Node.js >= 22
• 当前目录就是你要接入的项目根目录

安装

npx curdx-ralph init

安装器会自动检测技术栈，并在确认后完成初始化。

curdx-ralph 现在会在 init 时默认一并安装 PUA。

如果你想显式关闭它，可以这样安装：

npx curdx-ralph init --no-pua

或者在已经初始化过的项目里单独安装：

npx curdx-ralph install-skill pua

安装器会把 pua 官方文件写入当前项目的 .agents/skills/pua/SKILL.md 和 .claude/commands/pua.md，避免手工复制。 当 /curdx:quick、/curdx:start 后续执行进入重复失败重试时，如果检测到已安装 pua，工作流会自动要求执行器加载 pua 方法论，而不是继续原地重试。

如果你的任务包含页面交互验证，安装器还会自动把 chrome-devtools MCP 写入项目 .mcp.json，这样 L4 浏览器验证可以直接复用同一套项目配置，不需要你再手工补一层浏览器自动化脚本。

第一次使用

小改动：

/curdx:quick 给用户列表加一个按名字搜索的接口

正式需求：

/curdx:start 创建完整的用户管理 CRUD，后端 Spring Boot，前端 Vue

典型流程：

/curdx:start <需求描述>
/curdx:plan
/curdx:execute
/curdx:status

安装后会做什么

curdx-ralph 会在当前项目里补齐工作流运行所需的最小配置：

• 生成 .claude/curdx-ralph.local.md
• 更新 .claude/settings.json，注册状态栏命令
• 确保 .mcp.json 中存在 Context7 和 chrome-devtools MCP 配置
• 启用插件内置 hooks，用于状态恢复、上下文监控和执行推进

如果项目已经有自己的 .mcp.json，安装器只补缺失项，不会覆盖你已有的 MCP 配置。

这意味着你不需要手工拼接一堆临时提示词或脚本，工作流可以直接跑起来。

核心命令

命令	用途
/curdx:start <需求描述>	智能路由入口。自动识别任务类型，进入完整规划流
/curdx:quick <小任务>	快速执行小改动，跳过规划，直接实现并做 L1 验证
/curdx:plan	查看、编辑、审批当前计划
/curdx:execute	按波次启动自主执行
/curdx:pause	手动暂停当前执行
/curdx:resume	在当前或新会话中恢复暂停任务
/curdx:status	查看当前阶段、波次进度、验证结果和上下文占用
/curdx:review [scope]	运行 AI 陪审团式代码审查
/curdx:config	查看当前项目配置摘要
/curdx:help	显示完整命令指南

一个更像真实开发的流程

小任务

/curdx:quick 修复支付回调里金额精度丢失的问题

适合：

• 单文件或少量文件
• 预期改动较小
• 不值得单独规划

大任务

/curdx:start 为后台管理系统增加角色权限模块

然后：

/curdx:plan
/curdx:execute

这个模式下，curdx-ralph 会先把需求拆成可执行任务，再按波次推进，并在每波后验证。

它的工作方式

1. 识别意图

任务会先被判断为 QUICK、GREENFIELD、BUG_FIX 或 REFACTOR，避免所有事情都套同一个流程。

2. 规划

复杂任务会生成 .plan.md，包含：

• 任务意图
• 技术栈
• 波次拆分
• 每个任务的 Do / Verify / Done-when

3. 执行

执行阶段会按波次派发子代理。没有依赖关系的任务可以并行推进。

4. 验证

每波执行后进入验证层，尽量在局部就把问题拦住，而不是把错误带到最后。

5. 恢复

如果因为上下文耗尽、验证失败重试耗尽或手动暂停而中断，可以用 /curdx:resume 接着跑。

适合什么项目

• 希望让 Claude Code 参与真实开发，而不是只做一次性代码生成
• 需要在执行前先规划，执行后再验证
• 需要可恢复、可追踪的任务状态
• 希望根据项目技术栈自动选择验证命令

当前支持的技术栈识别

• JavaScript / TypeScript
• Java
• Python
• Go
• Rust

并可自动推断：

• Framework
• Build tool
• Test runner
• Lint command
• Type check command
• 是否包含前端 / 后端

仓库状态

当前版本是 0.1.0。重点已经放在以下基础能力上：

• 任务入口与路由
• 规划和波次执行
• Hook 驱动的执行推进
• 状态追踪与恢复
• 分层验证

如果你想要的是一套能马上放进项目里试跑的 Claude Code 工作流，而不是一份“提示词集合”，这个仓库就是为这个目标设计的。

License

MIT