datarim-system 技能——每个 Agent 首先加载的核心规则
深入解析 datarim-system 技能——这个始终加载的规则集定义了 Datarim 状态存放位置、任务文件的结构,以及 Agent 如何解析路径和加载顺序。
在任何 /dr-* 命令执行任何操作之前,它都会先读取 datarim-system。该技能是基础层:它定义了工作流状态存放的位置、操作文件必须呈现的形态,以及框架如何解析路径和技能加载顺序。其他所有技能和每个 Agent 都将其视为前提条件。
操作文件是索引,而非内容
该技能的核心规则是:tasks.md、backlog.md 和 activeContext.md 都是索引。每个列表项行只回答四个问题——哪个任务、什么状态、什么复杂度级别、描述文件在哪里——除此之外别无其他。位于 datarim/tasks/{TASK-ID}-task-description.md 的任务描述文件承载所有实际内容:概述、验收标准、约束、范围外说明以及相关引用。
有两个文件已被明确废除。progress.md 自 v1.19.0 起不再存在——每个任务的进度记录应放在描述文件的 Implementation Notes 部分。backlog-archive.md 在 v1.19.1 中被废除——已完成和已取消的任务记录存放在 documentation/archive/ 中,而不是放在 Agent 每次调用都会读取的滚动文件中。
路径解析
该技能定义了严格的路径解析规则。Agent 解析物理工作目录,并向上查找到最近一个包含 .datarim-runtime/installation.json 的祖先目录;其中记录的项目必须等于该目录,且沿途经过的每个嵌套 git 仓库都必须列在安装配置的显式上下文中。任务状态随后位于 <project>/datarim/。仅仅命名为 datarim/ 的目录并不会启用 Datarim,且该规则绝不会回退到主目录、父工作区或框架检出目录。这可以防止 Agent 将任务状态写入错误的位置。
自 3.0 起,安装是项目本地的:每个项目在 .datarim-runtime/ 下获得一份固定版本的框架副本,命令通过 ${DATARIM_RUNTIME} 读取它。从其他地方复制而来的安装以及符号链接的运行时目录会被上述路径规则拒绝。框架变更在源仓库中进行,并在项目更新时到达该项目。
技能加载顺序与黑名单
技能从两个层加载。框架层是位于 .datarim-runtime/ 的项目运行时。位于 .datarim-runtime/local/(被 gitignore)的本地覆盖层允许项目私有新增内容;当名称冲突时,本地覆盖层优先。有六个关键技能无法被本地覆盖层遮蔽:security、security-baseline、compliance、datarim-system、ai-quality 和 evolution。尝试通过 local/skills/ 覆盖其中任何一个都会导致 validate.sh 以退出码 1 退出。
大型计划的读取策略
当一个 L3+ 任务的计划、PRD 和辅助研究文档合计超过约 600 行时,该技能建议进行一次外部上下文委派,而不是逐个顺序读取每个产物。该委派产生的结构化摘要随后驱动 /dr-do、/dr-qa 和 /dr-compliance 中的实现顺序、文件路径和验证标准——为每个阶段重新读取原始产物会在实现摘要和验证摘要之间引入偏差。
该技能还将自身拆分为多个子文件——path-and-storage.md、task-identity-and-context.md、backlog-and-routing.md 等——以便命令只加载与当前子问题相关的片段,而不是完整的系统规则文档。
有关完整的流水线背景,请参阅什么是 Datarim;有关强制执行此模式的迁移算法,请参阅datarim-doctor 技能文章。