openspec-sync-specs

Merge delta specs into main OpenSpec spec files with idempotent updates.

149|22|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/luzhenqian/ai-coding-lab --skill openspec-sync-specs-luzhenqian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/luzhenqian/ai-coding-lab/tree/main/agent/dev-bot/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/luzhenqian/ai-coding-lab --skill openspec-sync-specs-luzhenqian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Delta-spec synchronization automates merging delta-spec changes back into the main specs, reducing manual merge errors and ensuring auditability.

Core Features & Use Cases

  • Agent-driven delta merging: read delta specs and apply changes to main specs with intelligent merging.
  • Preserve content: only apply requested changes and keep unrelated content intact.
  • Interactive selection: prompt user to choose which delta changes to apply when multiple deltas exist.
  • Auto-create/update: create a main spec if missing or update it with added changes.

Quick Start

Run openspec list --json to view available delta changes and select the change you want to merge 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 automate merging delta specs into main specs?

Delta-spec synchronization applies agent-driven merging to apply delta spec changes into main specs. It intelligently merges changes across capabilities and tasks, prompting for selection when multiple deltas exist.

What is agent-driven delta merging in spec management?

Agent-driven delta merging is a spec management process where an agent reads delta specs and applies changes to main specs with intelligent merging. It creates or updates main spec files as needed while preserving unrelated content.

Does delta-spec synchronization preserve unrelated content during merges?

Yes, delta-spec synchronization preserves unrelated content intact. It only applies requested changes from delta specs, satisfying idempotent updates while keeping the rest of the main spec files untouched.

How do I select which delta changes to apply when multiple deltas exist?

When multiple deltas exist, delta-spec synchronization prompts you interactively to choose which delta changes to merge. You can run openspec list --json to view available delta changes and select the desired one.

Can I use delta-spec synchronization to auto-create missing main spec files?

Yes, delta-spec synchronization can auto-create a main spec file if it is missing. It will also update existing main specs with added changes, ensuring idempotent updates across the synchronization process.