需求驱动开发 YaphetHayate/codeRDD

codeRDD — 需求驱动开发技能

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 动手开发前，必须先到项目代码里检索问题相关信息。多智能体场景下，各智能体的检索产物彼此独立，重复探索量很大；业界常见的代码图又有检索范围过大、重点模糊、维护困难、生成成本高、时效性低等问题——所以改用懒加载机制生成代码缓存 | 跨角色、跨会话复用的代码理解知识库——任一角色探索过的代码，其余会话直接命中复用（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 个宿主里，但只能取最低公分母：探索缓存只剩命令行一条腿，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 |
| 引擎命令行独立安装 | 只要 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)