| name | workflow-archive |
| description | Use when 用户调用 /workflow-archive, or workflow 状态为 completed 需要 archive。 |
| disable-model-invocation | true |
路径 convention 见 ../../specs/shared/workflow-cli.md。archive summary 用 canonical 术语(Read core/specs/shared/glossary.md)。
workflow-archive
**完成前置**:仅允许对 `completed` 状态执行 archive,不得跳过状态校验。
Checklist
- ☐ 调用 CLI 执行 archive
- ☐ 展示 archive 结果
- ☐ 下一步建议
Step 1: CLI archive
node ~/.agents/agent-workflow/core/utils/workflow/workflow_cli.js archive
node ~/.agents/agent-workflow/core/utils/workflow/workflow_cli.js archive --summary
CLI 自动完成 tombstone 两阶段提交:校验 status=completed → 写 ARCHIVING.marker → 在 history/<YYYY-MM>/<task>-<timestamp>/ 下生成快照(workflow-state.json status=archived、tasks.md(若存在)、changes/CHG-*、可选 summary)→ 删除根目录工作文件 → 清除 tombstone。
崩溃后下次任意 /workflow-* 启动会自动识别 tombstone:Phase 1 未完成则回滚 destDir,Phase 2 未完成则前滚清理根目录。
| 错误 | 含义 | 建议 |
|---|
没有可归档的工作流 | 无项目配置或无状态文件 | 提示先 /scan 和 /workflow-spec |
只有 completed 状态的工作流可以归档 | 当前不是 completed | 显示当前 state_status,提示先完成 workflow |
Step 2: 展示结果
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📦 工作流归档
✅ 归档完成!
- **项目 ID**:{project_id}
- **状态**:archived
- **归档变更数**:{archived_changes.length}
- **归档目录**:{history_dir}
{如有摘要:- **摘要文件**:{summary_file}}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Step 3: 下一步
🎉 工作流已归档,可以开始新任务。
/workflow-spec "新功能描述"
/workflow-archive 只 archive workflow runtime。原生 /team 的收尾由 TeammateIdle hook 触发负责人 clean up team。