mcpField
O
openspec-sync

openspec-sync

github.com/partme-ai开发35 次安装
代码仓库

关于 openspec-sync

openspec-sync 用于将变更中的增量规范合并到 OpenSpec 主规范目录，同时不归档该变更。它适合仍在进行或并行开展的变更，尤其是在归档前需要审查更新后的基础规范时。

主要功能

  1. 01将增量规范合并至 openspec/specs/
  2. 02处理 ADDED、MODIFIED 和 REMOVED 部分
  3. 03保留增量未提及的现有内容
  4. 04同步后保持变更处于活动状态
  5. 05需求冲突以最近一次同步为准

适用场景

  1. 01更新长期变更中的基础规范
  2. 02让并行变更使用更新后的规范
  3. 03归档前审查规范合并结果

安装

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

$npx skills add https://github.com/partme-ai/openspec-skills --skill openspec-sync

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

详细介绍

OpenSpec 同步技能

使用 /opsx:sync 将某项变更中的增量规范合并到主 openspec/specs/ 目录，而不归档该变更。同步后，该变更仍处于活动状态。这是可选操作——归档时，openspec-archive 会自动处理同步。

适用场景

  • 长期进行的变更，用户希望在归档前先将规范合并到主目录。
  • 多项并行变更需要更新基础规范。
  • 用户希望在归档前单独审查或预览合并结果。

前置条件

  • 存在一项包含 specs/ 中增量规范的活动变更。

工作流

  1. 运行同步

    • /opsx:sync — 同步当前或推断出的变更。
    • /opsx:sync <change-name> — 同步指定变更。

  2. 执行内容

    • 从变更文件夹读取增量规范。
    • 解析 ADDED / MODIFIED / REMOVED 部分。
    • 将变更合并到 openspec/specs/。
    • 保留增量规范中未提及的现有内容。
    • 变更仍处于活动状态（不会归档）。

  3. 验证

    • 检查 openspec/specs/ 中更新后的规范。

输出

  • openspec/specs/ 已合并增量变更。
  • 变更仍处于 openspec/changes/<name>/ 中，且保持活动状态。

后续步骤

  • 继续处理该变更，或在完成后使用 openspec-archive。

故障排除

  • “No delta specs”：该变更没有 specs/ 目录；请先通过 openspec-continue 或 openspec-ff 创建规范。
  • 与其他变更冲突：同步会按需求级别处理合并；如果两项变更修改了同一需求，则以较晚的同步为准。

参考资料

评论

支持 Markdown