Przejdź do treści
Biblioteka skilli
Programowanie · Automatyzacja

openspec-sync-specs

/openspec-sync-specs

Przenosi specyfikacje delta ze zmiany do głównych specyfikacji bez archiwizowania zmiany.

Repozytorium
PeerBanHelper ↗
Licencja
GPL-3.0
Ostatnia zmiana repozytorium
23.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 23.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

GPL-3.0, otwarta.

Co robi i kiedy

Przenosi specyfikacje delta ze zmiany do głównych specyfikacji bez archiwizowania zmiany.

Oryginalny opis (EN)

Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.

Jak działa

SKILL.md bez nagłówków drugiego poziomu · 133 linii, 591 słów

Podgląd SKILL.md
---
name: openspec-sync-specs
description: Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.
license: MIT
compatibility: Requires openspec CLI.
metadata:
  author: openspec
  version: "1.0"
  generatedBy: "1.0.0"
---

Sync delta specs from a change to main specs.

This is an **agent-driven** operation - you will read delta specs and directly edit main specs to apply the changes.
This allows intelligent merging (e.g., adding a scenario without copying the entire requirement).

**Input**: Optionally specify a change name. If omitted, check if it can be inferred from conversation context. If vague
or ambiguous you MUST prompt for available changes.

**Steps**

1. **If no change name provided, prompt for selection**

   Run `openspec list --json` to get available changes. Use the **AskUserQuestion tool** to let the user select.

   Show changes that have delta specs (under `specs/` directory).

   **IMPORTANT**: Do NOT guess or auto-select a change. Always let the user choose.

2. **Find delta specs**

   Look for delta spec files in `openspec/changes/<name>/specs/*/spec.md`.

   Each delta spec file contains sections like:
    - `## ADDED Requirements` - New requirements to add
    - `## MODIFIED Requirements` - Changes to existing requirements
    - `## REMOVED Requirements` - Requirements to remove
    - `## RENAMED Requirements` - Requirements to rename (FROM:/TO: format)

   If no delta specs found, inform user and stop.

3. **For each delta spec, apply changes to main specs**

   For each capability with a delta spec at `openspec/changes/<name>/specs/<capability>/spec.md`:

   a. **Read the delta spec** to understand the intended changes

   b. **Read the main spec** at `openspec/specs/<capability>/spec.md` (may not exist yet)

   c. **Apply changes intelligently**:

   **ADDED Requirements:**
    - If requirement doesn't exist in main spec → add it
    - If requirement already exists → update it to match (treat as implicit MODIFIED)

   **MODIFIED Requirements:**
    - Find the requirement in main spec
    - Apply the changes - this can be:
        - Adding new scenarios (don't need to copy existing ones)
        - Modifying existing scenarios
        - Changing the requirement description
    - Preserve scenarios/content not mentioned in the delta

   **REMOVED Requirements:**
    - Remove the entire requirement block from main spec

   **RENAMED Requirements:**
    - Find the FROM requirement, rename to TO

   d. **Create new main spec** if capability doesn't exist yet:
    - Create `openspec/specs/<capability>/spec.md`
    - Add Purpose section (can be brief, mark as TBD)
    - Add Requirements section with the ADDED requirements

4. **Show summary**

   After applying all changes, summarize:
    - Which capabilities were updated
    - What changes were made (requirements added/modified/removed/renamed)

**Delta Spec Format Reference**

```markdown
## ADDED Requirements

### Requirement: New Feature
The system SHALL do something new.

#### Scenario: Basic case
- **WHEN** user does X
- **THEN** system does Y

## MODIFIED Requirements

### Requirement: Existing Feature
#### Scenario: New scenario to add
- **WHEN** user does A
- **THEN** system does B

## REMOVED Requirements

### Requirement: Deprecated Feature

## RENAMED Requirements

- FROM: `### Requirement: Old Name`
- TO: `### Requirement: New Name`
```

**Key Principle: Intelligent Merging**

Unlike programmatic merging, you can apply **partial updates**:

- To add a scenario, just include that scenario under MODIFIED - don't copy existing scenarios
- The delta represents *intent*, not a wholesale replacement
- Use your judgment to merge changes sensibly

**Output On Success**

```
## Specs Synced: <change-name>

Updated main specs:

**<capability-1>**:
- Added requirement: "New Feature"
- Modified requirement: "Existing Feature" (added 1 scenario)

**<capability-2>**:
- Created new spec file
- Added requirement: "Another Feature"

Main specs are now updated. The change remains active - archive when implementation is complete.
```

**Guardrails**

- Read both delta and main specs before making changes
- Preserve existing content not mentioned in delta
- If something is unclear, ask for clarification
- Show what you're changing as you go
- The operation should be idempotent - running twice should give same result

Wersje

RepozytoriumWynikLicencja
Ta strona · PBH-BTN/PeerBanHelper100GPL-3.0
tsedio/tsed100MIT
bellows-ai/factory100MIT
shunwuyu/ai_lesson100MIT
getsentry/sentry-mcp100Apache-2.0
Fission-AI/OpenSpec100MIT
vhrytsyndyshynquitcode/property-workflows-factory100MIT
CapeOfGoodCode/prepush-ci100MIT
wot-ui/open-wot100MIT

Identyczna treść występuje jeszcze w 2 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki b19d7feeb449 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 96opsx-sync
    Scala delta specyfikacji zmiany z główną specyfikacją w openspec/specs bez archiwizowania zmiany.
  • 100sdd-sync
    Scala delta specs ze zmiany z głównymi specyfikacjami bazowymi w procesie SDD.
  • 100openspec-archive-change
    Archiwizuje ukończoną zmianę OpenSpec po sprawdzeniu artefaktów i zadań oraz proponuje wcześniejsze scalenie specyfikacji delta.
  • 81spec-first
    Prowadzi pracę ze specyfikacjami w repozytorium: tworzy folder .specs, opisuje zmianę, wykonuje kolejne zadanie i synchronizuje specyfikacje.
  • 100spec-propose
    Przygotowuje artefakty zmiany OpenSpec na nowej gałęzi: proposal.md, delta specs, design.md i tasks.md, instaluje reguły fal dla równoległych zadań, waliduje i commituje.
  • 100openspec-sync
    Aktualizuje dokumentację i kontekst zmian OpenSpec po implementacji, przy zapisie stanu sesji albo synchronizacji statusu zmiany.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.