- name
- speckit-update
- description
- GitHub Spec Kit (https://github.com/github/spec-kit) のベースバージョン更新やテンプレート/スクリプト同期を行うための手順。Spec Kitの更新、上流リリースとの差分適用、templates/commands/scriptsの取り込み、ローカル運用(日本語化・ブランチ非操作・SPEC-[UUID8桁])の維持が必要なときに使用する。 Use when this capability is needed.
- metadata
- {"author":"akiojin"}
# 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桁]` を維持する。
- 上流の英語テンプレートは日本語に翻訳してから反映する。
---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/akiojin) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->
在 GitHub 查看