openspec-sync-specs

Merge delta spec sections into main specs using the openspec CLI.

9|16|Updated Oct 16, 2018
One-click install
npx skills add https://github.com/ondata/albopopTwoDotZero --skill openspec-sync-specs-ondata
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/ondata/albopopTwoDotZero/tree/main/.gemini/skills/openspec-sync-specs
Command: npx skills add https://github.com/ondata/albopopTwoDotZero --skill openspec-sync-specs-ondata

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs. This tool enables intelligent merging of changes without archiving the delta or re-copying entire specs; it streamlines keeping main specs up-to-date with delta changes.

Core Features & Use Cases

  • Intelligent delta merging: reads delta specs and applies only the intended additions or modifications to main specs.
  • Command-guided workflow: supports identifying available changes, locating delta specs, and applying changes with idempotent results.
  • Safe, guided updates: preserves existing content not mentioned in the delta and prompts for clarification when scope is ambiguous.

Quick Start

Provide the delta change name to begin syncing delta specs into the main specs.

Frequently Asked Questions about openspec-sync-specs

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

FAQPage Schema
How do I sync delta specs into main specs without archiving the delta?

To sync delta specs into main specs, provide the delta change name. The tool reads delta specs from openspec/changes/<name>/specs/*/spec.md, applies ADDED, MODIFIED, REMOVED, and RENAMED sections, and intelligently merges changes without archiving the delta.

What is delta spec merging in openspec and when do I need it?

Delta spec merging applies targeted additions and modifications from a change proposal to main specs. You need it to keep main specs up-to-date with proposed changes without re-copying entire specs or archiving the delta.

Do I need the openspec CLI to apply changes to main specs?

Yes, applying changes to main specs requires the openspec CLI. The tool uses the CLI to locate available changes, read delta and main specs, and apply updates idempotently while preserving unrelated content.

What is the best way to apply modified or removed sections to existing specifications?

The best way to apply modified or removed sections is using intelligent delta merging. It reads delta specs, applies only the intended changes to corresponding main specs, and preserves existing content not mentioned in the delta.

Will syncing delta specs overwrite unrelated content in my main specs?

No, syncing delta specs preserves unrelated content in your main specs. It applies only the ADDED, MODIFIED, REMOVED, and RENAMED sections defined in the delta and prompts for clarification when scope is ambiguous.

Can I run delta spec synchronization multiple times without duplicating changes?

Yes, delta spec synchronization operates idempotently. Running it multiple times yields the same result without duplicating changes, ensuring safe and guided updates to your main specs.