openspec-sync-specs

Apply delta spec changes to update OpenSpec main specification files.

Updated Feb 6, 2024
One-click install
npx skills add https://github.com/081595/mynode --skill openspec-sync-specs-081595
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/081595/mynode/tree/main/myproject/.github/skills/openspec-sync-specs
Command: npx skills add https://github.com/081595/mynode --skill openspec-sync-specs-081595

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeping OpenSpec main specification files in sync with incremental delta changes is tedious, error-prone, and often requires manual file edits and merging across multiple capability specs. This Skill automates the detection, interpretation, and safe application of ADDED, MODIFIED, REMOVED, and RENAMED requirement deltas so maintainers can apply intent-driven changes without overwriting unrelated content.

Core Features & Use Cases

  • Intelligent change selection: prompts the user to pick a named change when not explicit and lists available delta specs for review.
  • Delta parsing and targeted edits: reads delta spec sections and applies only the intended additions, modifications, removals, or renames to main spec files while preserving other content.
  • Spec creation and summaries: creates new capability spec files when needed, adds Purpose placeholders, and provides a concise summary of what changed for audit and review.
  • Use Case: A release engineer merges a feature change that adds scenarios and renames a requirement across multiple capability specs without losing existing scenarios or descriptions.

Quick Start

Run the openspec-sync-specs skill to apply the named change and produce a summary of updated capabilities.

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 to main OpenSpec specification files?

To sync delta specs to main OpenSpec specification files, the skill reads both delta and main markdown files, prompts you to select a named change if ambiguous, and intelligently merges additions, modifications, removals, and renames while preserving unrelated content.

What is an idempotent merge for OpenSpec requirement changes?

An idempotent merge for OpenSpec requirement changes applies delta modifications, additions, removals, and renames to main specs safely, ensuring that running the sync operation multiple times produces the same result without overwriting existing unspecified content.

How do I apply renamed and removed requirements across multiple capability specs?

To apply renamed and removed requirements across multiple capability specs, the skill parses delta spec sections and selectively targets main spec files for updates, prompting you to choose a specific change when multiple named changes are detected.

Can I automatically create new OpenSpec capability spec files from a delta change?

Yes, you can create new OpenSpec capability spec files from a delta change. The sync skill automatically generates the missing capability spec files, adds Purpose placeholders, and provides a concise summary of what changed for review.

Does syncing OpenSpec delta specs overwrite existing scenarios and descriptions?

Syncing OpenSpec delta specs does not overwrite existing scenarios and descriptions. The intelligent merge process applies only intended additions, modifications, removals, or renames while strictly preserving other unspecified content in the main spec markdown files.