mcpField
O
openspec-sync

openspec-sync

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

关于 openspec-sync

openspec-sync 是一项技能，可将变更中的增量规格合并到 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-sync

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

附带文件agents/openai.yaml

详细介绍

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