インフラ環境メンテナンス Skill

概要

インフラ環境のセットアップ・メンテナンスを対話的に実行するSkillです。ローカル開発環境、Vercel、Neon、GitHub Actions、環境変数管理をカバーします。

参照ドキュメント

重要: ドキュメントは起動時に全て読まない。選択されたカテゴリの実行時に、該当する参照ドキュメントのみを読むこと。各カテゴリの「参照ドキュメント」セクションに記載されたファイルが対象。

設計方針

• docs/einja/steering/infrastructure/environment-variables.md
• docs/einja/steering/infrastructure/deployment.md

手順書

• docs/einja/instructions/environment-setup.md
• docs/einja/instructions/deployment-setup.md
• docs/einja/instructions/vercel-cli-reference.md
• docs/einja/instructions/neon-cli-reference.md
• docs/einja/instructions/local-server-environment-and-worktree.md

Single Source of Truth: このSkillは対話フローの定義であり、具体的なコマンド手順は各カテゴリの参照ドキュメントが正。

実行フロー

mermaid
1graph TB
2    Start[Skill起動] --> Detect[Phase 1: 環境状態の自動検出]
3    Detect --> Judge[Phase 2: 意図判定]
4    Judge -->|意図が明確| Direct[該当カテゴリへ直接遷移]
5    Judge -->|意図が不明確| Menu[AskUserQuestion: メインメニュー]
6    Menu --> Cat[カテゴリ 1-7 選択]
7    Direct --> Exec[実行]
8    Cat --> Exec
9    Exec --> Result[結果報告]

Phase 1: 環境状態の自動検出

Skill起動時に以下を自動検出し、結果をユーザーに表示する。

bash
1# === ファイル存在確認 ===
2for f in .env .env.local .env.keys .env.personal .env.develop .env.staging .env.production .env.preview; do
3  [ -f "$f" ] && echo "✅ $f" || echo "❌ $f"
4done
5
6# === CLI存在確認 ===
7for cmd in vercel neonctl gh dotenvx docker; do
8  command -v "$cmd" >/dev/null 2>&1 && echo "✅ $cmd" || echo "❌ $cmd"
9done
10
11# === Docker/PostgreSQL状態 ===
12docker compose ps 2>/dev/null | grep postgres
13
14# === 開発サーバー状態 ===
15pnpm dev:status 2>/dev/null || echo "停止中"
16
17# === デフォルトトークン設定状況 ===
18DEFAULTS_FILE="${XDG_CONFIG_HOME:-$HOME/.config}/einja/defaults.json"
19if [ -f "$DEFAULTS_FILE" ]; then
20  echo "✅ デフォルトトークン設定ファイル"
21  # jqがある場合はキーの有無を表示
22  if command -v jq >/dev/null 2>&1; then
23    for key in VERCEL_TOKEN NEON_API_KEY GITHUB_TOKEN VERCEL_ORG_ID; do
24      val=$(jq -r ".tokens.${key} // empty" "$DEFAULTS_FILE")
25      [ -n "$val" ] && echo "  ✅ $key" || echo "  ❌ $key"
26    done
27  fi
28else
29  echo "❌ デフォルトトークン未設定"
30fi
31
32# === トークン有効性検証（.env.personal 存在時のみ） ===
33if [ -f ".env.personal" ]; then
34  # 並行実行で高速化（各コマンドにタイムアウト設定）
35  timeout 5 gh auth status 2>/dev/null && echo "✅ GITHUB_TOKEN 有効" || echo "⚠️ GITHUB_TOKEN 無効/未設定" &
36  timeout 5 vercel whoami 2>/dev/null && echo "✅ VERCEL_TOKEN 有効" || echo "⚠️ VERCEL_TOKEN 無効/未設定" &
37  if [ -n "$NEON_API_KEY" ]; then
38    timeout 5 neonctl projects list --api-key "$NEON_API_KEY" >/dev/null 2>&1 && echo "✅ NEON_API_KEY 有効" || echo "⚠️ NEON_API_KEY 無効/期限切れ" &
39  else
40    echo "⚠️ NEON_API_KEY 未設定"
41  fi
42  wait
43fi

