/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
功能说明
- 步骤 0 — 任务解析 — 从参数中解析出要归档的任务,或在多个任务活跃时通过消歧确定任务。
- 步骤 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> 契约(任何未提交更改都会阻塞;三选一提示:提交 / 接受待定 / 中止)。 - 步骤 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。 - 创建
- 步骤 1 — 确定归档区域 — 从任务 ID 中提取前缀(例如从
<TASK-ID>提取INFRA),并将其映射到归档子目录。 - 步骤 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 通道灾难恢复检查清单。只有所有通道均耗尽后,丢失声明才可进入归档。 - 步骤 3 — 更新待办列表 — 从
backlog.md中移除已完成任务。已提交的归档文档是永久记录;不存在第二个待办文件。 - 步骤 4 — 后续任务 — 从反思文档中读取后续事项,并询问是否将其添加为新的待办条目。
- 步骤 5 — 从 tasks.md 中移除 — 从精简索引
tasks.md的## Active中删除该任务的一行描述,并移除其计划文件;归档文档是永久记录。 - 步骤 6 — 更新上下文 — 从
activeContext.md的## Active Tasks中移除已归档任务,该文件镜像tasks.md。其他活跃任务保留;不写入“最近完成”章节(最近记录来自/dr-status --recent N)。 - 步骤 7.5 — 归档自动提交(可选,
--auto-commit)— 仅在本地提交归档文档(及其阶段快照)。绝不推送、打标签或发布。 - 步骤 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-qa — 上一阶段:质量验证
- /dr-compliance — 可选上一阶段:加固
- /dr-init — 开始新任务
- /dr-dream — 若知识库已增长则建议使用
报告结果
在面向人类的更新或结果之前,应用人类结果报告。说明用户可见的结果、原始条件、检查与证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持精确协议和技术记录完整。若需在不继续工作的情况下再次解释,请使用 /dr-explain。