/dr-init 命令 — 每个任务的起点
/dr-init 如何检测意图、分配任务 ID、创建跟踪结构,并将你引导到正确的下一步——全程不会触碰你未要求它触碰的文件。
每条流水线都需要一个起点。在 Datarim 中,这个起点就是 /dr-init。它是唯一被允许创建 datarim/ 目录并在其中搭建任务跟踪结构的命令。其他一切环节——规划、编码、审查——都假定该结构已经存在。
该命令接受一段纯文本描述:你想构建或修复什么。据此,它会判定复杂度等级(1 到 4),根据项目或领域选择正确的任务 ID 前缀,并创建最初的跟踪文件。如果已存在带有待处理事项的待办列表,该命令会列出这些事项,让你从中挑选一个,而不是从头开始。
它做什么
第一个动作是意图检测。该命令会区分初始化一个任务(常见情况)与搭建一个全新项目。新项目会触发单独的脚手架流程;任务描述则直接进入任务设置。
任务类型明确后,命令会扫描现有任务和待办条目,找到下一个空闲编号来分配 ID。在确定该 ID 之前,它会探查完整的任务范围——包括待办列表和归档——以捕捉冲突。冲突意味着两个任务可能最终共用同一个标识符,这会在后续的归档步骤中出问题。
ID 确认后,命令会写入两个文件:一个 init-task 文件,逐字记录操作者的任务简报;以及一个期望骨架,记录该任务应达成什么。期望文件稍后由 /dr-qa 使用,以验证所构建的内容与所要求的内容是否一致。
一个具体示例
假设以描述“为 invoices 端点添加 CSV 导出”运行该命令。命令检测到这是一个任务(而非项目),将复杂度评估为 Level 2,并根据 billing 项目映射选择 BILL 前缀。它探查待办列表,在 <TASK-ID> 处未发现冲突,于是写入 datarim/tasks/<TASK-ID>-init-task.md,逐字包含该描述,并写入 <TASK-ID>-expectations.md,其中包含一条从简报中得出的期望。任务条目会落入 tasks.md 和 activeContext.md。响应最后会给出推荐的下一步。
它在流水线中的位置
流水线顺序为:/dr-init → /dr-prd → /dr-plan → /dr-design → /dr-do → /dr-qa → 归档。初始化后命令将你引导到哪里,取决于复杂度:Level 1 任务直接跳到 /dr-do;Level 2 任务进入 /dr-plan;Level 3 或 4 任务需要 PRD,并首先路由到 /dr-prd。
启动时的结构合规检查值得单独一提。如果 datarim/ 目录已存在但其 schema 已发生偏移,命令会报告该发现,并提议运行 /dr-doctor 来修复它。这可以防止累积的 schema 债务在归档时以错误的形式暴露出来。
在 什么是 Datarim 中进一步了解完整流水线,或继续阅读 /dr-prd 命令,了解初始化之后的需求阶段。