検出結果をサマリー表示した上で、AskUserQuestionでメインメニューを表示する。

Phase 2: 意図判定とメインメニュー

意図が明確な場合（質問せずに直接実行）

Skill起動時の引数やユーザーの指示から意図が読み取れる場合は、AskUserQuestionを使わずに該当カテゴリに直接進む。

直接実行の例:

• /infra-maintenance Vercel初期設定 → カテゴリ3: Vercel管理へ直接遷移
• /infra-maintenance ヘルスチェック → カテゴリ6: 環境状態確認へ直接遷移
• Neonのブランチを作成したい → カテゴリ4: Neon管理へ直接遷移
• GitHub Secretsを一括設定して → カテゴリ5: GitHub Secrets管理へ直接遷移
• 環境変数を追加したい → カテゴリ2: 環境変数管理へ直接遷移
• CIが失敗してる → カテゴリ7: GitHub Actions CI/CD管理へ直接遷移
• ワークフローの実行状況を見たい → カテゴリ7: GitHub Actions CI/CD管理へ直接遷移
• デフォルトトークンを設定したい → カテゴリ8: デフォルトトークン管理へ直接遷移
• 共通トークンをプロジェクトに適用したい → カテゴリ8: デフォルトトークン管理へ直接遷移

意図が不明確な場合のみメニューを表示

引数がない、または意図が曖昧な場合のみ、AskUserQuestionで以下の選択肢を提示する。検出結果に基づいて推奨を表示する。

検出結果に基づく推奨ロジック

Phase 1の検出結果から、推奨カテゴリにマーク（推奨）を付与してAskUserQuestionの選択肢に表示する。

カテゴリ1: ローカル環境セットアップ

サブメニュー

• 初回セットアップ: pnpm dev:setup 実行
• 開発サーバー起動: pnpm dev:bg 実行
• サーバー停止: pnpm dev:stop 実行
• ログ確認: pnpm dev:logs 実行

実行手順

ゼロ状態判定

Phase 1の検出結果で .env* ファイルが全て不在の場合、「初回プロジェクトセットアップ」モードとして以下の順序で案内する:

1. 必須CLIツールの確認・インストール案内（Docker含む）
2. pnpm install → pnpm dev:setup の実行
3. 完了後、カテゴリ2（環境変数管理）への誘導

初回セットアップ

1. pnpm install で依存関係インストール
2. pnpm dev:setup で環境セットアップ
3. エラー時: エラー内容を分析し、対話的にトラブルシュート

エラー時の対処

参照ドキュメント

• docs/einja/instructions/local-server-environment-and-worktree.md
• docs/einja/instructions/environment-setup.md

カテゴリ2: 環境変数管理

サブメニュー

• 個人トークン設定: .env.personalにトークンを保存
• チーム共有設定変更: .env.local等の復号→編集→再暗号化
• 新規環境変数追加: プロジェクト全体への変数追加フロー
• 環境変数の状態表示: 現在の設定状態を表示

クイック操作: pnpm env:update を実行すると、個人トークン設定・チーム共有設定変更を対話式ウィザードで実行できます。

実行手順

個人トークン設定

1. 必要なトークンをAskUserQuestionで確認:
   • GITHUB_TOKEN: https://github.com/settings/tokens/new
   • VERCEL_TOKEN: https://vercel.com/account/tokens
   • NEON_API_KEY: https://console.neon.tech/app/settings/api-keys
2. AskUserQuestionでトークン値を入力してもらう
3. .env.personalに保存
4. chmod 600 .env.personal 実行
5. API検証（可能な場合）:
   • GitHub: gh auth status
   • Vercel: vercel whoami
   • Neon: neonctl projects list --api-key $NEON_API_KEY

チーム共有設定変更

