dr-init-id-collision-window 技能 — 任务 ID 冲突检测与重命名
Datarim 如何检测并解决任务 ID 冲突:当两个并行会话在 /dr-init 与 /dr-archive 之间的窗口内预留同一标识符时,冲突便会产生。
在同一工作区上运行的两个 agent 会话可能会选择相同的 TASK-PREFIX-NNNN 标识符。这种冲突在其中一个会话尝试写入另一个会话已创建的归档文档之前一直不可见。到那时,落败的会话已经拥有一整条派生工件链——PRD、计划、验证审计日志、反思、快照——全部带有冲突的 ID。
dr-init-id-collision-window 技能描述了如何尽早检测这种情况,以及当发现较晚时如何干净地重命名所有内容。
窗口在哪里打开
这个间隙位于 /dr-init 步骤 2.5 中的探测——即预留下一个空闲 ID 的位置——与 /dr-archive 将其文档提交到磁盘的时刻之间。在该窗口期间进行探测的第二个会话看不到第一个会话预留的任何证据,会选择相同的编号,两者便在重复 ID 下并行推进。
该技能在两处被调用:由 /dr-init 在任何工件写入之前进行早期检测,以及由 /dr-archive 在最终提交时发现冲突时调用。
检测范围
探测针对完整的规范工件集运行:tasks.md、backlog.md、activeContext.md、datarim/ 下的每个按任务文件,以及 documentation/archive/ 下的每个归档文档。调用会话自身范围之外的任何命中都表明存在冲突。探测还会利用 frontmatter 时间戳和提交作者——而不仅仅是文件是否存在——来区分操作者自己较早的会话与真正并行的会话。
该技能还涵盖操作者未运行 /dr-init 就启动分支的热修复情况。在使用候选 ID 执行任何 git checkout -b 之前,同样的探测必须确认该 ID 在 backlog 和归档中均空闲——该候选 ID 在当前对话上下文中可能看起来未被使用,但可能已在另一个会话的 backlog 条目中作为后续项登记。
解决流程
落败的会话(提交时间戳较早的那个,或操作者指定的那个)采用一个新 ID。一次 sed 批量操作在单次遍历中重命名所有工件正文中旧 ID 的每一处出现。然后 git mv 重命名文件本身。tasks.md 和 activeContext.md 中的索引条目会相应更新。已被阶段后加固写锁定的验证审计日志需要在重命名前临时执行 chmod u+w,之后执行匹配的 chmod a-w 恢复。
该流程以一行冲突记录追加到被重命名会话的 init-task 工件中结束,并通过最后一次 grep 确认在预期的历史证据引用之外不再残留对旧 ID 的过时引用。
该技能不允许的事项
重命名窗口在检测时打开,在下一个阶段提交时关闭。在执行中途重命名会在快照 frontmatter 和进行中的 QA 草稿中留下过时引用。仅通过 git mv 重命名文件路径而不更新工件正文会导致 frontmatter 不匹配。直接删除落败会话的工件也被排除——内容在新 ID 下仍可挽救,不应丢弃。
另见:嵌入探测的 /dr-init 命令,以及关于更广泛任务生命周期的 Datarim 是什么。