openspec-sync-specs

Merge delta specification changes into main openspec CLI documents.

43|24|Updated Jul 3, 2018
One-click install
npx skills add https://github.com/tsedio/tsed-cli --skill openspec-sync-specs-tsedio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/tsedio/tsed-cli/tree/main/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/tsedio/tsed-cli --skill openspec-sync-specs-tsedio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of updating main specification documents with changes defined in delta specification files, ensuring consistency and efficient management of evolving requirements.

Core Features & Use Cases

  • Intelligent Merging: Applies additions, modifications, removals, and renames of requirements and scenarios to main specs without overwriting unrelated content.
  • Agent-Driven Operation: Operates as an agent, directly editing main specs based on delta spec instructions.
  • Use Case: A development team is iterating on a feature. They use delta specs to propose changes to requirements. This Skill applies those changes to the main requirements document, allowing the team to track progress and maintain a single source of truth.

Quick Start

Use the openspec-sync-specs skill to sync the delta specs for the change named 'feature-x-updates'.

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 specification documents?

Syncing delta specs involves intelligently merging added, modified, removed, and renamed requirements from delta files directly into main specification documents while preserving existing unrelated content.

What is a delta specification file and when do I need to merge it?

Delta specification files propose changes to existing requirements within a capability. You merge them when a team iterates on features to update the main requirements document and maintain a single source of truth.

Can I apply modifications to requirements without overwriting existing scenarios?

Yes, you can apply modifications without overwriting existing scenarios. The intelligent merge process targets only specified changes, ensuring unrelated content and scenarios within the main specification document remain fully preserved.

How do I specify a change name when merging delta specs?

You specify a change name by providing it when initiating the sync process. If a change name is not provided, the Skill will automatically prompt you to enter one before locating and applying the delta specs.

Does the merge process support removing and renaming requirements?

Yes, the merge process supports removing and renaming requirements. It intelligently synchronizes added, modified, removed, and renamed requirements and scenarios within specified capabilities during the delta merge.