1. AskUserQuestionで対象ファイルを選択（.env.local / .env.develop / .env.production / .env.preview）
2. dotenvx decrypt -f <file> --stdout > <file>.tmp
3. 変更内容をAskUserQuestionで確認
4. 編集実行
5. rm <file> && mv <file>.tmp <file>
6. dotenvx encrypt -f <file>
7. コミット案内

新規環境変数追加

1. AskUserQuestionで変数名・用途・対象環境（local/develop/production/preview）を確認
2. 対象環境に応じた.env.*ファイルを特定
3. 暗号化ファイルの場合: チーム共有設定変更と同じフロー（decrypt→編集→encrypt）
4. 非暗号化ファイルの場合（.env/.env.personal）: 直接編集
5. AskUserQuestion: 他環境への展開が必要か確認
6. コミット案内（チーム共有設定の場合）

詳細手順: docs/einja/instructions/environment-setup.mdの「新規環境変数を追加するとき」を参照

参照ドキュメント

• docs/einja/instructions/environment-setup.md

カテゴリ3: Vercel管理

サブメニュー

• 新規プロジェクト作成: Vercelプロジェクトの新規作成（初回のみ）
• 初期設定: プロジェクトリンク・Root Directory設定
• 環境変数同期: dotenvx鍵のVercel同期
• デプロイ状態確認: 最新デプロイ情報表示

実行手順

新規プロジェクト作成（初回のみ）

Vercelにプロジェクトが存在しない場合（ゼロ状態）のみ実行。VERCEL_TOKEN 取得済みが前提。

1. プロジェクト名の推定・確認: package.jsonのnameフィールドからプロジェクト名を推定（@scope/name → name、-monorepo/-templateサフィックス除去）。 フォールバック: Gitリポジトリ名から推定。

   bash
   1BASE_NAME=$(cat package.json | jq -r '.name // empty' | sed 's/@[^/]*\///' | sed 's/-monorepo$//' | sed 's/-template$//')
   2if [ -z "$BASE_NAME" ]; then
   3  BASE_NAME=$(basename "$(git remote get-url origin 2>/dev/null)" .git | sed 's/-template$//')
   4fi
   5# jq未インストール時のフォールバック
   6if [ -z "$BASE_NAME" ]; then
   7  BASE_NAME=$(grep '"name"' package.json | head -1 | sed 's/.*"name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/' | sed 's/@[^/]*\///' | sed 's/-monorepo$//' | sed 's/-template$//')
   8fi

   推定した ${BASE_NAME}-web, ${BASE_NAME}-admin をAskUserQuestionでプロジェクト名と作成対象アプリ（web / admin / 両方）を確認。

2. 既存プロジェクトの確認:

   bash
   1vercel project ls

   既にプロジェクトが存在する場合は「既にVercelに存在します。スキップしますか？」と確認。

3. CLIでプロジェクト作成・Git接続:

   bash
   1# チーム切り替え（必要な場合）
   2vercel switch <team-slug>
   3
   4# apps/ 配下のディレクトリを動的取得
   5APP_DIRS=$(ls -d apps/*/  2>/dev/null | xargs -I{} basename {})
   6for APP_NAME in $APP_DIRS; do
   7  cd "apps/$APP_NAME"
   8  vercel link --project="${BASE_NAME}-${APP_NAME}" --yes
   9  vercel git connect "https://github.com/${GH_ORG}/${GH_REPO}" --yes
   10  cd ../..
   11done

   vercel link はプロジェクトが存在しない場合に自動作成する（vercel-cli-reference.md L287）

4. APIでRoot Directory設定（CLIでは不可: vercel-cli-reference.md L112）:

   bash
   1# apps/ 配下のディレクトリを動的取得
   2APP_DIRS=$(ls -d apps/*/  2>/dev/null | xargs -I{} basename {})
   3for APP_NAME in $APP_DIRS; do
   4  PROJECT_ID=$(cat "apps/$APP_NAME/.vercel/project.json" | jq -r '.projectId')
   5  VERCEL_ORG_ID=$(cat "apps/$APP_NAME/.vercel/project.json" | jq -r '.orgId')
   6  curl -X PATCH "https://api.vercel.com/v9/projects/$PROJECT_ID?teamId=$VERCEL_ORG_ID" \
   7    -H "Authorization: Bearer $VERCEL_TOKEN" \
   8    -H "Content-Type: application/json" \
   9    -d "{\"rootDirectory\": \"apps/$APP_NAME\"}"
   10done

