claude-code-spec-synclisted
Install: claude install-skill kai-kou/gem-hunter
> 🔴 **GitHub 操作の経路(必読・L-114)**: クラウド実行環境では `gh` がプリインストールされず、
> 導入しても repo スコープ REST が 403 になる。**本ファイル内の `gh ...` コマンドはローカル実行専用** で、
> クラウドでは `mcp__github__*` に読み替える(対応表: `docs/rules/github-mcp-fallback-patterns.md` §2。
> ラベル一覧/作成・マイルストーン・release 作成・variables は MCP に等価が無く **クラウドでは実行不可**・同 §2.5)。
# claude-code-spec-sync スキル
> **必読(起動直後)**: `docs/rules/claude-code-spec-sync.md`(SSOT)を Read してから実行する。
> 分類基準・レーン境界・ガードレールは同ファイルが正本。
## ルールファイル読み込み(トークン最適化対応)
- `docs/rules/claude-code-spec-sync.md`(本レーンの SSOT)
- `docs/rules/session-concurrency-rules.md`(マルチセッション競合防止)
## 設計思想
Claude Code はアップデート頻度が高く、破壊的変更で既存のフック・スキル・設定が
サイレントに壊れることがある(実例: L-101 ツールコールパース退行、L-106 CLAUDE_ENV_FILE 肥大、
Opus 4.8 の effort デフォルト変更)。なお **新モデル世代のリリース自体は原則として追随作業が不要** (運用ファイルのモデル指定はエイリアス既定・`agent-team.md`「モデル指定の方針」)。追随が要るのは エイリアスの解決先を記した参考表と、effort 既定や API 仕様の破壊的変更のみ。本レーンは検知(`tools/check_claude_code_updates.py`・定期)と
対応(本スキル)を分離し、**2つの速度** で追随する:
- **破壊的変更 → 即対応**: 検知したその日のセッションが影響調査→修正→PR→マージまで完遂する
- **新機能・新設定 → 検証・検討フェーズ**: Issue 化し、公式裏取り→適用価値評価→(影響大なら議論型レビュー)→採用/見送り判定を経てから反映する。**検知即反映はしない**
本レーンは **プロジェクト内部資産の仕様追随** を専門に担う。発信はしない。
## 起動トリガー
1. 定期スロット(R-1 ルーティンのプリフライト。スロット定義は開発リポジトリの運用メモが保持): `check_claude_code_updates.py --create-issue` が新規検知
→ `BREAKING_DETECTED` 出力あり = 即対応フロー / 検証 Issue のみ = 検証・検討フローを1件消化
2. 手動: `/claude-code-spec-sync` /「Claude Code の仕様変更に追随して」
3. オープンの `lane:claude-code-spec` Issue が残っている(過去スロットの取りこぼし)
---
## 実行ステップ
### Step 0: 検知 + 対象 Issue の確認
```bash
python3 tools/c