project-setup-git

Git によるプロジェクトのセットアップ（Clone/Pull）

概要

このスキルは、ユーザーが npx コマンドで新しいプロジェクトを作成するのではなく、Git（git clone または git pull）を使用してプロジェクトのセットアップまたは初期化を依頼した場合に使用します。このスキルでは、既存のコードベースをダウンロードし、適切な依存関係をインストールして、安全に基本設定を行い、レスポンシブな表示でプロジェクトを実行できるようエージェントを案内します。

依存関係

• なし

クイックスタート

使用例： "project-setup-git スキルを使って、リポジトリ https://github.com/example/repo を作業ディレクトリにクローンし、すべての依存関係をインストールしてください。"

ワークフロー

1. リポジトリのクローンまたは更新（Clone/Pull）

• git clone <url_repositori> . コマンドを使用して、既存のコードベースを現在の作業ディレクトリにクローンします。
• ディレクトリがすでにアクティブな Git リポジトリである場合は、git pull コマンドを使用して最新の変更を取得（fetch）し、マージ（merge）します。

2. 依存関係の検出とインストール

• ルートディレクトリにある lockfile を確認し、使用されている package manager を検出します。
  • package-lock.json がある場合は、npm install を実行します。
  • yarn.lock がある場合は、yarn install を実行します。
  • pnpm-lock.yaml がある場合は、pnpm install を実行します。

3. 環境設定（Environment Setup）

• 環境ファイルのサンプルをコピーします（例：cp .env.example .env、または PowerShell/CMD で適切なコピーコマンドを実行します）。
• 必要な環境変数をユーザーが手動で設定するよう依頼します。

4. プロジェクトの実行

• npm run dev またはプロジェクトの設定に応じた適切な start コマンドを使用して、開発サーバー（development server）を起動します。

よくある間違いと重要なルール

• 機密性の高い認証情報の公開：API キー、パスワード、トークンなどのプロジェクトの認証情報をフロントエンドで公開したり、クライアント側からアクセスできる状態にしたりすることは固く禁じられています。.env ファイルの安全性を必ず確認し、.gitignore に含まれていることを確認してください。
• レスポンシブ表示の無視：セットアップ後に UI やレイアウトをカスタマイズする際、mobile-view first のアプローチを無視すること。インターフェースは常に最初からレスポンシブに設計してください。
• Package Manager の誤検出：yarn.lock または pnpm-lock.yaml があるプロジェクトで npm install を実行すると、プロジェクトの依存関係の一貫性が損なわれる場合があります。
• cd コマンドの使用：ユーザーに提示するコマンドラインで、ターミナルのディレクトリを移動するために cd コマンドを使用しないでください。代わりに、tool run_command の設定で適切な current working directory（Cwd）を指定し、その場所でコマンドを直接実行してください。