5. プロジェクトID/ORG IDを自動取得・表示:

   bash
   1# apps/ 配下のディレクトリを動的取得
   2APP_DIRS=$(ls -d apps/*/  2>/dev/null | xargs -I{} basename {})
   3for APP_NAME in $APP_DIRS; do
   4  echo "$(echo $APP_NAME | tr '[:lower:]' '[:upper:]'):"
   5  echo "  PROJECT_ID: $(cat "apps/$APP_NAME/.vercel/project.json" | jq -r '.projectId')"
   6  echo "  ORG_ID: $(cat "apps/$APP_NAME/.vercel/project.json" | jq -r '.orgId')"
   7done

   GitHub Secretsへの登録を提案（→ カテゴリ5: 一括設定 Step 2）

初期設定

1. VERCEL_TOKEN確認 → 未設定時はURL案内 + .env.personal保存
2. AskUserQuestionでアプリ選択（web / admin）
3. vercel link --project=$NAME --yes で接続
4. Root Directory設定:

   bash
   1curl -X PATCH "https://api.vercel.com/v9/projects/$PROJECT_ID?teamId=$VERCEL_ORG_ID" \
   2  -H "Authorization: Bearer $VERCEL_TOKEN" \
   3  -H "Content-Type: application/json" \
   4  -d '{"rootDirectory": "apps/$APP_NAME"}'

5. .vercel/project.json からプロジェクトIDとORG IDを自動取得:

   bash
   1VERCEL_PROJECT_ID=$(cat "apps/$APP_NAME/.vercel/project.json" | jq -r '.projectId')
   2VERCEL_ORG_ID=$(cat "apps/$APP_NAME/.vercel/project.json" | jq -r '.orgId')

6. 取得結果を表示し、GitHub Secretsへの登録を提案（→ カテゴリ5）

環境変数同期

注意: CI/CDではmainブランチのみvercel env addで自動同期。develop/staging/PRは--env実行時注入。 以下の手動同期は初回セットアップ時のみ実行。

1. .env.keysからDOTENV_PRIVATE_KEY_*を抽出
2. AskUserQuestionで同期対象を確認（値はマスク表示）
3. 承認後、vercel env rm + vercel env add でVercelに同期
4. 設定結果を vercel env ls で確認

詳細手順: docs/einja/instructions/vercel-cli-reference.mdの「環境変数同期自動化」を参照

デプロイ状態確認

bash
1vercel ls

参照ドキュメント

• docs/einja/instructions/vercel-cli-reference.md
• docs/einja/instructions/deployment-setup.md

カテゴリ4: Neon管理

サブメニュー

• 初期設定: プロジェクト作成・ブランチ戦略初期化
• ブランチ管理: 一覧表示・作成・削除
• 接続文字列取得: 特定ブランチの接続URLを取得
• プロジェクトID取得: 既存プロジェクトのIDを neonctl projects list で自動取得

実行手順

初期設定

1. NEON_API_KEY確認 → 未設定時はURL案内 + .env.personal保存

   • 取得URL: https://console.neon.tech/app/settings/api-keys
   • neonctl authは使用しない（理由: docs/einja/instructions/neon-cli-reference.md「認証方式」参照）→ --api-keyフラグまたはNEON_API_KEY環境変数で認証

2. 既存プロジェクトの確認:

   bash
   1neonctl projects list --api-key $NEON_API_KEY

   既存プロジェクトがあれば一覧表示し、使用するプロジェクトをAskUserQuestionで確認。 既存プロジェクトを使用する場合 → neonctl projects get $PROJECT_ID でIDを取得してステップ4へ。

3. プロジェクト名の推定・確認・作成: 共通推定ロジック（カテゴリ3と同様）で $BASE_NAME を取得。AskUserQuestionで確認（デフォルト値として提示）。

   bash
   1neonctl projects create --name "$NEON_PROJECT_NAME" --region-id aws-ap-northeast-1 --api-key $NEON_API_KEY

   作成後、neonctl projects list でプロジェクトIDを取得:

   bash
   1NEON_PROJECT_ID=$(neonctl projects list --api-key $NEON_API_KEY --output json | jq -r ".[] | select(.name==\"$NEON_PROJECT_NAME\") | .id")

4. .env.preview に自動設定 → dotenvx暗号化:

   bash
   1dotenvx decrypt -f .env.preview --stdout > .env.preview.tmp
   2# 既存の同名変数を削除してから追加（重複防止）
   3grep -v "^NEON_PROJECT_ID=" .env.preview.tmp | grep -v "^NEON_API_KEY=" > .env.preview.clean
   4echo "NEON_PROJECT_ID=$NEON_PROJECT_ID" >> .env.preview.clean
   5echo "NEON_API_KEY=$NEON_API_KEY" >> .env.preview.clean
   6rm .env.preview && mv .env.preview.clean .env.preview
   7dotenvx encrypt -f .env.preview

5. ブランチ戦略初期設定:

   • production（main）ブランチ確認
   • developmentブランチ作成

ブランチ管理

bash
1# 一覧
2neonctl branches list --project-id $NEON_PROJECT_ID --api-key $NEON_API_KEY
3
4# 作成
5neonctl branches create --project-id $NEON_PROJECT_ID --name $NAME --api-key $NEON_API_KEY
6
7# 削除
8neonctl branches delete $BRANCH_ID --project-id $NEON_PROJECT_ID --api-key $NEON_API_KEY

接続文字列取得

bash
1# CLI（単一ブランチ）
2neonctl connection-string <branch-name> --project-id $NEON_PROJECT_ID --api-key $NEON_API_KEY
3
4# API（複数ブランチ一括取得時）
5curl -s "https://console.neon.tech/api/v2/projects/$NEON_PROJECT_ID/connection_uri?branch_id=$BRANCH_ID&database_name=neondb&role_name=$ROLE_NAME" \
6  -H "Authorization: Bearer $NEON_API_KEY"

pooled/unpooled接続の使い分け:

• マイグレーション用（unpooled）: neonctl connection-string <branch> --project-id $NEON_PROJECT_ID --api-key $NEON_API_KEY（デフォルトはpooled=false）
• アプリruntime用（pooled）: neonctl connection-string <branch> --project-id $NEON_PROJECT_ID --api-key $NEON_API_KEY --pooled
• CI/CDワークフローではマイグレーション時にunpooled、アプリビルド時にpooled接続を使い分けている

注意: 孤立ブランチのクリーンアップはcleanup-pr-preview-db.ymlワークフローが自動実行するため、このSkillでは手動クリーンアップを提供しない。

参照ドキュメント

• docs/einja/instructions/neon-cli-reference.md
• docs/einja/instructions/deployment-setup.md

カテゴリ5: GitHub Secrets管理

サブメニュー

• 一覧表示: 現在のSecrets一覧
• 個別設定: 指定したSecretを設定
• 一括設定: .env.keysからdotenvx秘密鍵を一括設定

実行手順

一覧表示

bash
1gh secret list

個別設定

1. AskUserQuestionでSecret名と値を入力
2. gh secret set $NAME --body "<value>"
3. 設定確認: gh secret list

一括設定（全Secrets）

参照: docs/einja/instructions/deployment-setup.md（セクション6）に全Secretsの取得手順あり

Step 1: dotenvx秘密鍵を自動抽出

bash
1for key_name in PREVIEW PRODUCTION DEVELOP STAGING; do
2  value=$(grep "DOTENV_PRIVATE_KEY_${key_name}" .env.keys | cut -d'=' -f2 | tr -d "\"'")
3  if [ -n "$value" ]; then
4    gh secret set "DOTENV_PRIVATE_KEY_${key_name}" --body "$value"
5    echo "✅ DOTENV_PRIVATE_KEY_${key_name} を設定しました"
6  else
7    echo "⚠️ DOTENV_PRIVATE_KEY_${key_name} が .env.keys に見つかりません"
8  fi
9done

Step 2: Vercel関連Secrets

2-a. VERCEL_TOKEN（人間入力が必須）: AskUserQuestionで値を入力してもらう。取得手順:

• Vercel Dashboard（https://vercel.com/account/tokens）> 「Create Token」
• Scope: Full Account を選択
• 入力後、vercel whoami --token $TOKEN で有効性を自動検証

2-b. VERCEL_ORG_ID（自動取得）:

bash
1# apps/web/.vercel/project.json から取得（vercel link 実行済みの場合）
2VERCEL_ORG_ID=$(cat apps/web/.vercel/project.json 2>/dev/null | jq -r '.orgId')
3# 未取得の場合はAPI経由
4if [ -z "$VERCEL_ORG_ID" ] || [ "$VERCEL_ORG_ID" = "null" ]; then
5  VERCEL_ORG_ID=$(curl -s "https://api.vercel.com/v2/teams" \
6    -H "Authorization: Bearer $VERCEL_TOKEN" | jq -r '.teams[0].id')
7fi
8gh secret set VERCEL_ORG_ID --body "$VERCEL_ORG_ID"
9echo "✅ VERCEL_ORG_ID = $VERCEL_ORG_ID を設定しました"

2-c. VERCEL_PROJECT_ID_*（自動取得）:

bash
1# apps/ 配下のディレクトリを動的取得（.vercelが存在するもの）
2for APP_NAME in $(for d in apps/*/; do [ -d "$d/.vercel" ] && basename "$d"; done); do
3  # apps/<app>/.vercel/project.json から取得（vercel link 実行済みの場合）
4  PROJECT_ID=$(cat "apps/$APP_NAME/.vercel/project.json" 2>/dev/null | jq -r '.projectId')
5  if [ -z "$PROJECT_ID" ] || [ "$PROJECT_ID" = "null" ]; then
6    # vercel link 未実行の場合: カテゴリ3（新規プロジェクト作成 or 初期設定）を先に実行するよう案内
7    echo "⚠️ apps/$APP_NAME/.vercel/project.json が見つかりません。先にカテゴリ3でVercelプロジェクトをリンクしてください"
8    continue
9  fi
10  SECRET_NAME="VERCEL_PROJECT_ID_$(echo $APP_NAME | tr '[:lower:]' '[:upper:]')"
11  gh secret set "$SECRET_NAME" --body "$PROJECT_ID"
12  echo "✅ $SECRET_NAME = $PROJECT_ID を設定しました"
13done

