[Extension]: Add spec-kit-switch

检查链接的扩展仓库中的拟议目录条目、extension.yml 清单、README.md 和 LICENSE。首先定位仓库的扩展目录及其验证检查。完成标准是准确添加 Spec Switcher 元数据，并且目录仍能通过验证。

Extension ID

switch

Extension Name

Spec Switcher

Version

1.0.0

Description

Navigate between specs — list available specs and switch active feature with git checkout

Author

Wagner Sousa

Repository URL

https://github.com/wagner-sousa/spec-kit-switch

Download URL

https://github.com/wagner-sousa/spec-kit-switch/archive/refs/tags/v1.0.0.zip

License

MIT

Homepage

https://github.com/wagner-sousa/spec-kit-switch

Documentation URL

https://github.com/wagner-sousa/spec-kit-switch#readme

Changelog URL

https://github.com/wagner-sousa/spec-kit-switch/blob/main/CHANGELOG.md

Required Spec Kit Version

=0.4.0

Number of Commands

2

Number of Hooks

0

Tags

navigation, workflow, specs, sdd, git

Key Features

• List all available specs with branch and active status in a table
• Switch between specs via git checkout (avoids feature.json conflicts)
• Auto-unlock previous spec lifecycle on switch via cross-plugin interface
• --local-only flag for branchless specs

Testing Checklist

• Extension installs successfully via download URL
• All commands execute without errors
• Documentation is complete and accurate
• No security vulnerabilities identified
• Tested on at least one real project

Submission Requirements

• Valid extension.yml manifest included
• README.md with installation and usage instructions
• LICENSE file included
• GitHub release created with version tag
• All command files exist and are properly formatted
• Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

Tested on Linux with Spec Kit v0.13.3 in the spec-kit-docker template project. Both commands verified: switch.list shows all specs with branch/status table, switch.set performs git checkout with auto-unlock of previous spec. Cross-plugin interface tested with lifecycle extension for seamless spec transitions.

Example Usage

specify extension add switch --from https://github.com/wagner-sousa/spec-kit-switch/archive/refs/tags/v1.0.0.zip
/speckit.switch.list
/speckit.switch.set 013

Proposed Catalog Entry

{
  "switch": {
    "name": "Spec Switcher",
    "id": "switch",
    "description": "Navigate between specs — list available specs and switch active feature with git checkout",
    "author": "Wagner Sousa",
    "version": "1.0.0",
    "download_url": "https://github.com/wagner-sousa/spec-kit-switch/archive/refs/tags/v1.0.0.zip",
    "repository": "https://github.com/wagner-sousa/spec-kit-switch",
    "homepage": "https://github.com/wagner-sousa/spec-kit-switch",
    "license": "MIT",
    "requires": {
      "speckit_version": ">=0.4.0"
    },
    "provides": {
      "commands": 2
    },
    "tags": ["navigation", "workflow", "specs", "sdd", "git"],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-07-31T00:00:00Z",
    "updated_at": "2026-07-31T00:00:00Z"
  }
}