Su Archive

---
name: su-archive
description: 在任务通过审查后，完成文档交付决策、状态归档、spec 归档与可选复盘记录。
metadata:
  short-description: SU 归档
---

# SU 归档

## 触发条件
- 当前任务已经通过审查。
- 用户准备进入最终验收前的收尾阶段。
- 需要决定是否补文档并更新状态。

## 输入
- 当前任务 spec。
- 审查结论。
- `.ccb/state/<task-id>.md`。
- 是否需要额外文档更新的判断。

## 执行流程
1. 由 Claude 决策是否需要补文档，不亲自写详细文档。
2. 若需要补文档，通过 `ask <provider> --foreground` 生成精简指令交给 Codex 异步完成。
3. 更新 `.ccb/state/<task-id>.md` 为 `done`。
4. 将当前 spec 移动到 `docs/.ccb/specs/archive/` 对应月份目录。
5. 记录可选复盘信息，包括复杂度、分支、时间与经验教训。
6. 告知用户本轮已经进入最终验收状态。

## SuperClaude 集成

### 条件触发
- 项目由 CCB 管理 Git 收尾时：`/sc:git`

### 建议触发
- 需补文档时：`/sc:document [目标路径]`

## 输出格式
- 归档结果摘要。
- 已移动或更新的文件列表。
- 是否补文档及其原因。
- 可选复盘记录。

## 停止条件
- 状态文件已完成更新。
- spec 已归档。
- 用户已看到最终交付摘要。

## 升级条件（回抛给用户）
- 当前任务仍有未关闭问题，不适合归档。
- 归档路径或任务编号不明确。
- Git 或项目状态不允许安全归档。