Step 3: Turborepo Remote Cache

3-a. TURBO_TOKEN: VERCEL_TOKEN（Step 2-a で取得済み）と同じ値を使用（別トークンを使う場合のみAskUserQuestionで入力）:

bash
1gh secret set TURBO_TOKEN --body "$VERCEL_TOKEN"
2echo "✅ TURBO_TOKEN を設定しました（VERCEL_TOKENと同一値）"

3-b. TURBO_TEAM（自動取得）:

bash
1TURBO_TEAM=$(cat .turbo/config.json 2>/dev/null | jq -r '.teamId // empty')
2if [ -z "$TURBO_TEAM" ]; then
3  echo "⚠️ .turbo/config.json 未生成。先に npx turbo login && npx turbo link を実行します"
4  npx turbo login && npx turbo link
5  TURBO_TEAM=$(cat .turbo/config.json | jq -r '.teamId')
6fi
7gh secret set TURBO_TEAM --body "$TURBO_TEAM"
8echo "✅ TURBO_TEAM = $TURBO_TEAM を設定しました"

参照ドキュメント

• docs/einja/instructions/deployment-setup.md（セクション6: GitHub Secrets登録）

カテゴリ6: 環境状態確認（ヘルスチェック）

チェック対象

ローカル環境

bash
1# ランタイム
2node --version
3pnpm --version
4
5# 環境変数ファイル
6for f in .env .env.local .env.keys .env.personal; do
7  [ -f "$f" ] && echo "✅ $f" || echo "❌ $f"
8done
9
10# Docker/PostgreSQL
11docker compose ps
12docker compose exec postgres pg_isready -U postgres
13
14# 開発サーバー
15pnpm dev:status
16
17# CLIツール
18for cmd in gh vercel neonctl dotenvx; do
19  command -v "$cmd" >/dev/null 2>&1 && echo "✅ $cmd" || echo "❌ $cmd"
20done
21
22# === デフォルトトークン ===
23DEFAULTS_FILE="${XDG_CONFIG_HOME:-$HOME/.config}/einja/defaults.json"
24if [ -f "$DEFAULTS_FILE" ]; then
25  echo "✅ デフォルトトークン設定済み"
26else
27  echo "❌ デフォルトトークン未設定"
28fi
29
30# === トークン有効性検証（.env.personal 存在時のみ） ===
31if [ -f ".env.personal" ]; then
32  # 並行実行で高速化（各コマンドにタイムアウト設定）
33  timeout 5 gh auth status 2>/dev/null && echo "✅ GITHUB_TOKEN 有効" || echo "⚠️ GITHUB_TOKEN 無効/未設定" &
34  timeout 5 vercel whoami 2>/dev/null && echo "✅ VERCEL_TOKEN 有効" || echo "⚠️ VERCEL_TOKEN 無効/未設定" &
35  if [ -n "$NEON_API_KEY" ]; then
36    timeout 5 neonctl projects list --api-key "$NEON_API_KEY" >/dev/null 2>&1 && echo "✅ NEON_API_KEY 有効" || echo "⚠️ NEON_API_KEY 無効/期限切れ" &
37  else
38    echo "⚠️ NEON_API_KEY 未設定"
39  fi
40  wait
41fi

