메뉴
Use when 用户调用 /workflow-archive, or workflow 状态为 completed 需要 archive。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| 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 术语（Readcore/specs/shared/glossary.md）。
# 基本归档
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 |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📦 工作流归档
✅ 归档完成！
- **项目 ID**：{project_id}
- **状态**：archived
- **归档变更数**：{archived_changes.length}
- **归档目录**：{history_dir}
{如有摘要：- **摘要文件**：{summary_file}}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎉 工作流已归档,可以开始新任务。
/workflow-spec "新功能描述"
/workflow-archive只 archive workflow runtime。原生/team的收尾由TeammateIdlehook 触发负责人clean up team。
Use when 用户调用 /design-plan, or 需要为复杂跨服务需求(多服务改动 / 数据库 DDL / 新增对外接口 / 架构调整)产出可评审的技术方案文档,典型用户是技术主管 / 资深研发。简单单服务改动走 /workflow-spec,Bug 修复走 /fix-bug。
Use when asked to review a diff, do a pre-commit code review, or review staged/branch changes. Supports staged diffs, branch diffs, and session mode that reviews only files edited in the current conversation context.
Use when 用户调用 /plan-archive, or 三阶段研发流程的阶段三:在所有模块研发上线后,根据实际代码改动回写阶段一技术方案 + 项目级架构文档(docs/architecture / docs/contracts / docs/assets/概要设计 等)。
Use when 用户说「快速规划」「轻规划」「不走 workflow」「plan 一下」「quick plan」, or 需求清晰、作用域明确、可一次性规划完成的简单到中等任务。复杂项目(跨 module / 新子系统 / 需追溯)或需要正式需求文档 / PRD 请用 /workflow-spec。
Use when 用户调用 /spec-bootstrap, or 项目尚未建立 .claude/code-specs/ 骨架且需要初始化 code-specs 体系。
Use when 用户调用 /spec-update, or 工作中沉淀出新 convention / 接口 contract / 模式需要落到 .claude/code-specs/, or execute 末尾终审（workflow-execute Step 7）建议沉淀 code-spec。