openspec-sync-specs

Merge delta specs into main OpenSpec specs with change selection.

30|4|Updated Aug 2, 2024
One-click install
npx skills add https://github.com/belingud/gptcomet --skill openspec-sync-specs-belingud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/belingud/gptcomet/tree/main/.codex/skills/openspec-sync-specs
Command: npx skills add https://github.com/belingud/gptcomet --skill openspec-sync-specs-belingud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Syncing delta specs into a stable main specification set can be error-prone and require manual coordination; this skill automates and guards the merge process.

Core Features & Use Cases

  • Intelligent delta-to-main spec merging that preserves existing content while applying delta changes.
  • Supports ADDED, MODIFIED, REMOVED, and RENAMED sections, creating main specs if missing and summarizing modifications.
  • Interactive prompts for change selection when multiple delta changes exist, ensuring deliberate updates.

Quick Start

Provide the delta specs for a change and run the openspec-sync-specs command to merge them into the main specifications.

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 specs into main OpenSpec specifications?

To merge delta specs into main OpenSpec specifications, apply changes from openspec/changes/<name>/specs to openspec/specs. The tool automatically updates or creates main spec files while preserving existing content and outputting a summary.

What are delta specs in OpenSpec and when do I need to sync them?

Delta specs in OpenSpec are incremental changes containing ADDED, MODIFIED, REMOVED, and RENAMED sections. You sync them to integrate changes from the changes directory into your stable main specification set.

Does the OpenSpec merge process preserve existing content when applying modifications?

Yes, the OpenSpec merge process preserves existing content while applying delta changes. It intelligently merges modifications into main spec files and only updates targeted sections, prompting for selection when multiple changes exist.

How do I handle multiple delta changes when syncing OpenSpec files?

When multiple delta changes exist during OpenSpec syncing, the tool provides interactive prompts for change selection. This ensures deliberate updates by letting you choose which specific changes to apply from the changes directory to the main specs.

Can I use OpenSpec sync specs to automatically create missing main spec files?

Yes, OpenSpec sync specs automatically creates missing main spec files. When merging delta specs, the tool creates main spec files in openspec/specs if they do not already exist, applying all ADDED sections accordingly.

What is the best way to track additions and removals when merging OpenSpec delta changes?

The best way to track additions and removals when merging OpenSpec delta changes is to review the concise summary output. After applying ADDED, MODIFIED, and REMOVED sections, the tool generates a summary detailing all modifications made to the main specifications.