Vercel

bash
1vercel ls

Neon

bash
1neonctl branches list --project-id $NEON_PROJECT_ID --api-key $NEON_API_KEY

GitHub

bash
1gh secret list
2gh run list --limit 5

結果表示

チェック結果を以下の形式でサマリー表示する:

=== 環境ヘルスチェック結果 ===

📦 ローカル環境
  ✅ Node.js 22.16.0
  ✅ pnpm 10.14.0
  ✅ PostgreSQL 起動中
  ✅ 開発サーバー 起動中 (port 3195)
  ❌ .env.personal 不在

🔧 CLI ツール
  ✅ gh 2.x
  ✅ vercel 37.x
  ❌ neonctl 未インストール
  ✅ dotenvx 1.x

🔑 デフォルトトークン
  ✅ VERCEL_TOKEN 設定済み
  ✅ NEON_API_KEY 設定済み
  ✅ GITHUB_TOKEN 設定済み
  ❌ VERCEL_ORG_ID 未設定

🔑 トークン有効性
  ✅ GITHUB_TOKEN 有効
  ✅ VERCEL_TOKEN 有効
  ⚠️ NEON_API_KEY 未設定

☁️ Vercel
  ✅ 最新デプロイ: 2h ago (Ready)

🗄️ Neon
  ✅ ブランチ: 3個 (main, development, preview/feature-auth)

