codeRDD — Requirement-Driven Development Skill
SDD(规范驱动开发)理念的多角色 AI 开发工作流系统:8 个角色技能卡 + rdd-engine 能力总线,把 Vibe Coding 升级为「有角色、有阶段、有门禁、可回溯」的工程化流水线。平台无关——同一套角色卡挂载到 OpenCode / Claude Code / ZCode / Codex / Warp,DSH 宿主另获插件级增强。
设计理念
围绕一个核心管道展开:
要做什么? → 要怎么做? ↔ 做 ↔ 验证 → 评价
阶段与角色映射
| 阶段 | 问题 | 角色 | 说明 |
|---|---|---|---|
| 定义 | 要做什么? | PM | 需求定义、场景拆分、优先级排序 |
| 设计 | 要怎么做? | CTO + UX | 技术方案 + 视觉/交互设计 |
| 实现 | 做 | DEV | 任务拆解、并行开发、代码审查 |
| 验证 | 验证 | QA | 独立测试、质量验证 |
| 评价 | 评价 | EVAL | 交付质量评估、协作效率复盘 |
| 审视 | 事前把关 | AUDITOR | 上游产物独立审视(需求集/设计汇聚进建树/实现前) |
| 呈现 | 怎么讲? | PSE | README 维护、项目上下文文档生成 |
AUDITOR 与 QA / EVAL 的定位差异:AUDITOR 是独立于 QA 的事前把关角色,审视结论进入流转;EVAL 是事后回顾,报告不进流转。
核心迭代关系
- 要怎么做? ↔ 做:设计与实现双向反馈 — 设计指导实现,实现中发现的问题反馈优化设计
- 做 ↔ 验证:实现与验证双向迭代 — 测试发现的问题驱动修复,修复后重新验证
角色之上另有规划者(PLANNER)——引擎编排形态而非角色卡,承担长程任务的树形编排(见 goal-tree)。
核心能力
rdd-engine 是能力总线,以下能力各自独立成篇详写:
| 能力 | 场景(为什么) | 一句话(怎么解决) | 详见 |
|---|---|---|---|
| 探索缓存 | LLM 执行开发工作前必须在项目代码里检索问题相关信息,多 agent 场景下各 agent 的检索产物彼此独立,涉及大量重复探索;业界常见的代码图又存在检索范围过大、重点模糊、维护困难、生成成本高、时效性低等问题——故采用懒加载机制生成代码缓存 | 跨角色/跨会话复用的代码理解知识库——任一角色探索过的代码,其余会话直接命中复用(BM25 + 向量双路召回 → RRF 融合);未命中自动派探索 worker 调查并注册回缓存 | docs/exploration-cache.md |
| goal-tree 目标树 | 长程大任务无法在单次对话里扛完:上下文随轮次膨胀直至溢出、计划在长对话中漂移失焦;多 Worker 并行时人工编排易重复消费同一事项、预算失控,中断后状态全丢无法续跑;常见的「单会话长提示 + todo 清单」又没有依赖 DAG、认领互斥、预算上限、断点续跑等语义——故以持久化状态机承载树形编排 | 长程任务的 Plan-and-Execute 树形编排:规划者拆目标为节点树、多 Worker 会话并行认领、回报裁定闭环;预算三上限机械强制、中断可续跑、终局必出结案报告;delivery-bridge 把归档任务集树化交付 | docs/goal-tree.md |
| 运营端 | 全链路数据虽已落盘可审计,但都是为机器设计的原始 JSON/JSONL,「命中率多少、哪些 query 高频 miss、交付树推进到哪」这类问题只能逐文件翻查;引入外部 BI/日志平台又需额外部署管道,与本地优先、零依赖的定位冲突——故做零依赖的本地看板直读落盘数据 | 零 npm 依赖的本地只读看板(ops-dashboard.cmd):需求归档 / 探索缓存 / 命中率 / 检索质量 / tips / 交付树 / 配置中心七个数据域 + 受控配置写面 |
docs/ops-dashboard.md |
| DSH 适配 | 中立挂载让同一套角色卡活在 5 个宿主里,但只能取最低公分母:探索缓存只剩 CLI 一条腿、goal-tree 运行状态无处呈现、角色交接退化为开新终端;为每个宿主单独做集成又必然重复实现、各自漂移——故为插件/会话/preset 机制最全的 DSH 做单一最深适配 | DeepSeek Harness 宿主的增强套件:rdd-explore 插件(模型工具)/ goal-tree 状态条插件(回调自动唤醒)/ 9 组角色 presets / start-role 三后端判据链 | docs/dsh-integration.md |
三者与角色流转(rdd-flow)的关系:探索缓存、goal-tree、task.json 流转三重正交(目录/命令/数据零共享),delivery-bridge 是唯一受控交汇。
安装
五种形态速查(完整操作、布局规则与维护者发布流程见 docs/installation.md):
| 形态 | 适用 | 入口 |
|---|---|---|
| DSH 一体化安装(主入口) | 标准 DSH 用户,一条命令装齐 engine + 插件 + 技能 | install-rdd.ps1 统一安装器(GitHub Release) |
| 源码安装(推荐) | 开发者/贡献者,改源码即时生效 | 仓根 npm run register → 目标项目 coderdd init . |
| npm 安装(规划中) | 待发布 | npm i -g coderdd |
| 引擎 CLI 独立安装 | 只要 rdd-engine 命令行 | rdd-engine.tgz + install-rdd-engine.ps1 |
| 角色体系用户级安装 | 只要 9 技能 + 9 组 presets | rdd-skills.tgz + install-rdd-skills.ps1 |
运行时依赖:Node.js 18+(仅安装器);git 可选——缺失或非 git 仓时引擎按五级定位链降级,非 git 项目全量可用(协议见 rdd-engine/references/engine-location.md)。
使用方式
角色通过 skills 激活(OpenCode / ZCode / Codex / Warp 经 .agents/skills/、Claude Code 经 .claude/skills/ 发现,实际内容都在 .rdd/skills/ 唯一真实源;用户级安装形态则位于 $DSH_HOME\skills\rdd-*)。每个角色在自己的会话里工作;切换角色时开新会话以保证上下文纯净。
角色入口命令
/rdd-pm— 需求定义(流程起点,无交接包)/rdd-cto— 技术架构/rdd-ux— 视觉/交互设计/rdd-dev— 开发实现/rdd-qa— 测试验证/rdd-eval— 交付评价/rdd-auditor— 上游产物独立审视(事前把关:归档需求集/设计汇聚建树前;与 EVAL 事后回顾定位不同)/rdd-pse— 文档维护
角色切换流程
上游角色完成产物归档后,按 transition-guide 的 4 步硬流程交接(命令均经引擎三级定位链定位 $rdd,此处以 rdd-flow / start-role 代指):
rdd-flow set-route(推进 task.json 路由到下游角色:阶段内收窄不带 -Phase,跨阶段切换显式 -Phase)
→ rdd-flow next(展示可流转角色与任务数)→ 推荐目标角色,请用户确认
→ start-role.cmd -Role <角色> -TaskId <n>
脚本按判据链(RDD_RUNTIME → DSH_WEB_URL → CLI)自动选后端:
Plus 自动建对话驱动目标角色 / DSH 自动建会话并投递交接指针 / CLI 自动开新终端窗口预填 /rdd-<角色> 入口
角色切换必须开新会话:agent 无法在同会话内真正隔离上下文,上游长对话会污染下游——start-role 各后端都以新会话承载交接。协议细节见
rdd-engine/references/transition-guide.md。
工作流怎么跑
第一步永远是 PM:描述需求后,PM 先与你确认需求全貌,再做任务拆解。拆解后按规模分流:
- 小任务 → PM 直接路由给 CTO(需技术决策)或 DEV(L1 简单需求可直达),再按阶段流转到 QA 验收
- 大任务 → PM 推送给 PLANNER,由规划者把需求树化为目标树:自动拆解节点 → 调度多角色会话并行认领 → 回报裁定 → 集成联调 → 整体验收;中断可续跑、预算可封顶,终局出结案报告
无论走哪条路,四条机制不变:阶段产物落盘可审、QA 独立验收(DEV 无提交权)、切换角色开新会话、代码理解沉淀进探索缓存跨会话复用。一个大任务的完整树编排实战见 docs/case-ops-dashboard.md。
项目结构
codeRDD/
├── rdd-engine/ 能力总线:PowerShell CLI 家族(goal-tree / delivery-bridge / explore /
│ rdd-flow / start-role / tips / code-metrics)+ 运营看板(dashboard/,
│ 自含启动入口 dashboard.cmd)+ 协议文档唯一权威源(references/)
├── rdd-<role>/ ×8 角色技能卡(pm/cto/ux/dev/qa/eval/auditor/pse),SKILL.md 单一事实源
├── dsh/ DSH 适配:dsh-rdd-explore 插件 / rdd-goal-tree 状态条插件 / presets 生成物
├── src/ coderdd 安装器 CLI(TypeScript:init / update / uninstall)
├── bin/ coderdd 命令入口
├── scripts/ 构建 / 发布 / 安装脚本(build-*.mjs、install-rdd*.ps1、update-projects.ps1)
├── docs/ 项目文档(安装指南 / 各能力子文档 / code-quality.md / 项目介绍材料)
├── dist/ 构建产物(engine / plugin / skills tarball,发布通道)
└── .rdd/ 本仓自用运行时数据(探索缓存 / goal-trees / changes 归档 / tips)
No comments yet. Be the first to write one.