spec-kit-stable-upgrade

English | 中文

A Codex skill for checking the locally installed GitHub Spec Kit version and aligning it to the latest official stable release from GitHub Releases.

What It Does

• Detects the local specify command and installed version
• Treats GitHub Releases as the source of truth for official GitHub Spec Kit stable versions
• Avoids using PyPI versions as the authority for GitHub Spec Kit release alignment
• Installs the exact GitHub release tag requested
• Verifies the result with specify version and specify check

Why This Exists

specify-cli versions visible on PyPI can differ from the GitHub Spec Kit release line. This skill standardizes on the GitHub release tags so users can align with the official GitHub stable version instead of a package version that happens to exist elsewhere.

Files

• SKILL.md: skill instructions and workflow
• agents/openai.yaml: UI metadata for Codex skill listings
• CHANGELOG.md: repository release history
• LICENSE: MIT license

Install

Copy this directory into your Codex environment skills directory:

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills/spec-kit-stable-upgrade"
cp -R ./* "${CODEX_HOME:-$HOME/.codex}/skills/spec-kit-stable-upgrade/"

Then restart Codex.

Stable Install Pattern

The skill standardizes on this installation pattern:

uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git@<tag>

Example:

uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git@v0.6.1

中文说明

这是一个 Codex skill，用于检查本机安装的 GitHub Spec Kit 版本，并将其对齐到 GitHub Releases 上的官方稳定版本。

这个 skill 会做什么

• 检查本机是否存在 specify 命令以及当前版本
• 以 GitHub Releases 作为 GitHub 官方 Spec Kit 稳定版的唯一版本真源
• 避免把 PyPI 上的 specify-cli 版本误当成 GitHub 官方 release 线
• 按指定的 GitHub release tag 安装或切换版本
• 在安装后执行 specify version 和 specify check 做结果校验

为什么需要它

specify-cli 在 PyPI 上看到的版本号，可能和 GitHub 官方 Spec Kit 的发布线不一致。这个 skill 的目标，就是强制把版本判断和升级动作收敛到 GitHub 官方 release tag，避免把包仓库版本误认为官方稳定版。

文件说明

• SKILL.md：skill 的核心规则和执行流程
• agents/openai.yaml：Codex UI/技能列表展示元数据
• CHANGELOG.md：仓库版本变更记录
• LICENSE：MIT 开源许可证

安装方法

把当前目录复制到 Codex 环境级 skills 目录：

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills/spec-kit-stable-upgrade"
cp -R ./* "${CODEX_HOME:-$HOME/.codex}/skills/spec-kit-stable-upgrade/"

然后重启 Codex。

稳定版安装模式

这个 skill 统一使用下面这种安装方式：

uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git@<tag>

示例：

uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git@v0.6.1