2026年8月21日

研究工作流技能——规划前的结构化调查

Datarim 的 research-workflow 技能为智能体提供了一套 10 个检查点的方法论,用于在实施前调查外部上下文——以及当构建中途出现未知情况时的缺口协议。

基于假设行事代价高昂。research-workflow 技能正是 Datarim 对一种反复出现的成本的回应:在实施中途才发现某个库版本不对、某个 API 端点的行为与文档所述不符,或者计划中假定已存在的组件实际上并不存在。该技能将外部调查结构化,使这些发现发生在编写代码之前。

该技能以两种主要模式运行。完整模式适用于功能开发、新系统或涉及不熟悉技术的任务——它涵盖全部 10 个研究检查点。精简模式适用于大部分上下文已知的增强任务——它运行 10 项中的 5 项。快速修复则完全跳过研究。

10 个检查点

这些检查点涵盖:当前稳定版本和近期主要版本发布;当前版本与目标版本之间的破坏性变更和已弃用 API;官方指南中的推荐做法;任务技术栈中的相关文档章节;类似实现和参考架构的示例;组件兼容性;依赖项的已知 CVE 和安全公告;来自项目长期记忆存储的过往经验;现有代码库中的可复用组件;以及基础设施约束——服务器资源、端口分配、网络拓扑。

工具选择是自适应的。如果 context7 MCP 可用,它能最高效地处理库文档。如果网络搜索可用,它负责版本检查、CVE 查询和架构模式。如果两者都不可达,该技能回退到使用 grep、文件读取和 git 历史进行代码库分析,并将这些检查点标记为 [OFFLINE — based on local context only]。

缺口协议

规划前的研究并不能消除所有未知。该技能还有第二个功能:当实施遇到障碍时使用的缺口发现协议。触发条件是具体的——导入意外失败、API 返回意外的响应结构、缺少必需的功能、组件被证明不兼容。当任一触发条件出现时,开发智能体暂停,生成一个专注的研究子智能体,并等待调查结果后再继续。

如果缺口是根本性的——技术选型错误、需求不可能实现、架构不兼容——实施完全停止。缺口被记录,并要求操作员运行 /dr-prd 来修订需求。该技能明确指出:不要为根本性缺口尝试变通方案。

预检产物发现

计划会漂移。在 /dr-plan 和 /dr-do 之间,较早的任务可能已经交付、模式可能已经改变、基础设施资源可能已被重命名。该技能包含一个用于 /dr-do 开头的预检流程:枚举计划中命名的产物,逐一对照其当前实际状态进行验证,并与计划的假设进行比较。随之产生三种结果——匹配(继续)、已完成(跳过该步骤)或漂移(记录并调整方向)。

该技能历史中的一个真实事件:一个计划要求采用某种集成方案;预检发现较早的任务已经交付了替代方案。遵循原计划将会丢弃可用的代码。调整方向被记录在洞察文件中;第一阶段的工作量从计划的 1–2 天降至约 2 小时。

经验性提供商验证

当任务引入或替换第三方端点时,必须在任何代码依赖它之前通过真实请求确认契约。该技能要求发送最小的有效请求,以实际输入格式进行验证——包括内容类型、认证头以及任何供应商特定的标志——并将成功响应和错误响应都捕获为测试夹具。文档会漂移;一次三分钟的 curl 探测可以替代未知数量的实施中途重写。

研究发现保存在 datarim/insights/INSIGHTS-{task-id}.md 中。阅读 Datarim 是什么了解完整流水线,或查看 reflecting 技能了解已完成任务的洞察如何反馈到框架演进中。