| name | requirement-archive-manager |
| description | 阶段 5.3 收尾归档——把 done 的需求标记归档,关闭 TAPD 单(如果有 MCP),归档目录的 INDEX 更新。 |
| allowed-tools | Read, Write, Edit, Glob, Bash |
Skill: requirement-archive-manager
原文 §8.3 需求生命周期类的"收尾者"。
触发
- 阶段 5.2 经验沉淀完成 + 用户
/requirement:archive 命令
managing-requirement-lifecycle 检测到 stage=5.3 + 所有 features done
归档动作
- state.json 设
current_stage: "5.3" + archived_at: <ts>
- 在
requirements/{project}/_archive/INDEX.md 追加一行(按时间倒序)
- 把需求目录逻辑标记为归档(不物理移动,保持 git 历史可读):在
requirements/{project}/{req-id}/ARCHIVED 写一个空 marker 文件
- 若 TAPD MCP 可用 → 关闭 TAPD 单并附 commit 范围
- 写归档报告
requirements/{project}/{req-id}/archive-report.md
archive-report.md 模板
# 归档报告 — {req-id}
- 标题:...
- 周期:{created_at} → {archived_at}({total_days} 天)
- 阶段时长:
- 阶段 2: 2 天
- 阶段 3: 5 天
- 阶段 4: 12 天
- 阶段 5: 3 天
- 沉淀经验:N 条 → 链接列表
- 复用模板:本需求新增的 SOP / 规范修订
反模式
- ❌ 跳过 5.2 直接归档(必须先沉淀经验)
- ❌ 物理删除需求目录(违反审计可追溯)