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 会回退到仅代码库研究,并将基于训练数据的发现标记为未经验证。
数据一览
| 组件 | 之前 | 之后 |
|---|---|---|
| 技能 | 21 | 22 |
| Agent | 16 | 17 |
| 命令 | 19 | 19 |
| 模板 | 12 | 13 |
一个新技能(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:记录嵌入式阶段
查看变更日志了解完整版本历史。