---
name: planning-archive-change
description: SpecPow planning-archive-change skill
---

# 归档变更

> 将已完成的变更归档到主规范中

## 触发条件

- 变更所有任务已完成
- 用户提到"归档"/"archive"
- 分支合并后

## 铁律

1. **验证先行** — 所有任务必须已完成
2. **合并规范** — Delta 规范合并到主规范
3. **保留记录** — 归档文件保留完整工件

## 工作流

### 1. 检查完成度
```bash
# 单变更时自动检测
specpow status

# 多变更时指定名称
specpow status --change <change-name>
```
确认所有任务已完成：
- YAML Frontmatter 格式：`status: done` 或 `status: completed`
- Markdown Checkbox 格式：`- [x]`

### 2. 执行归档
```bash
# 单变更时自动检测，无需指定名称
specpow archive

# 多变更时指定名称
specpow archive --change <change-name>
```

### 3. 验证归档
- 确认变更目录已移入 archive/
- 确认主规范已更新
- 确认归档报告已生成

## 红旗

- 任务未完成 → 先完成所有任务
- 验证未通过 → 先通过 verify