skills.rest
ruan-cat
ruan-catCOMMUNITY
Explore all skills by this author →
GitHub

openspec-sync-specs

Merge delta specs from openspec/changes into main specs.

4|1|Updated Mar 24, 2024
Search Tags:#automation#cli#openspec#changesets#delta-specs#main-specs#spec-merge
One-click install
npx skills add https://github.com/ruan-cat/monorepo --skill openspec-sync-specs-ruan-cat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/ruan-cat/monorepo/tree/main/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/ruan-cat/monorepo --skill openspec-sync-specs-ruan-cat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs to update the authoritative specification set without losing incremental work or archiving changes prematurely.

Core Features & Use Cases

  • Intelligent delta merge: reads delta specs and applies changes to main specs with guarded merging rules to preserve existing content.
  • Delta-aware workflow: handles ADDED/MODIFIED/REMOVED/RENAMED updates and can create main specs when missing.
  • Collaboration-driven: prompts for change selection and clarifies scope to avoid misapplied edits.

Quick Start

Provide the delta change name when prompted and confirm the delta scope to begin syncing delta specs into 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 merge delta specs into main specs without losing existing content?▼

To merge delta specs, the tool reads changes from openspec/changes/<name>/specs and applies them to openspec/specs using guarded merging rules, ensuring unrelated content is preserved while updating the authoritative specification set.

What is the best way to sync incremental changes to main specs in OpenSpec?▼

Syncing incremental changes in OpenSpec involves identifying delta specs and applying ADDED, MODIFIED, REMOVED, or RENAMED updates to main specs, creating missing main specs automatically without prematurely archiving the changes.

How do I apply ADDED, MODIFIED, and REMOVED updates to delta specs?▼

Applying ADDED, MODIFIED, and REMOVED updates to delta specs is handled delta-aware workflow logic, which reads the change files and intelligently applies the specified operations to update the corresponding main specifications.

Do I need to specify the change name before syncing delta specs?▼

You do not need to specify the change name upfront; if the change name is unclear, the tool will prompt you to choose from available changes in openspec/changes before proceeding with the delta spec synchronization.

Can I create missing main specs automatically from delta specs?▼

Yes, you can create missing main specs automatically; when the tool applies delta specs from the change directory, it creates the corresponding main specs in openspec/specs if they do not already exist.

Why are my unrelated main specs being overwritten during a spec merge?▼

Unrelated main specs should not be overwritten; the tool uses guarded merging rules to preserve existing unrelated content, ensuring only the targeted delta changes are applied to the corresponding main specifications.

Related Skills

Explore More Software Engineering Skills→
jankneumannjankneumann
4

openspec-sync-specs

Merge delta spec changes into main OpenSpec specification files.

Community
Intermediate
oalansilvaoalansilva

openspec-sync-specs

Merge delta specifications into main specs while preserving existing content.

Community
Advanced
HsienWHsienW
63

openspec-sync-specs

Synchronize delta specifications into main specifications using the openspec CLI.

Community
Intermediate
memorysavermemorysaver

openspec-sync-specs

Merge delta specs under openspec/changes into main specs.

Community
Intermediate