live-dev-config について
コードリポジトリとクラウドホスティングを連携し、認証情報を安全に集めるための設定スキルです。GitHub リポジトリや Vercel プロジェクトの準備、認証フォーム、秘密情報の安全な受け渡しを案内します。
主な機能
- 01GitHub リポジトリの設定
- 02Vercel プロジェクトの連携
- 03ローカル認証情報フォーム
- 04gitignore 対象の .env.local への保存
- 05秘密情報の安全な転送
活用シーン
- 01リポジトリと GitHub の連携
- 02プロジェクトと Vercel の接続
- 03デプロイ用サービスキーの収集
- 04Vercel または GitHub Secrets への認証情報の登録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ drgarbage/ ag-course-index --skill live-dev-configインストール後、Claude Code で/live-dev-configを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdresources/credential-form.jsread-env-value.js詳細
live-dev-config
このスキルでは、コードリポジトリの連携、クラウドホスティングの設定、安全な認証情報の収集を扱います。
bash ブロックは POSIX 準拠です(Windows では Git Bash)。1つを超えるコマンドやパイプを使うロジックは、シェルの制御フローではなく、resources/*.js に記述します。お使いの Bash ツールが cmd.exe または PowerShell の場合は、実行前に各スニペットを書き換えてください。
1. プロビジョニングとプロジェクトの連携
次の順序で、リポジトリとホスティングのリソースを設定または確認します。
| リソース | スキップする条件 | 制約 |
|---|---|---|
| GitHub リポジトリ | リモートが存在する場合 | 1つ以上のコミットがあるリポジトリで、gh repo create --private --source=. --push を実行します。リポジトリ名はフォルダー名がデフォルトです。それ以外はユーザーに尋ねません。公開リポジトリにするのは、依頼があった場合のみです。 |
| Vercel プロジェクト | .vercel/project.json がある場合 | 非対話型の vercel link --yes を実行します。連携すると、Vercel と GitHub の統合も設定されます。 |
2. 安全な認証情報の収集
認証情報が Git の履歴、コマンドラインのログ、シェルの実行パスに漏れないようにしてください。
2.1 認証情報の収集
この手順で必要なものだけ(サービスアカウントの JSON や特定の API キーなど)を含む .credential-fields.json を出力します。
[{ "name": "FIREBASE_SERVICE_ACCOUNT", "label": "Firebase 服務帳戶金鑰",
"help": "Project settings → Service accounts → Generate new private key",
"link": "https://console.firebase.google.com/project/<id>/settings/serviceaccounts/adminsdk" }]
node resources/credential-form.js .credential-fields.json # launch via the TOOL's background mode, NOT a shell `&`
- 認証情報フォーム: 127.0.0.1 のみでアクセスできるフォームを起動し、ブラウザーを開いて、Git の対象外になっている
.env.localファイルに書き込み、終了します。ブラウザーが自動的に開かない場合は、URL をユーザーに伝えてください。 - 手動テンプレートのフォールバック: ブラウザーを開けない場合は、ユーザーが値を入力して
.env.localに保存できるように、.env.local.templateをKEY_NAME= # 説明とリンクの形式で書き込みます。 - コマンドラインインターフェースでのログイン: CLI ログイン(
gh auth login、vercel login、firebase login)には、各ツールの標準のデバイスフローを使用します。
2.2 セキュリティガイドライン
.env.local を source または eval で読み込んではいけません。また、認証情報を二重引用符や <<< に埋め込んではいけません(シェルの展開によってコードが実行される可能性があります)。read-env-value.js を使って値を取り出し、標準入力にパイプします。
node resources/read-env-value.js .env.local FIREBASE_SERVICE_ACCOUNT | vercel env add FIREBASE_SERVICE_ACCOUNT production
# or GitHub secrets:
node resources/read-env-value.js .env.local FIREBASE_SERVICE_ACCOUNT | gh secret set FIREBASE_SERVICE_ACCOUNT
報告にはキー名のみを使用します:✅ <KEY> が Vercel/本番環境に設定されました / ✅ <KEY> が GitHub Secrets に設定されました。