2026年9月4日

visual-maps 技能——无需加载全部内容即可导航 Datarim 流水线

visual-maps 技能如何提供基于片段的工作流图索引,使智能体只加载与当前问题相关的图,而非整个图库。

Datarim 为其流水线阶段、智能体关系、内容流和质量规则都配有图。若一次性全部加载,这些图会占用智能体本可用于实际任务的上下文。visual-maps 技能通过一个路由索引解决了这个问题:一段简短的入口,列出五个图片段,并告诉智能体哪个片段能回答哪个问题。

该技能用于定位方向,而非每项任务。当下一步显而易见时,没有理由加载它。当智能体需要理解自己在流水线中的位置,或两个命令之间的关系时,索引会提供精确的指引。

五个片段

第一个片段是 pipeline-routing.md。它涵盖整个 init → archive 流程中基于复杂度的路由,以及包含 v2.8.0 新增的 init-task、expectations 和 playwright-run 节点的产物流程。当问题是某项任务应遵循哪条流水线时使用它。

第二个是 stage-process-flows.md,涵盖从 /dr-init 到 /dr-archive 的各阶段特定流程,包括 Layer 3b 期望验证以及 /dr-qa 中的 Layer 4f playwright-run。当问题是某个特定阶段内部会发生什么时使用它。

第三个是 content-and-management-flows.md,涵盖 /dr-write、/dr-edit、/factcheck、/humanize、/dr-addskill、/dr-optimize 和 /dr-dream。用于内容创作、知识管理和优化流程。

关系与质量片段

第四个片段是 utility-and-dependencies.md。它包含命令与智能体之间的关系图,以及智能体到技能的依赖映射。自 v2.8.0 起,这包括 init-task-persistence、expectations-checklist、playwright-qa 和 human-summary 节点。当问题是命令与智能体如何连接,或某个智能体依赖哪些技能时使用它。

第五个是 panels-and-quality.md,涵盖 Consilium 面板布局以及阶段到质量规则的映射。用于理解 Consilium 的结构,或哪个质量规则适用于哪个流水线阶段。

为何采用路由索引而非单一图

该技能背后的设计决策在技能文件中明确表述:将无关的图加载到上下文中是一种浪费。一个询问“/dr-qa 中会发生什么?”的任务只需要一个片段,而非五个。索引条目本身足够简短,阅读无需成本,且选择指南将每种问题类型映射到单个片段名称。整个图库保持可寻址,而无需被推测性地加载。

阅读什么是 Datarim以了解更广泛的背景,或查看writing-plans 技能,了解在选定流水线路由后计划是如何构建的。