openspec-verify-change

Verify code implementations against specifications, tasks, and design artifacts.

7|3|Updated Dec 24, 2023
One-click install
npx skills add https://github.com/Pony-Unicorn/react-template --skill openspec-verify-change-pony-unicorn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-verify-change
Source: https://github.com/Pony-Unicorn/react-template/tree/main/.opencode/skills/openspec-verify-change
Command: npx skills add https://github.com/Pony-Unicorn/react-template --skill openspec-verify-change-pony-unicorn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openspec-cli, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that code implementations accurately reflect the intended changes defined in specifications, tasks, and designs, preventing discrepancies before archiving work.

Core Features & Use Cases

  • Completeness Check: Verifies that all defined tasks are completed and all requirements from specs are addressed.
  • Correctness Validation: Assesses if the implementation aligns with requirement intent and covers defined scenarios.
  • Coherence Assessment: Checks adherence to design decisions and project coding patterns.
  • Use Case: Before merging a feature branch, use this Skill to automatically audit the code against its associated tasks.md and specs.md files, flagging any missing implementations or deviations from the design.

Quick Start

Run openspec-verify-change to verify the current change against its artifacts.

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 change specifications before merging?

To verify code implementation against change specifications, you can audit the codebase by mapping implementations to defined tasks, specs, and design documents to flag missing requirements or deviations. This ensures code accurately reflects intended changes before archiving or merging work.

What does a code compliance audit check for in change management?

A code compliance audit checks for completeness by verifying task completion, correctness by mapping implementation to requirements, and coherence by evaluating design adherence and code pattern consistency. It generates a report with critical, warning, and suggestion issues.

Do I need openspec-cli installed to verify change artifacts?

Yes, you need openspec-cli installed to verify change artifacts. The verification process operates by invoking the openspec CLI to list, status, and apply change instructions before analyzing context files and the codebase for discrepancies.

How do I check if my code meets all defined tasks and requirements?

You can check if code meets defined tasks and requirements by performing a completeness check that verifies all tasks are completed and all requirements from specs are addressed, alongside a correctness validation that assesses scenario coverage and requirement intent alignment.

What's the best way to assess design adherence and code pattern consistency?

The best way to assess design adherence and code pattern consistency is through a coherence assessment that evaluates the codebase against established design decisions. This identifies discrepancies and generates a detailed report flagging deviations.

Why does my implementation verification report show critical issues?

Implementation verification reports show critical issues when the codebase analysis detects significant discrepancies between the actual code and the change artifacts. These critical issues indicate missing implementations or severe deviations from the defined specifications and tasks.