upgrade-assessment

アップグレード評価

Claude モデルの移行、Claude Code のバージョンアップ、OrchestKit プラグインの更新に向けたプラットフォームのアップグレード準備状況を評価します。6 つの項目について、0〜10 の準備状況スコアを含む、構造化された JSON 評価レポートを生成します。

使用するタイミング

• Claude モデルをアップグレードする前（例：Sonnet 4 から Opus 4.8 へ）
• Claude Code を新しいメジャー／マイナーバージョンにアップグレードする前
• OrchestKit を新しいメジャーバージョンにアップグレードする前
• チーム環境がプラットフォームの変更に対応できるか評価するとき
• モデルまたはプラットフォームの移行に関するリリース計画の一環として

クイックスタート

/ork:upgrade-assessment           # Interactive assessment
/ork:upgrade-assessment --json    # Machine-readable output

---

6 段階のワークフロー

フェーズ 0：範囲の定義

ツール： AskUserQuestion

スキャンを開始する前に、評価の範囲を決定します。ユーザーに次の質問をします。

どの種類のアップグレードを評価しますか？

1. プラットフォーム全体 - モデル + CC バージョン + OrchestKit（包括的）
2. モデルのみ - Claude モデルの切り替え（例：Sonnet 4.5 から Opus 4.8 へ）
3. CC バージョンのみ - Claude Code のバージョンアップ（例：2.1.32 から 2.1.33 へ）
4. OrchestKit のみ - プラグインのバージョンアップ（例：5.x から 6.x へ）

範囲と対象のバージョンを記録します。ユーザーが対象のバージョンを指定しない場合は、フェーズ 2 で最新バージョンを調査します。

---

フェーズ 1：検出

ツール： Bash、Read、Grep、Glob

前提条件の確認と環境の検出を実行します。詳細を読み込むには、検証スクリプトと想定される出力形式について Read("${CLAUDE_SKILL_DIR}/rules/detection-checks.md") を実行します。

---

フェーズ 2：調査

ツール： WebSearch、WebFetch

対象バージョンの新機能と破壊的変更を調査します。

1. モデルの変更： 対象モデルの機能、破壊的変更、新しいツールのサポートを検索します
2. CC バージョンの変更： 変更履歴、新しいフックの種類、スキル形式の変更、非推奨フィールドを検索します
3. OrchestKit の変更： CHANGELOG.md を読み、新規／削除／名称変更されたスキルと、フックの移行要件を特定します

調査クエリ：

"Claude {target_model} capabilities release notes"
"Claude Code {target_version} changelog breaking changes"
"Claude {target_model} vs {current_model} differences"

---

フェーズ 3：コードベースのスキャン

ツール： Grep、Glob、Read

アップグレードの影響を受けるパターンをコードベースからスキャンします。詳細を読み込むには、grep パターンと重大度の分類について Read("${CLAUDE_SKILL_DIR}/rules/codebase-scan-patterns.md") を実行します。

---

フェーズ 4：スコアリング

platform-upgrade-knowledge のスコアリング基準を使用して、6 つの項目について準備状況を 0〜10 で評価します。項目ごとのしきい値、重み付け、スコアの解釈については、Read("${CLAUDE_SKILL_DIR}/references/scoring-rubric.md") を実行して詳細を読み込みます。

---

フェーズ 5：推奨事項

フェーズ 3 の調査結果とフェーズ 4 のスコアに基づいて、優先順位を付けたアクション項目を作成します。優先度の割り当てアルゴリズム、工数の見積もり、推奨事項の構成については、Read("${CLAUDE_SKILL_DIR}/references/recommendation-format.md") を実行して詳細を読み込みます。

---

出力形式

評価結果は、構造化された JSON レポートとして出力されます。完全なスキーマと例については、Read("${CLAUDE_SKILL_DIR}/references/output-format.md") を実行して詳細を読み込みます。

---

実行時の注意事項

モデルのみをアップグレードする場合

フェーズ 1、2、3 に重点を置きます。主な確認項目：

• エージェントの model: フィールド
• コンテキストウィンドウ／出力トークンに関する前提
• 機能に依存するスキルのコンテンツ（例：ビジョン、音声）

CC バージョンをアップグレードする場合

フックの互換性とスキルの形式に重点を置きます。

• フックの種類の登録情報の変更
• スキルのフロントマターにおけるフィールドの追加／削除
• 権限ルールの形式の変更
• 新しい組み込みツールまたは削除されたツール

OrchestKit をアップグレードする場合

プラグインの構成に重点を置きます。

• マニフェストのスキーマ変更
• ビルドシステムの変更
• スキル／エージェントの名称変更または削除
• フックソースの再編成

---

ルールのクイックリファレンス

Read("${CLAUDE_SKILL_DIR}/rules/<file>") で必要に応じて読み込みます：

ルール	影響度	対象内容
detection-checks.md	HIGH	前提条件のチェック、環境検出スクリプト
codebase-scan-patterns.md	HIGH	Grep パターン、重大度の分類
knowledge-evaluation.md	HIGH	6 次元の評価基準、重大度の分類
knowledge-compatibility.md	HIGH	バージョン互換性マトリックス、破壊的変更の検出

関連スキル

• platform-upgrade-knowledge - 評価基準の詳細と互換性マトリックス
• ork:doctor - アップグレード後の健全性検証
• ork:explore - 影響分析のためのコードベース調査
• ork:verify - 移行後の変更の検証
• ork:devops-deployment - CI/CD パイプラインの更新

リファレンス

Read("${CLAUDE_SKILL_DIR}/references/<file>") で必要に応じて読み込みます：

ファイル	内容
scoring-rubric.md	次元ごとの詳細なスコア閾値
recommendation-format.md	優先度の割り当てと工数の見積もり
output-format.md	JSON レポートのスキーマと例

• 追加の評価詳細については、platform-upgrade-knowledge/references/scoring-rubric.md を参照してください
• バージョン互換性の追跡については、platform-upgrade-knowledge/references/compatibility-matrix.md を参照してください