openspec-verify-change

Verify OpenSpec change implementations against tasks, specs, and design notes.

114|47|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/huangjia2019/sdd-in-action --skill openspec-verify-change-huangjia2019
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-verify-change
Source: https://github.com/huangjia2019/sdd-in-action/tree/main/week2/code/.opencode/skills/openspec-verify-change
Command: npx skills add https://github.com/huangjia2019/sdd-in-action --skill openspec-verify-change-huangjia2019

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams confirm that an implementation fully, correctly, and coherently implements the change artifacts (specs, tasks, design) before archiving or shipping, reducing regressions and missed requirements.

Core Features & Use Cases

  • Interactive change selection: Lists OpenSpec-managed changes and prompts the user to choose the exact change to verify, avoiding accidental guesses.
  • Artifact inspection: Uses openspec to fetch change context files, then evaluates tasks, delta specs, scenarios, and design notes to build a structured verification view.
  • Three-dimensional verification: Produces a report across Completeness (task/spec coverage), Correctness (requirement and scenario mapping), and Coherence (design adherence and pattern consistency) with CRITICAL/WARNING/SUGGESTION classifications.
  • Graceful degradation: Supports partial checks when only tasks or specs are available and explicitly reports skipped checks with reasons.
  • Use case: Run before archiving a change to surface incomplete tasks, missing requirement implementations, or design divergences that must be fixed first.

Quick Start

Verify change MY_CHANGE and generate a verification report summarizing completeness, correctness, and coherence for archiving.

Frequently Asked Questions about openspec-verify-change

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify code implementation matches change specs before archiving?

Spec-driven verification evaluates tasks, delta specs, and design notes against actual code artifacts before archiving. This structured review checks completeness, correctness, and coherence to ensure readiness for release while reducing missed requirements and regressions.

What is spec-driven verification for code review?

Spec-driven verification is a process that validates whether an implementation fully and correctly realizes change artifacts. It maps requirements and scenarios to code, ensuring design adherence and pattern consistency across three dimensions: completeness, correctness, and coherence, classified by CRITICAL, WARNING, or SUGGESTION findings.

How do I check if all tasks in a change artifact are completed?

You can check task completion by applying a completeness verification check to your change artifacts. This process inspects the tasks list, evaluates coverage against delta specs, and produces a structured report highlighting incomplete tasks, missing requirement implementations, or design divergences that must be fixed before archiving.

Can I verify implementation correctness when only partial specs are available?

Yes, verification can gracefully degrade to support partial checks when only tasks or specs are available. The process explicitly reports any skipped checks with reasons, allowing you to proceed with available context files while surfacing missing requirement implementations or design divergences.

Does openspec verification work without specific design notes?

Yes, openspec verification supports partial checks when only tasks or specs are available, explicitly reporting skipped checks with reasons. This graceful degradation allows you to validate available change artifacts and surface design divergences without requiring all context files to be present.