openspec-verify-change

Verify openspec change implementations against artifacts and generate structured reports.

Updated Feb 6, 2024
One-click install
npx skills add https://github.com/081595/mynode --skill openspec-verify-change-081595
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-verify-change
Source: https://github.com/081595/mynode/tree/main/myproject/.github/skills/openspec-verify-change
Command: npx skills add https://github.com/081595/mynode --skill openspec-verify-change-081595

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates verification that a change's implementation matches its change artifacts (specs, tasks, and design) so teams can confidently archive or release changes without missing work.

Core Features & Use Cases

  • Interactive change selection: Lists available openspec changes and prompts the user to select the intended change rather than guessing.
  • Artifact analysis and parsing: Loads tasks.md, delta specs, design.md, and other context files to extract requirements, scenarios, and task checklists.
  • Structured verification report: Produces a completeness, correctness, and coherence scorecard with CRITICAL/WARNING/SUGGESTION issues and actionable recommendations tied to files and locations.
  • Use case: QA or engineering leads validating that a feature branch fully implements delta specs and tasks before archiving or release.

Quick Start

Verify the implementation for change my-change-name and generate a verification report covering completeness, correctness, and coherence.

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 against delta specs before archiving?

To verify implementation against delta specs, the Skill parses change artifacts like tasks.md and design.md, searches the codebase for evidence, and outputs a structured verification report with prioritized issues and recommendations.

What is change artifact validation in software development workflows?

Change artifact validation detects incomplete tasks, missing requirements, and design or implementation divergences by comparing codebase evidence against managed change specs and task lists before release or archiving.

How do I generate a structured verification report for missing requirements?

You generate a structured verification report by selecting an openspec change interactively, loading its context files, and parsing artifacts to produce a completeness, correctness, and coherence scorecard with actionable recommendations.

Do I need the openspec CLI to validate spec implementations?

Yes, you need the openspec CLI to list and load change context files, parse artifacts, and search the codebase for implementation evidence during the verification process.

Can I automate code review for incomplete tasks and design divergences?

You can automate code review by applying this verification to feature branches, which validates that delta specs and task checklists are fully implemented before archiving or release.

What are the limitations of automated spec validation for change management?

Automated spec validation requires managed change artifacts like delta specs and task lists to exist, and it relies on the openspec CLI to load context files, meaning unmanaged or undocumented changes cannot be validated.