# Speckit Update

> GitHub Spec Kit (https://github.com/github/spec-kit) のベースバージョン更新やテンプレート/スクリプト同期を行うための手順。Spec Kitの更新、上流リリースとの差分適用、templates/commands/scriptsの取り込み、ローカル運用（日本語化・ブランチ非操作・SPEC-[UUID8桁]）の維持が必要なときに使用する。

- Skill: `akiojin/speckit-update` (Agent Skill)
- Install (CLI): `npx skillmds@latest add akiojin/speckit-update`
- Raw SKILL.md: https://api.skillmd.com/api/skills/akiojin/speckit-update/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: akiojin (https://skillmd.com/u/akiojin)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/akiojin/speckit-update

---


# Spec Kit Update

GitHub Spec Kit: https://github.com/github/spec-kit

## Overview

GitHub公式 spec-kit の新リリースを既存リポジトリの `.specify/` に反映し、既存の運用ルール（日本語化、ブランチ非操作、SPEC ID形式）を保持したまま更新する。

## Workflow

### 1) 現状把握

- リポジトリ内の spec-kit ベースバージョンを特定する（例: `rg -n "v0\\.0\\.[0-9]+"`）。
- spec-kit 由来の対象を列挙する（例: `.specify/`, `.claude/commands/speckit.*.md`）。

### 2) 上流バージョン確認

- GitHubの spec-kit 最新タグ/リリースを確認する（Web検索またはタグ一覧）。
- 更新対象タグを決め、該当タグを `git clone` で取得する。

### 3) 差分取得

- 上流タグ間 diff か、上流→ローカル diff を取得する。
- 変更対象を重点確認する:
  - `templates/`
  - `templates/commands/`
  - `scripts/`（bash/powershell）
  - `memory/`
- 追加/削除ファイルも必ず把握する。

### 4) ローカル適用

- 上流の変更をローカルに反映する。
- **必須のローカル制約を再適用**:
  - すべて日本語
  - ブランチ操作の禁止（スクリプト/コマンドに checkout/switch/create が残らない）
  - SPEC ID は `SPEC-[UUID8桁]`
- 既存の運用差分がある場合は、短い理由を記録する。

### 5) ドキュメント更新

- バージョン表記を更新する（例: `CLAUDE.md`, `.specify/README.md`）。
- 更新履歴がある場合は追記する。

### 6) 検証と報告

- 主要スクリプトの動作を軽く確認する（`--help`, `--json` 等）。
- `rg` で英語の残存や旧バージョン表記がないか確認する。
- 変更点サマリ、影響範囲、未対応の差分を明確に報告する。

## Guardrails

- ブランチ作成/切替は行わない（ユーザー管理）。
- SPEC ID 形式は必ず `SPEC-[UUID8桁]` を維持する。
- 上流の英語テンプレートは日本語に翻訳してから反映する。