AGENT SKILL

specrew-version

Show the installed Specrew version and the slash-command compatibility state.

License 许可
MIT
所属仓库
alonf/KeyContextAI
最近更新
2026-08-28
Stars
★ 0
Forks
0

01 前言 Front Matter

name
specrew-version
description
Show the installed Specrew version and the slash-command compatibility state.

03 SKILL.md 正文

specrew-version

Type: Informational Skill Schema: v1 Status: Active Namespace: /specrew Canonical command: /specrew-version

Purpose

Show the installed Specrew version and slash-command compatibility state. Reports both the installed/runtime version and the project baseline version from .specrew/config.yml.

When to Use

  • When a contributor wants to know which version of Specrew is installed.
  • When checking whether the slash-command surface is compatible with the current baseline.
  • When diagnosing compatibility issues before or after specrew update.
  • Invoke this skill when the user says: "What version of Specrew is installed?", "Show Specrew version", "Is the slash-command surface compatible?", "Check Specrew version".

Boundary Safety

This skill provides version and compatibility information only. It does not authorize or imply approval to advance any lifecycle boundary.

Invocation

/specrew-version [--project-path <path>]

Backed by: specrew version / scripts/specrew-version.ps1

Inputs

Input Type Required Description
--project-path string No Target Specrew project path (defaults to current directory)

Outputs

  • Installed Specrew version (from module or Specrew.psd1)
  • Project baseline version (from .specrew/config.yml)
  • Slash-command compatibility state:
    • compatible — the installed version can service the project baseline recorded in .specrew/config.yml
    • incompatible — the installed version is older than the project baseline; upgrade guidance is shown
    • unknown — the installed version cannot be determined
  • Remediation guidance when compatibility is not met:
    • For outdated installed version: Update-Module Specrew or equivalent
    • For a matching development tree: set SPECREW_MODULE_PATH
    • For outdated project baseline: specrew update

Argument Whitelist

Only --project-path is accepted in v1. Unknown arguments are rejected with explicit help guidance.

Failure Guidance

Failure mode Behavior
Unsupported argument Rejected immediately with command-specific help guidance
Missing project setup Continue with version inspection, report the project baseline as missing, and point to specrew init if the project has not been bootstrapped yet
Version cannot be determined Report unknown state and suggest verifying the Specrew module installation
Incompatible baseline Report upgrade guidance (Update-Module Specrew, SPECREW_MODULE_PATH, then specrew update)

Compatibility State

Compatibility is evaluated against the installed/running Specrew version and the project baseline recorded in .specrew/config.yml. If the project baseline is newer than the running module, use Update-Module Specrew or SPECREW_MODULE_PATH to select a matching development tree before refreshing project assets.

Coexistence

Part of the /specrew-* command surface. Coexists with /speckit.* without collision.

See Also

  • /specrew-update — refresh Specrew assets and compatibility baseline
  • /specrew-help — catalog fallback and full command list

04 同仓库更多 Skills