Propose the RDM phase plan: direction, invariants, and stage gates
Why: The further-objective docs are now the system's next big-phase target; the plan pins the two-tree-one-net product on top of the generic platform with two hard invariants - downstream-only domain logic and always-degradable-to-generic-agent when the plugin is off. Evidence: docs-only change; milestone mapping verified against further-objective 10 (W1-W16), readiness claims verified against the pinned worktrees (EXT-1 symbols in surface.txt, v0.1.0 tags, RDM repo seed facts as recorded in vision doc 13). Impact: Adds one proposal; no code changes. Refs: docs/proposals/2026-10-07-agent-stack-n1q1i1-plans.md
This commit is contained in:
@@ -0,0 +1,195 @@
|
||||
# 研发记忆与体系文档智能体：大阶段目标与实施方案（RDM 阶段总案）
|
||||
|
||||
状态：**proposed（2026-10-07）**；owner：weichen；主任务：Dev 仓 `feature/rdm-phase-plan`。
|
||||
愿景依据：《智能体系统/further-objective》01–13（产品愿景文档，未入库；方案 10 已复制到下游仓 `Agent-System-RDM` 的 `docs/` 作奠基文档，本文以「愿景 01/02/03/04/08/10/11/12/13」引用）。
|
||||
上游：[2026-10-02-agent-stack-completion.md](2026-10-02-agent-stack-completion.md)（库分期）、[2026-10-07-agent-stack-n1q1i1-plans.md](2026-10-07-agent-stack-n1q1i1-plans.md)（N1/Q1/I1 实施方案）。
|
||||
规范依据：Development-Guidelines（workflows/delivery.md、standards/collaboration.md、standards/verification.md）；本文是项目级消费，不复制其正文。
|
||||
|
||||
本文把 further-objective 描述的最终系统立为本系统下一个大阶段的目标，设定大方向与架构不变量，给出里程碑对齐的实施方案。本文不实施代码；各阶段的实现各走各的任务卡。
|
||||
|
||||
---
|
||||
|
||||
## 1. 大方向与大目标
|
||||
|
||||
### 1.1 一句话目标
|
||||
|
||||
把通用智能体基座二次开发为「**面向医疗器械研发企业的研发记忆与体系文档智能体**」：把项目全周期的一切资料持续沉淀为可追溯的研发记忆，让体系文档随项目推进渐进式清晰，并以人在环路的确认机制保证每一步受控（愿景 02 §1）。产品形态为三栏 + 卡片流 + 弹出层（愿景 05/06），数据心智为两树一网：笔记树 + 文档树 + 追溯网（愿景 08）。
|
||||
|
||||
按新口径里程碑推进（愿景 10 §10.1，W1 = 2026-10-05~10-11）：
|
||||
|
||||
| 里程碑 | 窗口 | 内容 |
|
||||
|---|---|---|
|
||||
| MS0' | W1（本周） | 需求定稿、双仓就位、决议闭环、v0.1.0 评估基线 tag |
|
||||
| v0.2.0 发版 | W2 末，最迟 W3 末（10-25） | 基座含 EXT-1，SurfaceVersion 2.0.0-experimental |
|
||||
| MS1 | W4（11-01） | 上传五步法 + 两速入库端到端 |
|
||||
| MS2 | W7（11-22） | 文档基线 + 三分类比对 + 版本链 |
|
||||
| MS3 | W11（12-20） | 两树一网 + 变更闭环 + 一键生成（结构事件日志先行） |
|
||||
| MS4 | W16（2027-01-24） | 自举全程运行、可对外演示（依赖 EXT-3 渠道） |
|
||||
|
||||
### 1.2 三条架构不变量（大方向的约束）
|
||||
|
||||
**INV-1 双仓纪律（二次开发原则）。** 领域逻辑（两树一网、模板、流程骨架、法规双通道、上传管道）只住在下游仓 `Agent-System-RDM` 与声明式插件规格里；基座（本仓五仓组合）只经「**扩展点申请 → 基座实现并发版 → 下游升级**」演进（愿景 10 §1.1、§七.1）。下游只 import `pkg/extension` 与 core 类型、不碰 internal；改基座 internal 的补丁一律拒绝。
|
||||
|
||||
**INV-2 可退化不变量（退回通用智能体）。** RDM 的一切能力——命令处理器、意图规格、工作流、技能、页面、卡片、任务——以插件/声明式规格为唯一承载形态，挂在一个装载开关下。**禁用（或移除）RDM 插件时，系统行为恒等于基座发布物本身**：RDM 路由回落到普通回合、命令/页面/卡片不出现、既有通用场景全通。数据不删（下游自有库表，schemaVersion 自管迁移），重新启用即恢复可见。基座仓的任何 diff 不得出现 RDM 领域字样，评审与 CI 双重检查（见 §3.2）。
|
||||
|
||||
**INV-3 证据与验收纪律。** 沿用 AGENTS.md「证据与验证门禁」：声明 ≠ 能力，每个里程碑的验收都是命令 × 对象 SHA × 可复核输出；任务卡、PR、证据收据随分支走；CI（PR HEAD 上 `make test`+`make build`）是测试通过的权威源。
|
||||
|
||||
### 1.3 与库分期（基座演进线）的关系
|
||||
|
||||
库分期（N1/Q1/I1 → N2/N3/Q2/Q3/I2）是「小队骨架执行、意图分层识别（规则→语义→LLM 的快慢分层）、恢复可靠性」的地基，**服务 RDM 但不阻塞 MS1**。它们的第一批真实消费者：
|
||||
|
||||
- MS3 一键生成 ← Q1 图执行、Q3 编排收敛（愿景 03 F4、M10）；
|
||||
- 意图命令化与快慢分层（愿景 03 交互与意图层）← I1/I2；
|
||||
- 长任务可恢复（愿景 SR-E5/F4 长任务异步）← N3、Q1。
|
||||
|
||||
排布原则：库分期按既定方案推进（N1 → Q1/I1 并行 → 后续），在 MS3 窗口前给出最迟合入点（§4.4）。
|
||||
|
||||
---
|
||||
|
||||
## 2. 现状基线（2026-10-07 实测）
|
||||
|
||||
### 2.1 已就位
|
||||
|
||||
| 项 | 状态 | 证据/位置 |
|
||||
|---|---|---|
|
||||
| 基座平台层 | 会话/工件/卡片/HITL/任务/审计、混合检索（向量 RAG + RRF）、PG 多租户档、认证、限流、多实例地基 | modules/backend（dual-tier 阶段 0–3 已合入） |
|
||||
| EXT-1 进程内命令处理器 + owner 作用域宿主句柄 | 已合入 main，**MS1 阻塞项解除** | Dev #207/#209；`pkg/extension/surface.txt` 含 `Handler`/`Host`/`Host.ArtifactContent`/`Host.Audit`/`Host.Complete`/`Host.KVGet` 等符号 |
|
||||
| EXT-5 宿主文档解析 | 已合入 main（含宽列修复） | Dev #222/#224 |
|
||||
| 界面形态 | 三栏 + 卡片流 + 弹出层、收件箱双现投影、交付物卡片与 docx 预览 | modules/frontend、modules/ui（与愿景 05/06 V2.2 原型一致） |
|
||||
| 下游仓 | `Agent-System-RDM` 已建仓，种子可编译（29MB 二进制），pins 落位（backend cb26e4c / core 0b5c774 / frontend 50c7244 / ui 27d5adb），8 条 deps replace 就位 | 愿景 13 建仓实录 |
|
||||
| v0.1.0 评估基线 tag | Dev / Documents / Backend / Core 等仓 tag 已打（backend 已 +4 提交） | 各仓 `git tag -l v0.1.0` |
|
||||
| v0.2.0 前置 | EXT-1 已合入；surface.txt 符号齐；EXT-1 提案已对齐 tag 名与 SurfaceVersion 2.0.0-experimental 兼容承诺 | 愿景 12 核对清单逐项可勾 |
|
||||
| 库分期 | R0/R1/R2/D1 已合入；N1 进行中（WP2/WP3 两增量 PR 已开：Agent-Native #17、Backend #69，CI 绿） | 2026-10-02 总提案 §5 |
|
||||
| 本大阶段的输入 | N1/Q1/I1 实施方案已评审合入 | Documents #40 / Dev #226 |
|
||||
|
||||
### 2.2 缺口
|
||||
|
||||
| 缺口 | 性质 | 影响 |
|
||||
|---|---|---|
|
||||
| v0.2.0 未发版 | owner 双钥匙动作（tag/push） | 下游升级、MS1 依赖的基座面定型；窗口 W2 末–W3 末（10-25 前） |
|
||||
| MS1 下游功能为零 | 下游开发未开始 | **当前真实关键路径**（W4=11-01，余约 3.5 周） |
|
||||
| O1/O3/O7 组织阻塞 | 评审会产出（权威文档树、标签字典、人选名单） | MS0' 退出条件；O3 阻塞 MS1 阶段映射 |
|
||||
| 库分期 N1 剩余、Q1/I1 未启动 | 基座演进 | MS3 一键生成与意图分层的前置 |
|
||||
| EXT-3 渠道未申请 | 基座扩展点（申请截止 W10 前） | MS4 飞书群入口 |
|
||||
|
||||
---
|
||||
|
||||
## 3. 架构裁定
|
||||
|
||||
### 3.1 二次开发的承载形态（三级，主辅保留）
|
||||
|
||||
| 级 | 形态 | 用在哪 |
|
||||
|---|---|---|
|
||||
| A 进程内编译（主） | 下游仓 import `pkg/extension` + core，实现 EXT-1 `Handler` 命令处理器、`Host` 句柄消费（KV/audit/llm/knowledge search+write(embed)/tasks 台账/artifacts）、页面 SDK | RDM 命令（上传管道、入库、生成、变更）、知识写入、结构事件日志、页面 |
|
||||
| B 声明式规格（辅） | intents / workflows / skills / 页面规格文件，插件目录装载 | RDM 意图（闲聊/澄清/取消等命令层消费）、流程骨架 YAML、技能 |
|
||||
| C sidecar（保留） | 独立进程，经命令总线/工具被调 | 格式解析器（office/xlsx 深解析）、EXT-3 渠道执行体 |
|
||||
|
||||
**裁定**：能用 A 就不用 C；解析器默认走「sidecar 工具或 LLM 抽取」，EXT-4（进程内解析器注册）不提交（愿景 10 §1.5）。
|
||||
|
||||
### 3.2 可退化机制（INV-2 的工程形态）
|
||||
|
||||
**装载开关**：RDM 插件的一切装载点——命令 Handler 注册、意图 spec、工作流定义、技能目录、页面路由、卡片投影——收在一个开关下（建议设置键 `plugins.rdm.enabled`，默认开启；缺省/禁用 = 通用基态）。禁用语义是**装载期跳过**，不是运行时逐点判断：装载器在开关关闭时不注册任何 RDM 项，路由自然回落到基座既有 fallback（普通回合）。
|
||||
|
||||
**通用基态的判定**（机器可核对）：
|
||||
1. 禁插件启动后，通用场景 e2e 全绿（对话、工具、工件、卡片、HITL、工作流 demo 插件）——复用 backend 现有 e2e 套件在禁用态重跑；
|
||||
2. RDM 命令返回未知命令、RDM 页面 404、收件箱无 RDM 投影卡；
|
||||
3. 基座仓 diff 检查：任何 PR 的基座改动不含 RDM 领域标识（词表黑名单进 design-guard 类守护，或评审核对项）；
|
||||
4. 数据共存：禁用不触发任何删表/删数迁移；重新启用后 RDM 视图恢复原状（下游测试覆盖）。
|
||||
|
||||
**测试形态**：下游仓测试套件固化「禁用态 e2e」一项；基座 CI 天然成立（基座不依赖下游，永远可独立构建测试）。
|
||||
|
||||
### 3.3 扩展点申请流程（缺口 → EXT）
|
||||
|
||||
下游发现基座面缺口时的唯一合法路径（愿景 10 §七.1）：
|
||||
|
||||
1. 下游在任务卡里写明缺口（要的符号、语义、阻塞什么里程碑）；
|
||||
2. 基座侧建 EXT 申请卡 → 评审（是否属于通用能力、SurfaceVersion 影响）→ 基座实现并随下一段发版（v0.2.0 之后按 v0.3.0/v0.4.0… 节奏，同样走 12 号清单核对）；
|
||||
3. 下游升级动作：pins bump + go.mod replace 切回 tag pin（合入前必须切回，愿景 13）。
|
||||
|
||||
已在案的扩展点：EXT-1（已落地）、EXT-3（渠道，W10 前申请，阻塞 MS4）、EXT-4（备选，默认不提交）。预计 MS1–MS3 期间可能出现的新需求（知识写入完整集、页面 SDK 增补、审计结构事件扩展）按本流程逐案评审，不预设全部进基座。
|
||||
|
||||
### 3.4 数据模型落地裁定
|
||||
|
||||
- 两树一网（笔记树/文档树/追溯网）在下游自建库表、schemaVersion 自管迁移（D-R1 选 A，愿景 10）；基座 core 不加领域实体。
|
||||
- **R3-1 结构事件日志最先做**（愿景 10 §五：「追溯网地基」，SR-G5 五硬规则：原文 append-only、软删除、边候选→生效→废止、统一结构事件日志、时间点可重建）。裁定：下游自管事件日志与重放，基座通用审计接口（`Host.Audit`）只写动作审计，不为结构追溯进基座。
|
||||
- 标签字典是两树唯一接口语言（愿景 08 §四）；字典实体为项目级资产、版本化，住下游；其字段集与取值枚举依赖组织项 O3，MS1 前先以草案字典起步（见 §5 风险 R-1）。
|
||||
|
||||
---
|
||||
|
||||
## 4. 阶段方案（里程碑对齐）
|
||||
|
||||
每阶段给出：下游工作项 / 基座支撑项 / 组织依赖项 / 验收（机器可核对）。编号 R 沿用愿景 10。
|
||||
|
||||
### 4.1 阶段 P0：MS0' 收尾与发版（W1–W3，当前窗口）
|
||||
|
||||
- 下游：R0 奠基——文档树模板注册表骨架（阶段→文档→章节）、UR/SR 条目化导入需求大表雏形、建仓自检（`go test .` + link 构建）随仓常驻；奠基文档（方案 10）已就位。
|
||||
- 基座：v0.2.0 发版（owner 双钥匙，按愿景 12 清单：core 三处同 SHA、五仓 tag 指向一致、tag 消息固定文案）；N1 合入链走完（Agent-Native #17 → Backend #69 → Dev gitlink PR）并完成 N1 剩余（WP1 AgentSpec、WP4 guardrail、WP5 下沉、WP6 装配与 A/B）。
|
||||
- 组织项（MS0' 退出条件，非代码）：01 升 V2.0 定稿；O1/O3/O7 决议闭环；D-R1/D-R2 决议在案；EXT-1 申请卡已受理（已合入可视为闭环）；code review 机制首运行台账。
|
||||
- 验收：v0.2.0 五仓 tag 就位且指向一致（命令：各仓 `git tag` + Dev gitlink 比对）；N1 三段 PR 合入且 CI 绿；下游种子构建通过。
|
||||
|
||||
### 4.2 阶段 P1：上传五步法 + 两速入库（W4 = MS1，11-01）
|
||||
|
||||
上传五步：接入 → 相关性判定 → 结构化解析 → 阶段映射与标签 → 两速入库（愿景 03 F1、04 T1-x、10 §三）。
|
||||
|
||||
| 工作项 | 内容 | 承载形态 |
|
||||
|---|---|---|
|
||||
| R1-1 上传接入 | 复用基座工件/上传端点；渠道记录（SR-A3）留 P1 后 | A（下游命令） |
|
||||
| R1-2 相关性判定 | 三态（相关/不相关/存疑），存疑挂起确认前不入库（SR-B1） | A |
|
||||
| R1-3 结构化解析 | 拆解为切片：原文锚点 + 结构化字段；office 深解析走 sidecar 工具或 LLM 抽取（EXT-4 不提交） | C 辅 |
|
||||
| R1-4 阶段映射与标签 | 按标签字典映射阶段/工作事项/主题簇，生成标签 JSON（M3 schema）；字典草案先行，O3 闭环后替换 | A + 字典资产 |
|
||||
| R1-5 两速入库 | **快通道**：60 秒首轮反馈——标签、锚点、一句话摘要即时可见；**慢通道**：向量与深度补齐异步走 EXT-1 `KnowledgeWrite(embed)` 句柄（意图分层「快规则/慢模型」之外产品的第二条快慢线） | A（慢速经 EXT-1 句柄） |
|
||||
| R1-6 入库完整性 | 失败显式告知、原件可取回、禁静默降级（SR-A5）；三类负例（报价单 Excel/图文 PPT/构造解析失败）回归 | A + 测试 |
|
||||
|
||||
- 基座支撑：v0.2.0 已发版（前置）；`Host` 完整集（含 artifacts 写入）如 MS1 实测不足，走 §3.3 申请进 v0.3.0。
|
||||
- 验收（对齐愿景 10 §三 7 条）：上传五步法端到端跑通（三类真实文件）；60 秒首轮反馈实测；存疑挂起确认前库中无记录；标签+锚点在界面可见；SR-A5 三负例回归；**SR-E6 双入口同源早期证据**（页面/对话两个入口同一命令处理器实测）；PG 多用户档身份贯通烟测（D8）。
|
||||
|
||||
### 4.3 阶段 P2：基线 + 三分类 + 版本链（W7 = MS2，11-22）
|
||||
|
||||
- 下游：文档状态机（草稿→评审中→已基线→变更中→新版本）；三分类比对引擎（新增/更新/冲突）；版本链可溯；基线直改被拒；缺项提示只在评审/推进两触发点出现（SR-C5，上传节点禁止）。
|
||||
- 基座：无新需求预期；卡片/HITL 复用。
|
||||
- 验收（10 §四 R2-1~R2-5）：状态机迁移合法集测试；三分类对同一文件两版比对正确分类；版本链从任一章节回指到切片锚点；基线直改返回结构化拒绝；上传节点界面无缺项提示。
|
||||
|
||||
### 4.4 阶段 P3：两树一网 + 变更闭环 + 一键生成（W11 = MS3，12-20）
|
||||
|
||||
| 工作项 | 内容 | 依赖 |
|
||||
|---|---|---|
|
||||
| R3-1 结构事件日志 | **最先做**：SR-G5 五硬规则全落地；时间点可重建（事件重放 + 周期快照） | 无（下游自管） |
|
||||
| R3-2 追溯网 | 切片↔需求↔章节↔法规↔用例 有向边；模型候选边人工转正 | R3-1 |
|
||||
| R3-3 需求大表 | UR/SR 版本化条目；变更风险提示 | R3-1 |
|
||||
| R3-4 变更闭环 | 检测→影响分析→变更单七步→回写留痕；影响已基线内容的结构变更强制走变更流程 | R3-2 |
|
||||
| R3-5 一键生成 | 编写意图确认→小队骨架执行→逐节标源（无素材明示空缺不编造）；一拉一推（章节条件检索笔记树 / 切片标签映射文档树） | **基座 Q1/Q3、I1**（小队骨架与意图命令化）；标签字典 |
|
||||
|
||||
- 基座支撑（**最迟合入窗口：W9 末**）：Q1 图执行合入、I1 命令化合入（退化路径：R3-5 先用流程骨架 YAML + 现有小队 standard 模式实现，不强等 Q3 编排收敛；该降级在愿景 03 F4 允许范围内，需任务卡明示）。
|
||||
- 验收（10 §五）：结构事件日志对两树一网增删改全程留痕且可重建指定时点；变更七步闭环跑通一次真实变更；一键生成产出的每个章节带切片级来源标注，无素材章节明示空缺；追溯链报告可导出。
|
||||
|
||||
### 4.5 阶段 P4：自举与演示（W16 = MS4，2027-01-24）
|
||||
|
||||
- 下游/联合：自举 B1–B7（元项目常驻 → 纪要入库 → 本批文档入库 → UR/SR 全部进需求大表 → 一句话生成自身可行性报告 V1 → 用系统管本计划执行 → 每周复盘）；EXT-3 渠道（飞书群收文件/推送，申请截止 W10 前，基座实现随当段发版）；测试群反馈闭环率 ≥80%。
|
||||
- 基座支撑：EXT-3（W10 前受理）；N2/N3/Q2 按实际拖累点排期；I2 语义端口（意图慢通道）如被意图误触发率卡脖子则提前。
|
||||
- 验收：自举项目全程在系统内运行（纪要入库→可行性报告→追溯链导出，无系统外补录）；反馈闭环率统计达标；owner 认定可对外演示。
|
||||
|
||||
---
|
||||
|
||||
## 5. 风险与缓解
|
||||
|
||||
| # | 风险 | 缓解 |
|
||||
|---|---|---|
|
||||
| R-1 | MS1 时间紧（余约 3.5 周）且 O3 标签字典是组织阻塞 | 字典草案先行（下游资产、可迭代）；O1/O3/O7 列入 MS0' 评审必须产出的一句话（愿景 11 阻塞项表），评审前下游不赌字典内容 |
|
||||
| R-2 | 一键生成依赖基座 Q1/Q3 进度 | 设 W9 末最迟窗口 + 降级路径（YAML 骨架 + standard 模式，§4.4）；库分期优先级因此把 Q1 排在 N2/N3 之前 |
|
||||
| R-3 | 可退化不变量被侵蚀（领域逻辑渗入基座） | INV-2 的装载点集中 + 禁用态 e2e（下游常驻）+ 基座 diff 领域词黑名单检查（进评审核对项，必要时落 design-guard 类守护） |
|
||||
| R-4 | 双仓 pin 漂移 / replace 忘切回 tag | 愿景 13 规则进下游 AGENTS.md；基座 R0 检查脚本已核对 backend deps 与 Dev 指针；下游 pins 自检进 CI |
|
||||
| R-5 | EXT 申请节奏跟不上下游需求 | 缺口提前在任务卡登记（§3.3 第 1 步），发版节奏按里程碑倒排（v0.3.0 对准 MS2/MS3 之间） |
|
||||
|
||||
## 6. 不在本方案范围
|
||||
|
||||
- 医院端产品与行业输出的远期步（愿景 02 §7 路径第 ③④ 步）。
|
||||
- 模型无关性的完整抽象（SR-N5，P2 远期）；token 成本测算口径（待组织认可，愿景 11 #14）。
|
||||
- 微信等飞书以外的渠道（前瞻）。
|
||||
- 下游仓内部的详细任务分解（本方案是总案；下游按 §4 的阶段在 RDM 仓立各自任务卡，引用本文）。
|
||||
|
||||
## 7. 验收（本文）
|
||||
|
||||
- 大方向与三条不变量（INV-1/2/3）表述无歧义，可落成检查项。
|
||||
- §4 五阶段与愿景 10 §10.1 里程碑逐条映射；每阶段验收均为机器可核对形式；组织项与代码项分列、不混淆。
|
||||
- 可退化机制（§3.2）给出判定与测试形态，能直接派生下游测试任务。
|
||||
- 与既有方案无冲突：库分期按 2026-10-07 N1/Q1/I1 方案继续；本文只在其上排布消费者与窗口。
|
||||
Reference in New Issue
Block a user