mcpField
O
openspec-archive

openspec-archive

github.com/full-stack-skills开发188 次安装4 周前更新
代码仓库

关于 openspec-archive

openspec-archive 是用于收尾已完成 OpenSpec 变更的技能。它将增量规格合并到主规格目录，并把变更材料保存在归档中。

主要功能

  1. 01检查材料和任务完成情况
  2. 02合并新增、修改和删除的规格
  3. 03将变更移入日期归档目录
  4. 04保留变更上下文以供审计

适用场景

  1. 01归档已验证的变更
  2. 02将增量规格同步到主规格
  3. 03保存已完成变更的记录

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-archive

安装后在 Claude Code 中输入/openspec-archive确认已加载。

附带文件agents/openai.yaml

详细介绍

OpenSpec 归档技能

使用 /opsx:archive 完成已完成的变更。归档操作会将增量规范合并到主 openspec/specs/ 目录，并将变更文件夹移至 openspec/changes/archive/。

适用时机

  • 实现已完成并经过验证。
  • 用户说“归档”“完成”“这个变更已完成”或“收尾”。
  • 运行 openspec-verify 后（可选，但建议运行）。

前提条件

  • 变更已存在，且包含产物（最好也已完成任务）。

工作流

  1. 运行归档

    • /opsx:archive — 归档当前或推断出的变更。
    • /opsx:archive <change-name> — 归档指定变更。

  2. 归档操作

    1. 检查产物完成状态和任务完成情况（若未完成则发出警告）。
    2. 如果尚未同步增量规范，则提供同步选项（参见 openspec-sync）。
    3. 将增量规范合并到 openspec/specs/（ADDED / MODIFIED / REMOVED 部分）。
    4. 将变更文件夹移至 openspec/changes/archive/YYYY-MM-DD-<name>/。

  3. 保留所有产物

    • 完整的变更上下文（提案、设计、任务、规范）都会保留在归档中，以供审计追踪。

增量规范合并规则

部分操作
## ADDED Requirements追加到主规范
## MODIFIED Requirements替换主规范中的现有需求
## REMOVED Requirements从主规范中删除

输出

  • 增量规范已合并到 openspec/specs/。
  • 变更已移至 openspec/changes/archive/YYYY-MM-DD-<name>/。

后续步骤

  • 使用 openspec-new 开始新的变更。
  • 主规范现已反映这些变更——后续变更将基于更新后的事实来源。

故障排除

  • “任务未完成”：归档会发出警告，但不会阻止操作。请决定先完成任务，还是按当前状态归档。
  • “增量规范尚未同步”：归档时会提示同步；也可以提前运行 openspec-sync。
  • 需要归档多个变更：请改用 openspec-bulk-archive。

参考

评论

支持 Markdown