Procedure · 移行動作確認

Snowmole プラグイン移行 動作確認手順書

GitHub リポジトリの owner を ht-fujimoto から Snowmole へ転送した後、プラグイン機構 (Desktop + CLI) と Cloudflare Pages 自動デプロイが壊れず通しで動くかを確認するための最小手順書。

⏱ 所要 約 3 分 ⭐ 難易度 低 👤 対象 管理者のセルフテスト 📅 2026-04-21 実施

目的

この HTML ページが表示されていること自体が、移行成功のエンドツーエンド証明です。Claude Desktop 上で /snowmole-html-report:html-report <指示> を実行 → スキルが発動 → HTML 生成 → wrangler pages deploy 経由で Cloudflare Pages に配信、の全経路が 新しい owner（Snowmole）の設定に切り替わった状態で動いていることを意味します。

旧 owner (ht-fujimoto) 時代に ~/.claude/settings.json に登録されていたマーケットプレイスを削除し、新 URL https://github.com/Snowmole/snowmole-claude-plugin から登録し直した結果が反映できているかを、このページの存在で検証します。

読み方

このページを URL から開けていて、下部の「完了チェックリスト」が見えていれば、全項目 OKと判定して良い。詳細は各セクションを上から順に確認してください。

現状 vs ありたい姿

移行前後でプラグイン機構がどう変わったかを視覚化。

移行前の状態を確認中
個人 GitHub ht-fujimoto/ snowmole-claude-plugin Claude ローカル settings.json 旧 URL 記載 社員配布に個人アカウント URL を使わせる状態
  • 配布 URL が管理者個人のアカウント配下
  • 管理者が離任すると repo アクセスが不安定化
  • 社員に共有するリンクが「個人名＋プラグイン名」で社外的に見栄えが悪い
  • 組織アカウントに将来移管する際に全員の設定更新が必要
会社 GitHub Snowmole/ snowmole-claude-plugin Claude ローカル settings.json 新 URL 反映 会社配下の正式 URL、履歴も引き継ぎ
  • 配布 URL が会社公式の Snowmole/ 配下
  • commit 履歴・issue・PR がそのまま引き継がれている
  • GitHub が旧 URL から新 URL へ自動リダイレクト（当面の互換性）
  • この HTML が表示されている = 全経路が新 URL で通っている証拠

検証フロー

たった 3 ステップ、所要 3 分の最小検証。

STEP 1 CLI で再インストール 旧 marketplace 削除 → 新 URL で add STEP 2 Desktop 再起動 新 URL を GUI に反映 STEP 3 この HTML を送って公開 URL が返ってくれば完全動作

前提条件

以下が揃っていることを前提に実施します:

  • GitHub リポジトリ Snowmole/snowmole-claude-plugin が存在し、transfer が受諾済
  • gh auth status で GitHub 認証が通っている（Private repo アクセスに必要）
  • claude --version が通る（Claude Code CLI 導入済）
  • CLOUDFLARE_API_TOKEN が .zshrc と launchctl の両方に設定済
  • ローカル repo の git remote が https://github.com/Snowmole/snowmole-claude-plugin.git に更新済
01

CLI でプラグインを再インストール

⏱ 約 1 分🖥 ターミナル

旧 URL で登録されていたマーケットプレイスとプラグインを削除し、新 URL で登録し直します。

claude plugin uninstall snowmole-html-report@snowmole && claude plugin marketplace remove snowmole && claude plugin marketplace add https://github.com/Snowmole/snowmole-claude-plugin && claude plugin install snowmole-html-report@snowmole
✔ Successfully uninstalled plugin: snowmole-html-report ✔ Successfully removed marketplace: snowmole ✔ Successfully added marketplace: snowmole (declared in user settings) ✔ Successfully installed plugin: snowmole-html-report@snowmole (scope: user)
💡 反映先

~/.claude/settings.json の extraKnownMarketplaces.snowmole.source.url が https://github.com/Snowmole/snowmole-claude-plugin.git に更新されます。

02

Claude Desktop を完全再起動

⏱ 約 30 秒🖥 macOS

Desktop 起動中のプロセスが旧設定を保持している場合があるので、完全終了 → 起動でプラグイン情報を再読み込みさせます。

osascript -e 'quit app "Claude"' && sleep 3 && open -a Claude
🎨 起動後の確認ポイント

プロンプト欄の「+」→ プラグイン にマウスオーバーして、サブメニューに Html report → が表示されていれば新 URL からの登録が GUI 側にも反映済。

03

このページ自体が証拠（スキル経由で自動生成・デプロイ）

⏱ 約 1 分🖥 Claude Desktop

Desktop 新規チャットで以下を送信したのが、あなたが今読んでいるこの HTML を作った指令です。

/snowmole-html-report:html-report 移行動作確認用の 1 ページ手順書を作って公開して

このスラッシュコマンドを受けて Claude が実行した連鎖:

  1. プラグイン snowmole-html-report@snowmole（新 URL 経由）を発動
  2. SKILL.md / design-system.md / components.md / deploy.md を参照
  3. Hard Gate 6 要素を備える HTML を生成（この文書）
  4. npx wrangler pages deploy で Cloudflare Pages にデプロイ
  5. 共有 URL を返却

🎉 このページが見えている = 全経路が動いている

CLI 再インストール → Desktop 再起動 → スキル発動 → HTML 生成 → wrangler デプロイ の 5 工程が新 URL ベースで一気通貫

動作確認コマンド（手元での追試）

このページを読んでいる方が自分の環境でも同じ検証をしたい場合は、以下を順に実行。

マーケットプレイスが新 URL か確認

cat ~/.claude/settings.json | grep -A1 snowmole
"url": "https://github.com/Snowmole/snowmole-claude-plugin.git"

プラグインが enabled か確認

claude plugin list
snowmole-html-report@snowmole Version: 1.0.0 Scope: user Status: ✔ enabled

Cloudflare 認証が通るか

npx wrangler whoami
👋 You are logged in with a User API Token, associated with the email ...

完了チェックリスト

全て ✓ なら移行完了。社員配布に進んで OK。

  • GitHub で https://github.com/Snowmole/snowmole-claude-plugin にアクセスできる
  • ~/.claude/settings.json の marketplace URL が Snowmole/ に更新されている
  • claude plugin list で snowmole-html-report@snowmole が enabled
  • Claude Desktop「+」→ プラグイン → Html report が表示される
  • このページがブラウザで正常に表示されている（最重要）
  • サイドバー TOC をクリック → 各セクションへスムーズスクロール
  • 「現状 vs ありたい姿」のトグル（❌ ↔ ✅）で表示が切り替わる
  • コピーボタン押下で「✓ コピー」フィードバックが出る
🚀 次のアクション

配布前にやること: ① テスト用 Cloudflare プロジェクト snowmole-deploy-test を削除 ② 社員向け Slack 案内を投稿（手順書 HTML と README URL を添える） ③ Cloudflare API トークンを 1Password 等で社員配布ルートを確保。