openspec-sync-change-docs

Solid

Rewrite the active OpenSpec change artifacts under `openspec/changes/CHANGE_NAME/` so they match the code currently implemented on the branch relative to `main`. Use when implementation drift appears after `/opsx:apply`, after review-driven tweaks, or whenever the user asks to sync, refresh, catch up, or align OpenSpec change docs with the real code before verify or archive.

AI & Automation 3,800 stars 263 forks Updated today AGPL-3.0

Install

View on GitHub

Quality Score: 90/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# OpenSpec Sync Change Docs ## Overview Treat the current branch implementation as the source of truth and update the active change docs to describe what was actually built. Keep the edits inside `openspec/changes/<name>/` unless the user explicitly asks for a later sync into `openspec/specs/`. ## Workflow 1. **Select the change** If the user names a change, use it. Otherwise, discover active changes first: ```bash openspec list --json ``` Then: - If there are no active changes, stop and explain there is no active change to sync - If there is exactly one active change, auto-select it - If recent workflow context makes one change clearly intended, use that change and say why - If multiple active changes remain plausible, prompt the user to choose Announce the selected change and the comparison base branch. Default to `main`. If `main` does not exist locally, stop and ask for the correct base branch instead of guessing. 2. **Load the change context** Prefer the OpenSpec CLI: ```bash openspec status --change "<name>" --json openspec instructions apply --change "<name>" --json ``` If the CLI is unavailable or errors, fall back to direct filesystem discovery under `openspec/changes/<name>/` and read whichever of these files exist: - `proposal.md` - `design.md` - `tasks.md` - delta specs in `openspec/changes/<name>/specs/*/spec.md` For each capability touched by the change, read the base-branch main spe...

Details

Author
qixing-jk
Repository
qixing-jk/all-api-hub
Created
8 months ago
Last Updated
today
Language
TypeScript
License
AGPL-3.0

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category