jpskill.com
🛠️ 開発・MCP コミュニティ

deployment-audit-skill

Use DigitalOcean MCP and related tools to check deployment health, crash logs, environment consistency, and runtime issues for Unite-Hub / Synthex. Use when diagnosing deployment failures or verifying readiness.

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o deployment-audit-skill.zip https://jpskill.com/download/17903.zip && unzip -o deployment-audit-skill.zip && rm deployment-audit-skill.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/17903.zip -OutFile "$d\deployment-audit-skill.zip"; Expand-Archive "$d\deployment-audit-skill.zip" -DestinationPath $d -Force; ri "$d\deployment-audit-skill.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して deployment-audit-skill.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → deployment-audit-skill フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

デプロイメント監査スキル

目的

Synthex / Unite-Hub の DigitalOcean および Vercel 上のデプロイメントを継続的に監視し、トラブルシューティングを行います。

典型的なタスク

  1. DO CLI / MCP を介してクラッシュログを取得します。
    • doctl apps list
    • doctl apps logs <app-id> --type=run_restarted
    • doctl apps logs <app-id> <component> --type=run_restarted
  2. 環境変数の整合性を以下で確認します。
    • .env.local
    • Vercel プロジェクト設定
    • DigitalOcean アプリケーション仕様
  3. 以下を検証します。
    • 正しい Supabase URL とキー
    • 正しい Stripe キー (テスト vs 本番)
    • 正しい callback/redirect URL

出力

  • 人間が読める監査概要を docs/audit/DEPLOYMENT_HEALTH.md に出力します。
  • 問題のエントリを docs/audit/AUDIT_ISSUES_REGISTRY.json に出力します。

環境チェックリスト

必須変数

NEXT_PUBLIC_SUPABASE_URL
NEXT_PUBLIC_SUPABASE_ANON_KEY
SUPABASE_SERVICE_ROLE_KEY
NEXTAUTH_URL
NEXTAUTH_SECRET
GOOGLE_CLIENT_ID
GOOGLE_CLIENT_SECRET
ANTHROPIC_API_KEY

オプション変数

STRIPE_SECRET_KEY
STRIPE_WEBHOOK_SECRET
SENDGRID_API_KEY
RESEND_API_KEY
SEMRUSH_API_KEY
DATAFORSEO_LOGIN
DATAFORSEO_PASSWORD

ヘルスチェックプロセス

ステップ 1: 環境同期

以下の変数を比較します。

  • ローカルの .env.local
  • Vercel 環境変数
  • DigitalOcean アプリケーション仕様

不一致をフラグ付けします。

ステップ 2: ビルド検証

  • npm run build を実行します。
  • TypeScript エラーを確認します。
  • 不足している依存関係を確認します。
  • すべてのルートがコンパイルされることを確認します。

ステップ 3: ランタイム検証

  • 最近のデプロイログを確認します。
  • クラッシュパターンを探します。
  • メモリ/CPU のスパイクを特定します。
  • 低速なエンドポイントをフラグ付けします。

ステップ 4: API ヘルス

  • 主要な API エンドポイントに ping を送信します。
  • 認証が機能することを確認します。
  • データベース接続を確認します。
  • 外部サービス接続を検証します。

よくある問題と修正

問題: "Module not found"

原因: 依存関係の欠落 修正: npm install <module>

問題: "Invalid environment variable"

原因: 変数が設定されていないか、形式が間違っています 修正: .env.local とデプロイメント設定を確認します。

問題: "Memory limit exceeded"

原因: 大量の計算またはメモリリーク 修正: コードを最適化するか、制限を増やすか、キャッシュを追加します。

問題: "Database connection timeout"

原因: 接続が多すぎるか、ネットワークの問題 修正: 接続プーリングを有効にするか、Supabase のステータスを確認します。

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Deployment Audit Skill

Purpose

Continuously monitor and troubleshoot deployments on DigitalOcean and Vercel for Synthex / Unite-Hub.

Typical Tasks

  1. Retrieve crash logs via DO CLI / MCP
    • doctl apps list
    • doctl apps logs <app-id> --type=run_restarted
    • doctl apps logs <app-id> <component> --type=run_restarted
  2. Check environment variable consistency across:
    • .env.local
    • Vercel project settings
    • DigitalOcean app spec
  3. Validate:
    • Correct Supabase URLs and keys
    • Correct Stripe keys (test vs live)
    • Correct callback/redirect URLs

Output

  • Human-readable audit summary in docs/audit/DEPLOYMENT_HEALTH.md
  • Issue entries in docs/audit/AUDIT_ISSUES_REGISTRY.json

Environment Checklist

Required Variables

NEXT_PUBLIC_SUPABASE_URL
NEXT_PUBLIC_SUPABASE_ANON_KEY
SUPABASE_SERVICE_ROLE_KEY
NEXTAUTH_URL
NEXTAUTH_SECRET
GOOGLE_CLIENT_ID
GOOGLE_CLIENT_SECRET
ANTHROPIC_API_KEY

Optional Variables

STRIPE_SECRET_KEY
STRIPE_WEBHOOK_SECRET
SENDGRID_API_KEY
RESEND_API_KEY
SEMRUSH_API_KEY
DATAFORSEO_LOGIN
DATAFORSEO_PASSWORD

Health Check Process

Step 1: Environment Sync

Compare variables across:

  • Local .env.local
  • Vercel environment variables
  • DigitalOcean app spec

Flag mismatches.

Step 2: Build Verification

  • Run npm run build
  • Check for TypeScript errors
  • Check for missing dependencies
  • Verify all routes compile

Step 3: Runtime Validation

  • Check recent deploy logs
  • Look for crash patterns
  • Identify memory/CPU spikes
  • Flag slow endpoints

Step 4: API Health

  • Ping key API endpoints
  • Verify authentication works
  • Check database connectivity
  • Validate external service connections

Common Issues & Fixes

Issue: "Module not found"

Cause: Missing dependency Fix: npm install <module>

Issue: "Invalid environment variable"

Cause: Variable not set or wrong format Fix: Check .env.local and deployment settings

Issue: "Memory limit exceeded"

Cause: Heavy computation or memory leak Fix: Optimize code, increase limit, or add caching

Issue: "Database connection timeout"

Cause: Too many connections or network issue Fix: Enable connection pooling, check Supabase status