2026年4月23日

Datarim 1.15:研究阶段 — 构建前先了解

1.15.0 版本为流水线新增了结构化研究阶段。新的 researcher agent 会在规划开始前调查库版本、最佳实践和安全公告,并在实现过程中填补知识空白。

每位开发者都经历过这样的场景:你规划了一个功能,开始编码,进行到一半时才发现所选库的核心 API 两个月前已被弃用。或者你选的两个依赖互不兼容。又或者类似问题在项目的另一部分早已解决。

Datarim 1.15.0 通过一个结构化研究阶段解决了这个问题,该阶段在 /dr-prd 中自动运行。无需记住新命令。无需管理额外的流水线步骤。研究现已内置于你已经在使用的流程中。

工作原理

当你在 Level 2 或更高级别的任务上运行 /dr-prd 时,一个新的阶段 1.3 会在上下文分析和发现访谈之间激活。一个专门的 researcher agent 会调查外部上下文并生成洞察文档。

研究通过结构化清单进行:

  • 版本与依赖 — 你的技术栈当前稳定版本
  • 破坏性变更 — 迁移指南、已弃用的 API
  • 最佳实践 — 来自官方文档和社区的推荐方法
  • 技术栈文档 — 通过 context7 或网络搜索加载的相关章节
  • 架构模式 — 类似任务的参考实现
  • 兼容性 — 对等依赖冲突、运行时兼容性
  • 安全公告 — 依赖树中的已知 CVE
  • 过往经验 — 来自先前任务的相关经验教训(通过 LTM,如可用)
  • 现有代码库 — 项目中已有的可复用组件
  • 基础设施约束 — 端口、资源、服务器限制

Level 2 任务使用较轻量版本(5 个检查点)。Level 1 快速修复完全跳过研究。

洞察文档

研究结果写入专门的 datarim/insights/INSIGHTS-{task-id}.md 文件 — 与 PRD 分开。这一点很重要,因为 PRD 是冻结的需求文档,而洞察是活的产物,会在实现过程中不断增长。

阶段 1.3 之后的发现访谈会读取洞察文档,因此其问题和建议答案基于实际研究而非假设。

实现过程中的空白发现

研究不会在 PRD 阶段结束。当 developer agent 在 /dr-do 中遇到未知情况时 — 导入失败、意外的 API 行为、文档与现实不符 — 它会自动启动 researcher agent 来调查具体的空白。

发现结果会追加到洞察文档的“空白发现”部分。如果空白是根本性的(技术选择错误、需求不可能实现),agent 会停止并建议返回 /dr-prd。

这形成了闭环:研究在构建之前进行,新的未知情况会触发针对性研究,而无需离开实现流程。

自适应工具

researcher agent 可使用你环境中可用的任何工具:

  • context7 MCP — 令牌高效的库文档(首选)
  • WebSearch — 版本检查、CVE 查询、架构模式
  • 长期记忆(LTM)API — 来自长期记忆的过往任务经验
  • 代码库工具 — 始终可用:grep、glob、read 用于本地分析

不硬依赖任何特定的 MCP 服务器。如果没有可用的外部资源,agent 会回退到仅代码库研究,并将基于训练数据的发现标记为未经验证。

数据一览

组件之前之后
技能2122
Agent1617
命令1919
模板1213

一个新技能(research-workflow)、一个新 agent(researcher)、一个新模板(insights-template)。更新了八个现有文件。零个新命令 — 研究是集成进去的,而非硬加上去的。

设计决策:置于 PRD 内部,而非独立命令

我们考虑过添加独立的 /dr-research 命令。那将需要更新 5 个以上路由文件、改变流水线拓扑,并增加认知负担(操作者需要决定何时研究、何时继续)。相反,研究成为了 /dr-prd 的内部阶段 — 你已经在为需求运行的命令。流水线保持不变。研究自然发生。

完整变更列表

  • /dr-prd 中针对 L2+ 任务的研究阶段 1.3(<TASK-ID>)
  • /dr-do 中的空白发现步骤 7.5 — 遇到未知情况时自动启动 researcher(<TASK-ID>)
  • 新的 researcher agent(sonnet 模型,自适应工具)
  • 新的 research-workflow 技能(10 点完整清单,5 点轻量模式)
  • 新的 insights-template(7 个部分,包括空白发现)
  • /dr-plan 自动加载洞察文档作为上下文
  • 发现访谈在提出答案前读取洞察
  • 更新可视化地图:流水线路由、阶段流程、依赖图
  • 更新 path-and-storage:datarim/insights/ 目录
  • backlog-and-routing:记录嵌入式阶段

查看变更日志了解完整版本历史。