mcpField
S
skill-model-updater

skill-model-updater

github.com/bitwize-music-studioエージェントワークフロー60389 回インストール2 週間前に更新
リポジトリ

skill-model-updater について

skill-model-updaterは、スキルファイルとCLAUDE.md内のClaudeモデル参照を管理するエージェントスキルです。最新のモデルIDを調べ、割り当てられたティアを確認し、古い参照の更新や変更のプレビューを行います。

主な機能

  1. 01最新ClaudeモデルIDの調査
  2. 02スキルファイルとCLAUDE.mdのモデル確認
  3. 03ティアを保ったバージョン更新
  4. 04変更内容のドライラン

活用シーン

  1. 01スキル内のClaudeモデル参照の確認
  2. 02Anthropicのモデル公開後のID更新
  3. 03編集前のモデル変更プレビュー

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bitwize-music-studio/claude-ai-music-skills --skill skill-model-updater

インストール後、Claude Code で/skill-model-updaterを入力して読み込まれたか確認します。

詳細

タスク

コマンド:$ARGUMENTS

コマンドに基づいて、次の処理を行います。

  1. check - 現在のモデルを確認し、すべてのスキルをスキャンして、状況を報告します
  2. update - 古いモデルを現在のバージョンに更新します
  3. update --dry-run - 変更を加えずに、更新される内容を表示します

スキルモデルアップデーター

すべてのスキルファイルでモデルを最新の状態に保ち、スキルが最新の Claude モデルを使用するようにします。


ステップ 1:現在のモデルを確認する

スキルを確認または更新する前に、必ず最初に現在のモデル ID を確認してください。

確認方法
  1. 現在の Anthropic モデルを検索します。

    WebSearch: "Anthropic Claude model IDs 2025" OR "Claude API models list current"
    
  2. 公式ドキュメントを取得します。

    WebFetch: https://docs.anthropic.com/en/docs/about-claude/models
    
  3. 各ティアの現在のモデル ID を抽出します。

    • Opus(最も高性能) - claude-opus-* または claude-*-opus-* を探します
    • Sonnet(バランス型) - claude-sonnet-* または claude-*-sonnet-* を探します
    • Haiku(高速) - claude-haiku-* または claude-*-haiku-* を探します
  4. 日付サフィックス(例:20250514 > 20250114)に基づいて、各ティアの最新バージョンを特定します。

出力形式

確認後、次の形式で報告します。