🔐 GitHub Secrets
  ✅ 10個のSecrets設定済み
  ✅ 最新CI: 成功 (2h ago)

推奨アクション提案

ヘルスチェック結果に❌がある場合、以下のルールで推奨アクションを提示する:

❌が3個以上の場合は「初期セットアップが必要です。カテゴリ1を実行してください」と表示。

参照ドキュメント

• docs/einja/instructions/local-server-environment-and-worktree.md（包括的ヘルスチェック）

カテゴリ7: GitHub Actions CI/CD管理

サブメニュー

• ワークフロー状態確認: 最新の実行結果一覧
• 失敗調査: 失敗したワークフローのログ分析
• 手動トリガー: ワークフローの手動実行
• ワークフロー一覧: 利用可能なワークフロー確認

プロジェクトのワークフロー

実行手順

ワークフロー状態確認

bash
1# 最新の実行結果一覧
2gh run list --limit 10
3
4# 特定ワークフローの実行一覧
5gh run list --workflow=deploy-stable-branches.yml --limit 5
6
7# 実行中のワークフロー
8gh run list --status=in_progress

失敗調査

1. 失敗したワークフローの一覧を取得:

   bash
   1gh run list --status=failure --limit 5

2. AskUserQuestionで調査対象のrun-idを選択
3. 失敗したジョブのログを表示:

   bash
   1gh run view <run-id> --log-failed

