/dr-archive 命令 — 以永久记录关闭任务
/dr-archive 如何将已完成的任务转化为持久的归档文档、验证工作区状态、按前缀路由,并关闭 Datarim 流水线。
每个已完成的任务都值得拥有一份能超越会话存续的记录。/dr-archive 是 Datarim 流水线中的最后一条命令:它将已完成的任务转化为永久归档文档,更新索引文件,并将该任务从活动列表中移除。
由于归档写入不可逆——任务从活动状态转为已归档、索引文件发生变化、git 状态发生偏移——该命令在任何变更发生之前会运行多重防护检查。
干净 git 门禁
在写入任何内容之前,/dr-archive 会检查该任务涉及的每个仓库的 git 状态。若工作树不干净,操作员需从三条路径中选择一条:立即提交待处理的更改、将未完成状态记录到归档文档的 Known Outstanding State 部分,或中止并返回 /dr-do。不允许在未提交的工作之上静默归档。
对于共享工作区仓库——多个并行会话可能已暂存了不相关的更改——该检查使用一个脚本,按任务 ID 对每个已修改文件的 hunks 进行分类。属于其他任务的 hunks 不构成阻塞;只有当前任务自身未提交的工作会被标记。这避免了并行工作正在进行时出现误停。
归档文档包含的内容
归档文档写入的路径由任务前缀决定。每个项目前缀映射到 documentation/archive/ 下的一个子目录,因此每个项目的历史都保持在一起。文档具有固定结构:初始任务(来自操作员简报的一句话)、如何解决(每个简报条目一条要点)、产出的工件,以及 Operator Handoff 部分,描述未来会话需要了解什么才能从这一点继续。
反思环节作为 /dr-archive 的 Step 0.5 在内部运行。它回顾工作、识别经验教训,并生成演进提案——Class A 条目在同一归档周期内提交操作员批准,或 Class B 条目保留至 PRD 更新起草完成。Class A 提案在应用前需要操作员明确批准;它们不会被自动应用。
索引更新
文档写入后,/dr-archive 会更新 Datarim 索引文件。任务从 tasks.md 中的活动列表移至已完成状态,activeContext.md 会更新以反映新的活动任务数量。两个文件都使用精简的单行 schema——索引中不包含完整任务正文,只包含路由下一条命令所需的元数据。
为什么斜杠形式很重要
只有在使用规范斜杠命令形式时,归档文档及所有配套防护检查才保证会运行。手动暂存归档文件或手动移动索引条目会跳过 pre-archive-check.sh 和 datarim-doctor.sh 验证器。斜杠形式就是契约——临时路径会绕过它。
在什么是 Datarim中查看完整流水线上下文,或在/dr-compliance中了解归档前运行的质量门禁。