openspec-sync-specs

To merge incremental specification changes, this Skill reads changes organized by capability and applies ADDED, MODIFIED, REMOVED, and RENAMED requirements to the main spec. It preserves existing content not mentioned by the increments while ensuring idempotent application.

Syncing OpenSpec incremental changes without archiving is done by reading incremental specs and merging them into the main specification. This allows targeted updates to capabilities while keeping unrelated existing scenarios intact.

Applying ADDED, MODIFIED, and REMOVED requirements is handled through a controlled merging process. The Skill reads both incremental and main specs, applying changes section by section and prompting when needed to ensure accurate synchronization.

You can synchronize capability changes even if the main specification is missing. The Skill reads the incremental specs and creates the corresponding main spec automatically during the merge process if it does not already exist.

Merging incremental specs does not overwrite unrelated content. The process applies only the specified ADDED, MODIFIED, REMOVED, and RENAMED sections while explicitly preserving existing content not mentioned by the increments.

To list available OpenSpec changes before merging, use the openspec-cn tool with the list --json command. This outputs available change names so you can select one for the agent to apply to the main document.