技能 Tech

可视化地图

Datarim 地图的可视化索引。先加载此条目,然后仅加载路由、阶段流程或依赖定位所需的图表片段。

概述

Visual Maps 提供 Mermaid 工作流图表,用于在 Datarim 流水线中进行导航和定位。它可视化按复杂度级别划分的流水线路由、阶段流程、命令与代理的关系、代理与技能的依赖关系,以及 Consilium 小组的组成。当代理需要理解路由或组件关系时按需加载。

片段路由

该技能拆分为 7 个聚焦片段:pipeline-routing(基于复杂度的路由)、stage-process-flows(/dr-init 到 /dr-archive)、content-and-management-flows(/dr-write、/dr-edit、/factcheck、/humanize、/dr-addskill、/dr-optimize、/dr-dream)、framework-architecture(生成的标准清单及显式的命令→代理 / 代理→技能关系 — 从不手工编辑)、command-dependencies(由 dev-tools/command-graph.yaml 生成的命令顺序)、utility-and-dependencies(面向人类的实用流程说明)以及 panels-and-quality(Consilium 小组与质量规则映射)。

流水线路由

一个可视化决策树,展示任务复杂度(L1-L4)如何决定流水线路径。1 级任务走最短路径(init、do、reflect、archive)。4 级任务遍历完整流水线,包括 PRD、设计、分阶段实现、QA 和合规阶段。可选阶段用方括号标记。

阶段流程

每个流水线阶段都有一个可视化流程:/dr-init 读取任务并按级别路由;/dr-prd 执行发现、生成方案并咨询用户;/dr-plan 拆解组件,并为 L3-4 设置策略师关卡;/dr-do 通过预检迭代实现;/dr-qa 运行四层验证;/dr-compliance 检测任务类型并应用类型专属检查清单。

组件关系

  • 命令-代理映射 — 每个 /dr- 命令由哪个代理处理,包括 L3-4 复杂度的辅助代理
  • 代理-技能依赖 — 19 个代理各自加载哪些技能(例如,architect 加载 cta-format、datarim-system、immutability、performance、security、tech-stack)
  • Consilium 小组 — 用于架构、代码设计、生产就绪、内容和知识讨论的预设代理组合

按阶段划分的质量规则

将 15 条 AI 质量规则映射到特定流水线阶段。例如,/dr-plan 应用规则 #1(桩实现)、#5(DoD)、#6(边界情况)、#7(骨架)、#11(边界)。/dr-do 应用 #2(TDD)、#3(方法大小)、#8(迭代)、#9(认知负荷)。

使用时机

按需加载,用于导航和定位。对于下一步显而易见的简单任务不加载。主要用于入门引导、调试流水线流程以及为框架编写文档。

4.2 中的报告连接

共享的 Human Outcome Reporting 契约将任务需求与计划、结果、验证和证据连接起来。/dr-explain 是只读的解释路径。发布模板与图谱使这些链接可被发现;项目脚手架现在使用 AGENTS.md 模板。