openspec-sync-specs

Merge delta specifications into main specifications under openspec/specs.

47|2|Updated Oct 30, 2023
One-click install
npx skills add https://github.com/runtime-env/runtime-env --skill openspec-sync-specs-runtime-env
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/runtime-env/runtime-env/tree/main/.gemini/skills/openspec-sync-specs
Command: npx skills add https://github.com/runtime-env/runtime-env --skill openspec-sync-specs-runtime-env

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Synchronizes delta specifications back into the primary specs, enabling intelligent merging of changes without overwriting existing content or losing context.

Core Features & Use Cases

  • Intelligent delta-to-main merging: applies ADDED, MODIFIED, REMOVED, and RENAMED changes from delta specs to the corresponding main specs while preserving unrelated content.
  • Coverage for missing specs: creates new main spec files for capabilities that do not yet exist and populates them with the added requirements.
  • Use case: when a delta spec introduces a new scenario or updates an existing capability, this skill updates the main spec accordingly, maintaining continuity and history.

Quick Start

Open your terminal and run the OpenSpec sync command to apply delta specs to main specs. If multiple delta changes exist, you will be prompted to choose the change, and the tool will report what was updated.

Frequently Asked Questions about openspec-sync-specs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I merge delta specifications into main specs without overwriting existing content?

To merge delta specifications without overwriting existing content, apply changes from openspec/changes to openspec/specs. This intelligent merging preserves unrelated content while supporting added, modified, removed, and renamed requirements.

What happens when a delta spec introduces requirements for a capability that does not exist yet?

When a delta spec introduces requirements for a missing capability, the sync operation automatically creates a new main spec file under openspec/specs. It then populates this new file with the added requirements to maintain continuity.

Is the process of syncing delta specs to main specs idempotent?

Yes, merging delta specs into main specs is an idempotent operation. Applying the same delta specification changes multiple times will consistently produce the same final state in the main specs without duplicating entries.

How do I apply multiple delta changes to my main specification?

To apply multiple delta changes, run the sync command in your terminal. If multiple delta specs exist, you will be prompted to select the specific change, and the tool will report the updated main spec requirements.

Does the specification merge require manual intervention before applying changes?

Merging delta specs requires reading both the delta and main specifications before applying changes. If clarification is needed during the intelligent merging process, the system will prompt you for input.

Can I remove or rename existing requirements using delta specs?

Yes, delta specs support modified, removed, and renamed requirement changes. The intelligent merge applies these specific change types directly to the corresponding main specifications while preserving all unrelated existing content.