4. ログ分析→アクション提案: エラーパターンに基づいてカテゴリ遷移を提案

手動トリガー

bash
1# workflow_dispatch対応ワークフローを手動実行
2gh workflow run <workflow-file> --ref <branch>
3
4# 入力パラメータ付き
5gh workflow run <workflow-file> --ref <branch> -f param1=value1
6
7# PRプレビューDBクリーンアップの手動実行
8gh workflow run cleanup-pr-preview-db.yml --ref main

ワークフロー一覧

bash
1# 利用可能なワークフロー一覧
2gh workflow list
3
4# 特定ワークフローの詳細
5gh workflow view <workflow-file>

エラー時の対処

参照ドキュメント

• .github/workflows/ 内の各ワークフローファイル
• docs/einja/instructions/deployment-setup.md
• docs/einja/steering/infrastructure/deployment.md

カテゴリ8: デフォルトトークン管理

概要

組織共通のトークン（dev@einja.net アカウント）をグローバルデフォルトとして ~/.config/einja/defaults.json に保存し、複数プロジェクトで再利用する機能。

クイック操作: pnpm env → 「デフォルトトークン管理」を選択

サブメニュー

• トークンを設定/更新: 個別にデフォルトトークンを入力
• プロジェクトに適用: デフォルトを .env.personal にコピー
• トークンを検証: API接続テスト

管理対象トークン

実行手順

トークンを設定/更新

1. pnpm env → 「デフォルトトークン管理」→「トークンを設定/更新」
2. 各トークンについて設定するか確認（現在値をマスク表示）
3. 入力されたトークンを ~/.config/einja/defaults.json に保存

プロジェクトに適用

1. 「プロジェクトに適用」を選択
2. 各トークンについて .env.personal への適用を確認
3. 承認されたトークンのみ .env.personal に書き込み

トークンを検証

各トークンのAPIエンドポイントに接続テスト:

• GITHUB_TOKEN: https://api.github.com/user
• VERCEL_TOKEN: https://api.vercel.com/v2/user
• NEON_API_KEY: https://console.neon.tech/api/v2/projects

トークン参照の優先順位

プロジェクト .env.personal  >  グローバルデフォルト (~/.config/einja/defaults.json)

セキュリティ

参照ドキュメント

• docs/einja/instructions/environment-setup.md
• docs/einja/steering/infrastructure/environment-variables.md

セキュリティ考慮事項

トークン・API Keyの管理

必須: トークン保存後は chmod 600 .env.personal を実行すること。

CLI vs REST API 使い分け

エラーハンドリング

既存ワークフローとの整合性

競合回避ルール

• 環境変数同期: vercel env addによるVercel環境変数ストアへの書き込みはmainブランチのみ。develop/staging/PRはvercel deploy --envで実行時注入（並行デプロイ間の競合防止）
• 初回セットアップ: Skillでは初回セットアップ時のみ手動同期。以降はGitHub Actionsが自動管理
• Neonブランチクリーンアップ: cleanup-pr-preview-db.ymlが定期実行。Skillでは手動クリーンアップは提供しない
• GitHub Secrets更新: Skillで設定した値はワークフローでそのまま使用される（同じdotenvxコマンド体系）

初版で除外する機能

以下の機能は将来版で対応予定: