命令 Pipeline

/dr-archive

归档已完成任务,并强制进行反思与演进提案

概述

/dr-archive 是知识归档阶段;/dr-finalize 负责后续的交付与清理。它会解析目标任务,验证所有 git 仓库均处于干净状态,运行强制反思(步骤 0.5)以生成演进提案,将任务打包为永久归档文档,更新待办列表,处理后续任务创建,并重置工作区。自 v1.10.0(<TASK-ID>)起,原先独立的 /dr-reflect 命令被合并至此,因为“可选强制门禁”被认定为设计缺陷。

用法

/dr-archive
/dr-archive --auto-commit
/dr-archive cancel
/dr-archive cancel TASK-NNNN

功能说明

  1. 步骤 0 — 任务解析 — 从参数中解析出要归档的任务,或在多个任务活跃时通过消歧确定任务。
  2. 步骤 0.1 — 归档前 Git 检查(强制,自 v1.18.0 / <TASK-ID> 起支持多智能体)— 将每个涉及的仓库分类为工作区(由并行智能体会话共享)或项目(单智能体)。对于工作区仓库,scripts/pre-archive-check.sh --task-id <ID> --shared <repo> 会将每个修改文件的代码块分类为 own、foreign、mixed 或 unattributed:仅 foreign 不构成阻塞(并行会话拥有各自的代码块),但 own/mixed/unattributed 代码块会阻塞,直到应用补丁暂存方案(git add -p 或非交互式 blob 交换)。对于项目仓库,沿用旧版 <TASK-ID> 契约(任何未提交更改都会阻塞;三选一提示:提交 / 接受待定 / 中止)。
  3. 步骤 0.5 — 反思(强制,不可跳过)— 首先通过新鲜度门禁检查 /dr-compliance 是否已写入与当前合规报告匹配的反思;若匹配则复用,但仍会呈现待处理的提案。否则,命令加载反思技能并执行完整的反思工作流:
    • 创建 datarim/reflection/reflection-[task_id].md
    • 生成演进提案,分类为 A 类(安全,立即应用)或 B 类(需先更新 PRD)
    • 在交互式运行中,呈现未解决的提案以供决策;自主运行则复用已记录的决策
    • 在 datarim/history/evolution-log.md 中记录变更
    • 运行健康指标检查;若超出阈值则建议 /dr-optimize
    • 为步骤 4 记录后续任务

    此步骤不可跳过。不存在 --no-reflect 标志。失败时归档停止——重新运行会重新进入步骤 0.5。

  4. 步骤 1 — 确定归档区域 — 从任务 ID 中提取前缀(例如从 <TASK-ID> 提取 INFRA),并将其映射到归档子目录。
  5. 步骤 2 — 创建归档文档 — 按照规范模板 templates/archive-template.md(v2.14.0+,<TASK-ID>)写入 documentation/archive/{area}/archive-{task_id}.md。归档文档包含四个面向操作者的顶级章节,顺序严格——«Начальная задача»(一句源自操作者简报的俄语句子)、«Как решили»(单层项目符号列表,将每个简报项映射为引用项目符号 + 俄语状态词 + 一两句通俗语言说明;来自 tasks/{ID}-expectations.md 的期望以标记 «(уточнение брифа)» 并入同一列表)、«Артефакты задачи»(产出或变更的内容)、«Следующие шаги»(具体的 /dr-* 命令或操作者操作,或 «всё закрыто»)。在 --- 水平分隔线下方是审计附录,包含 ### verification_outcome、### Acceptance Criteria、### Lessons Learned、### Operator Handoff、### Related。状态词:«выполнено» / «частично» / «не выполнено» / «неприменимо»——绝不使用模式枚举 met/partial/missed/n-a。包含已知丢失验证门禁:在将任何内容记录为“永久丢失”之前,智能体需运行 5 通道灾难恢复检查清单。只有所有通道均耗尽后,丢失声明才可进入归档。
  6. 步骤 3 — 更新待办列表 — 从 backlog.md 中移除已完成任务。已提交的归档文档是永久记录;不存在第二个待办文件。
  7. 步骤 4 — 后续任务 — 从反思文档中读取后续事项,并询问是否将其添加为新的待办条目。
  8. 步骤 5 — 从 tasks.md 中移除 — 从精简索引 tasks.md 的 ## Active 中删除该任务的一行描述,并移除其计划文件;归档文档是永久记录。
  9. 步骤 6 — 更新上下文 — 从 activeContext.md 的 ## Active Tasks 中移除已归档任务,该文件镜像 tasks.md。其他活跃任务保留;不写入“最近完成”章节(最近记录来自 /dr-status --recent N)。
  10. 步骤 7.5 — 归档自动提交(可选,--auto-commit)— 仅在本地提交归档文档(及其阶段快照)。绝不推送、打标签或发布。
  11. 步骤 8 — 人类摘要 — 在行动号召之前打印简短的操作者摘要。

关闭前,最终证据门禁会对照已记录的证据检查任务的每个验收用例;任何缺口都会阻塞归档。

取消模式

如果你说“取消任务”或提供要取消的任务 ID,命令会写入 documentation/archive/cancelled/archive-{task_id}.md,从活跃待办列表和上下文中移除该任务,并跳过反思,因为任务未完成。

参数

可选。使用 cancel 取消而非归档。可选指定任务 ID 以在多任务时消歧。--auto-commit / --no-auto-commit 控制本地归档记录提交(默认关闭)。

输出

创建:documentation/archive/{area}/archive-{task_id}.md、datarim/reflection/reflection-[task_id].md。从 datarim/backlog.md、datarim/tasks.md 和 datarim/activeContext.md 中移除已完成条目;演进决策记录在 datarim/history/evolution-log.md 中。已废弃的 backlog-archive.md 永远不会被写入。

示例会话

> /dr-archive

任务解析:<TASK-ID>(唯一活跃任务)

归档前干净 Git 检查:
  工作区:干净
  项目仓库:干净

步骤 0.5 — 反思:
  已创建:datarim/reflection/reflection-<TASK-ID>.md
  演进提案:
    [A 类] 用 OAuth 模式更新 security.md(已批准 → 已应用)
    [B 类] 重构 auth 智能体 — 已推迟(需要 PRD)
  健康指标:在阈值内

正在归档 <TASK-ID>...
  区域:auth(从 AUTH 前缀映射)
  归档:documentation/archive/auth/archive-<TASK-ID>.md

待办列表已更新:
  已从 backlog.md 移除 <TASK-ID>
  永久记录:documentation/archive/auth/archive-<TASK-ID>.md

来自反思的后续任务:
  1. 为 AUTH 模块添加速率限制
  2. 编写面向用户的 auth 文档
添加到待办列表?(y/n)

上下文已更新。准备下一个任务。

下一步:/dr-init 或 /dr-dream(自上次运行以来已有 5+ 文档)

相关命令

报告结果

在面向人类的更新或结果之前,应用人类结果报告。说明用户可见的结果、原始条件、检查与证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持精确协议和技术记录完整。若需在不继续工作的情况下再次解释,请使用 /dr-explain。