Datarim 系统
Datarim 核心规则。请先加载此条目,然后仅加载路径、存储、编号、待办事项、路由或归档行为所需的片段。
概述
Datarim 系统是每个智能体在每个阶段都会加载的基础技能。它定义了文件存放位置、任务编号方式、待办事项的运作机制,以及复杂度如何决定流水线路由。该技能被拆分为一个简短的索引条目和若干聚焦的支撑片段,以减少上下文浪费,同时保留完整的系统契约。
文件组织
所有工作流状态都存放在显式安装项目的根目录下的 datarim/ 中,并通过克隆本地的 .git/info/exclude 将其排除在 git 之外(不编辑项目共享的 .gitignore)。已完成任务的归档存放于 documentation/archive/(提交至 git)。这种分离让多名开发者可以各自使用本地状态并行工作,同时通过归档共享项目知识。
任务编号
每个任务都会获得一个永久 ID,格式为 {PREFIX}-{NNNN}(例如 <TASK-ID>、<TASK-ID>)。该 ID 只分配一次,并在其整个生命周期中保持不变:待办事项、活动任务状态以及永久归档文档。前缀从项目与领域前缀注册表中选择。
复杂度路由
- 级别 1(快速修复) — 单个文件,<50 行。路由:init、do、archive。
- 级别 2(增强) — 2-5 个文件,<200 行。路由:init、plan、do、archive。
- 级别 3(功能) — 5-15 个文件,200-1000 行。路由:init、PRD、plan、design、do、QA、compliance、archive。
- 级别 4(重大功能) — 15+ 个文件,>1000 行。路由:init、PRD、plan、design、phased-do、QA、compliance、archive。
在每个级别中,/dr-archive 都会在内部执行反思,作为其强制性的 Step 0.5。
片段路由
智能体仅加载当前子问题所需的片段:path-and-storage 用于文件位置和归档边界,task-identity-and-context 用于编号和活动任务跟踪,model-assignment 用于模型/投入度 frontmatter,backlog-and-routing 用于复杂度级别和模式转换,command-and-archive-rules 用于 /dr- 命名空间和关键不变量。
关键规则
- 任何写入之前都必须进行路径解析 — 找到最近的、包含
.datarim-runtime/installation.json且记录的项目与之匹配的祖先目录;仅有datarim/目录并不能启用 Datarim,且不会回退到主目录 - 所有报告的文件名中都必须包含任务 ID
backlog.md仅包含活动工作;永久性的已完成和已取消记录存放在documentation/archive/下- 所有 Datarim 命令都使用
/dr-前缀,以避免与 Claude 内置命令冲突 - 使用
${DATARIM_RUNTIME:?}/或项目相对路径,而非机器特定的绝对路径
4.2 中的报告连接
共享的 Human Outcome Reporting 契约将任务需求与计划、结果、验证和证据连接起来。/dr-explain 是一条只读的解释路径。发布模板与图谱使这些链接可被发现;项目脚手架现在使用 AGENTS.md 模板。