CURRENT CLAUDE MODELS (discovered)
==================================
Source: docs.anthropic.com/en/docs/about-claude/models
Date checked: [today's date]

Opus:   claude-opus-4-5-20251101
Sonnet: claude-sonnet-4-5-20250929
Haiku:  claude-haiku-4-5-20251001

短縮エイリアス(常に有効で、現在のモデルに解決されます):

  • opus → 現在の Opus モデル
  • sonnet → 現在の Sonnet モデル
  • haiku → 現在の Haiku モデル

ワークフロー

チェックモード
/skill-model-updater check
  1. 現在のモデルを確認します(上記のステップ 1) - WebSearch/WebFetch Anthropic のドキュメント
  2. すべての skills/*/SKILL.md ファイルを Glob で検索します
  3. YAML フロントマターから model: フィールドを抽出します
  4. 確認した現在のモデルと照合します
  5. CLAUDE.md を確認します - ${CLAUDE_PLUGIN_ROOT}/CLAUDE.md をスキャンし、Co-Authored-By: Claude の行にあるモデル名が最新か確認します
  6. 各スキルと CLAUDE.md の状況を報告します

出力形式:

SKILL MODEL AUDIT
=================

Current Models (discovered from docs.anthropic.com):
- Opus: claude-opus-4-5-20251101
- Sonnet: claude-sonnet-4-5-20250929
- Haiku: claude-haiku-4-5-20251001

Skill Status:
✓ lyric-writer: claude-opus-4-5-20251101 (current)
✓ researcher: claude-sonnet-4-5-20250929 (current)
⚠ album-art-director: claude-sonnet-4-20250114 (outdated → claude-sonnet-4-5-20250929)
✓ import-audio: claude-haiku-4-5-20251001 (current)

Summary: 19/20 skills current, 1 needs update
更新モード
/skill-model-updater update
  1. 現在のモデルを確認します(上記のステップ 1)
  2. チェックを実行して、古いスキルを特定します
  3. 古いスキルごとに、次の処理を行います。
    • SKILL.md ファイルを読み込みます
    • model: フィールドを、確認した最新バージョンに更新します
    • スキルのティアを維持します(opus を sonnet に変更しないでください)
  4. CLAUDE.md を更新します - ${CLAUDE_PLUGIN_ROOT}/CLAUDE.md の Co-Authored-By 行が古いモデル名を参照している場合、最新のモデル名に更新します
  5. 実施した変更を報告します

出力形式:

SKILL MODEL UPDATE
==================

Models discovered from docs.anthropic.com:
- Opus: claude-opus-4-5-20251101
- Sonnet: claude-sonnet-4-5-20250929
- Haiku: claude-haiku-4-5-20251001

Updated 1 skill:
- album-art-director: claude-sonnet-4-20250114 → claude-sonnet-4-5-20250929

All skills now current.
ドライランモード
/skill-model-updater update --dry-run

更新モードと同じ処理を行いますが、ファイルは編集せず、変更内容のみを報告します。


モデルの検出ロジック

古いモデルの特定

モデルが次のいずれかに該当する場合、古いモデルです。

  1. 現行のモデルファミリーの旧バージョンである(例:claude-sonnet-4-20250114 と claude-sonnet-4-5-20250929)
  2. 非推奨モデルである(例:claude-3-opus-20240229)
ティアの自動判定

スキルに既存の model: フィールドがあれば、そこからティアを判定します。ハードコードされたティア一覧は必要ありません。

  • モデル名に opus が含まれる場合 → 現在の Opus に更新します
  • モデル名に sonnet が含まれる場合 → 現在の Sonnet に更新します
  • モデル名に haiku が含まれる場合 → 現在の Haiku に更新します
  • モデル名が短縮形(opus、sonnet、haiku)の場合 → 常に最新モデルに解決されるため、そのままにします

これにより、別途対応表を管理することなく、意図されたティアの割り当てを維持できます。


新しいモデルのリリース時

このスキルはモデルを自動的に検出し、既存の割り当てからティアを判定します。

Anthropic が新しいモデルをリリースした場合:

  1. チェックを実行します - /skill-model-updater check で、新しいモデルを自動的に検出します
  2. 変更内容を確認します - 検出されたモデルが正しいことを確認します
  3. 更新を実行します - /skill-model-updater update で変更を反映します

注:ティアの割り当てについては ${CLAUDE_PLUGIN_ROOT}/reference/model-strategy.md に記載されています。このスキルは既存のティアを維持し、バージョン番号のみを更新します。


例:更新サイクル全体

User: "New Claude models released, update skills"

1. Run check (discovers models automatically):
   /skill-model-updater check

   Output:
   - Discovered from docs.anthropic.com: Opus 4.5, Sonnet 4, Haiku 3.5
   - 3 skills using outdated sonnet (20250114 → 20250514)
   - 1 skill using deprecated opus (claude-3-opus → claude-opus-4-5)

2. Run dry-run:
   /skill-model-updater update --dry-run

   Output shows proposed changes

3. Run update:
   /skill-model-updater update

   Output confirms 4 skills updated

4. Verify:
   /skill-model-updater check

   Output: All 21 skills current

エラー処理

モデルフィールドがない場合

SKILL.md に model: フィールドがない場合:

  • 「⚠ [skill]: モデルが指定されていません」と報告します
  • 手動での判断が必要なため、自動では追加しません
不明なモデル

SKILL.md に認識できないモデルがある場合:

  • 「? [skill]: 不明なモデル '[model-id]'」と報告します
  • 手動での確認が必要なため、更新しません
無効な YAML

SKILL.md のフロントマターが不正な形式の場合:

  • 「✗ [skill]: Invalid YAML frontmatter」として報告してください
  • 更新を試みないでください

スコープ

このスキルは次の箇所のモデル参照を更新します:

  1. すべての skills/*/SKILL.md ファイル - YAML フロントマターの model: フィールド
  2. CLAUDE.md - バージョニングセクションの Co-Authored-By: Claude [Model] <[email protected]> 行

どちらの場所も、最新の Claude モデル名と同期している必要があります。


覚えておくこと

  • 更新前に確認 - 何が変更されるかを常に把握してください
  • ティアは自動検出 - スキルは既存のモデルフィールドを読み取り、ティア (opus/sonnet/haiku) を判定します
  • 省略形は安全 - opus、sonnet、haiku は常に現在のバージョンに解決されます
  • ティアの根拠 - 各スキルがそのティアを使用する理由については ${CLAUDE_PLUGIN_ROOT}/reference/model-strategy.md を参照してください
  • CLAUDE.md の共同作成者行 - コミットに使用される現在の最上位ティアのモデル名を反映している必要があります

コメント