# 🌸 Miyabi 完全セットアップガイド **初めての方でも安心！画像付きで超丁寧に解説します。** 所要時間: **約5分** ⏱️ --- ## 📋 このガイドで学べること - GitHubアカウントの準備 - GitHubトークンの作成（コピペでOK） - Miyabiの初期設定 - 最初のプロジェクト作成 **プログラミング経験がなくても大丈夫です！** 📱 --- ## ステップ1️⃣: 必要なものを準備する ### ✅ チェックリスト 以下が揃っているか確認してください： - [ ] **GitHubアカウント** （なければ無料で作れます） - [ ] **パソコン**（Windows / Mac / Linux どれでもOK） - [ ] **インターネット接続** ### GitHubアカウントを持っていない方へ 1. https://github.com を開く 2. 右上の **Sign up** をクリック 3. メールアドレス、パスワードを入力 4. 指示に従って登録完了 > **所要時間**: 約3分 --- ## ステップ2️⃣: GitHubトークンを作成する ### 🤔 トークンって何？ **トークン = あなた専用の合言葉** Miyabiがあなたの代わりにGitHubを操作するための「許可証」です。 パスワードよりも安全で、いつでも無効化できます。 ### 📝 トークン作成手順（超詳しく） #### 1. GitHubにログインする - https://github.com を開く - 右上のアイコンをクリック - **Settings**（設定）を選ぶ #### 2. トークン作成ページに移動する **方法A: 直接リンクを開く（簡単！）** ↓このリンクをクリックするだけ↓ **🔗 https://github.com/settings/tokens/new** **方法B: 手動で移動する** 1. 左サイドバーの一番下 **Developer settings** をクリック 2. 左メニューの **Personal access tokens** をクリック 3. **Tokens (classic)** をクリック 4. 右上の **Generate new token** → **Generate new token (classic)** をクリック #### 3. トークンの設定をする ##### 📝 Note（メモ） ``` Miyabi用トークン ``` ↑これをコピーして貼り付け（名前は何でもOK） ##### ⏱️ Expiration（有効期限） ``` 90 days（90日間） ``` ↑ドロップダウンから選択 **💡 ヒント**: 期限が切れたら、また同じ手順で作り直せます。 ##### ✅ Select scopes（権限の選択） **重要！以下のチェックボックスに✅を入れてください：** ``` ✅ repo ✅ repo:status ✅ repo_deployment ✅ public_repo ✅ repo:invite ✅ security_events ✅ workflow ✅ write:packages ✅ read:packages ✅ delete:packages ✅ admin:org ✅ write:org ✅ read:org ✅ project ✅ read:project ``` **📌 コピペ用チェックリスト:** - `repo`（リポジトリ）← これをチェックすると下の項目も全部チェックされます - `workflow`（ワークフロー） - `write:packages`（パッケージ書き込み）← これをチェックすると`read:packages`もチェックされます - `delete:packages`（パッケージ削除） - `admin:org`（組織管理）← これをチェックすると下の項目も全部チェックされます - `project`（プロジェクト）← これをチェックすると`read:project`もチェックされます #### 4. トークンを生成する 1. ページ一番下の **Generate token**（緑ボタン）をクリック 2. 生成されたトークンが表示されます ``` ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ``` **🚨 超重要 🚨** **このトークンは1回しか表示されません！** 今すぐコピーして、メモ帳などに保存してください。 **コピー方法:** - トークンの右側の📋アイコンをクリック - または、トークン全体を選択してCtrl+C（Mac: Command+C） **💾 保存場所の例:** - メモ帳（Windows） - メモ（Mac） - テキストエディタ（VS Code、Notepadなど） **⚠️ 注意:** - このトークンは誰にも教えないでください - SNSに投稿しないでください - パスワードと同じくらい大切です --- ## ステップ3️⃣: Miyabiをインストール＆設定する ### 🖥️ ターミナル（コマンドプロンプト）を開く #### Windowsの場合 1. キーボードで `Windows + R` を押す 2. `cmd` と入力してEnter 3. 黒い画面が開きます ← これがターミナルです #### Macの場合 1. `Command + Space` でSpotlight検索を開く 2. `terminal` と入力してEnter 3. 白い（または黒い）画面が開きます ← これがターミナルです ### 📦 Miyabiを起動する ターミナルに以下をコピー＆ペーストしてEnterキーを押してください： ```bash npx miyabi ``` **初回のみ以下のメッセージが出たら `y` を入力してEnter:** ``` Need to install the following packages: miyabi@0.2.1 Ok to proceed? (y) ``` ↑ `y` と入力してEnter ### 🎯 設定ウィザードを開始する 画面に以下のような選択肢が表示されます： ``` ✨ Miyabi 一つのコマンドで全てが完結 ? 何をしますか？ ❯ 🆕 新しいプロジェクトを作成 📦 既存プロジェクトに追加 📊 ステータス確認 ⚙️ 設定 ❌ 終了 ``` **矢印キー（↑↓）で `⚙️ 設定` を選んでEnter** ### 📝 質問に答えていく #### Q1: GitHub トークンを設定しますか？ ``` ? GitHub トークンを設定しますか？ (Y/n) ``` **答え**: `Y` を入力してEnter（または何も入力せずEnter） #### Q2: GitHub トークン: ``` ? GitHub トークン: [hidden] ``` **答え**: ステップ2でコピーしたトークンを貼り付けてEnter **貼り付け方:** - Windows: 右クリック または Ctrl+V - Mac: Command+V **💡 ヒント**: 入力中は表示されませんが、ちゃんと入力されています！ #### Q3: 新規プロジェクトをデフォルトでプライベートにしますか？ ``` ? 新規プロジェクトをデフォルトでプライベートにしますか？ (Y/n) ``` **答え**: - 公開プロジェクトが多い → `n` を入力 - 非公開プロジェクトが多い → `Y` を入力（おすすめ） **🤔 迷ったら**: `Y`（プライベート）がおすすめです #### Q4: CLI の言語: ``` ? CLI の言語: (Use arrow keys) ❯ 日本語 English ``` **答え**: 矢印キーで選んでEnter（日本語がおすすめ） #### Q5: 詳細なエラーメッセージを表示しますか？ ``` ? 詳細なエラーメッセージを表示しますか？ (y/N) ``` **答え**: - プログラミング初心者 → `N`（シンプルなメッセージ） - 詳しく知りたい → `y` **🤔 迷ったら**: `N`がおすすめです #### Q6: Issue の自動ラベリングを有効にしますか？ ``` ? Issue の自動ラベリングを有効にしますか？ (Y/n) ``` **答え**: `Y`（おすすめ） **💡 説明**: AIが自動でIssueに適切なラベルを付けてくれます #### Q7: PR の自動レビューを有効にしますか？ ``` ? PR の自動レビューを有効にしますか？ (Y/n) ``` **答え**: `Y`（おすすめ） **💡 説明**: AIが自動でPull Requestをレビューしてくれます #### Q8: GitHub Projects との自動同期を有効にしますか？ ``` ? GitHub Projects との自動同期を有効にしますか？ (y/N) ``` **答え**: - GitHub Projectsを使う → `y` - 使わない or 分からない → `N` **🤔 迷ったら**: `N`で大丈夫です（後で変更できます） ### ✅ 設定完了！ 以下のメッセージが表示されたら成功です： ``` ✓ 設定ファイルを保存しました: .miyabi.yml ✅ 設定を保存しました 保存された設定: GitHub トークン: 設定済み デフォルトプライベート: 有効 言語: 日本語 ... ``` **🎉 おめでとうございます！セットアップ完了です！** --- ## ステップ4️⃣: 最初のプロジェクトを作成する ### 🚀 プロジェクト作成コマンド ターミナルで以下を実行： ```bash npx miyabi ``` 選択肢から **`🆕 新しいプロジェクトを作成`** を選んでEnter ### 📝 プロジェクト名を入力 ``` ? プロジェクト名: (my-project) ``` **例:** ``` my-first-project ``` **ルール:** - 英数字、ハイフン（-）、アンダースコア（_）のみ - スペースや日本語は使えません - 例: `my-app`, `test_project`, `sample-2024` ### 🔒 プライベート設定 ``` ? プライベートリポジトリにしますか？ (y/N) ``` **答え:** - 非公開にしたい → `y`（おすすめ） - 公開したい → `N` ### ⏳ セットアップ中... 以下の処理が自動で行われます： ``` 🚀 セットアップ開始... ✓ リポジトリを作成しました: your-username/my-first-project ✓ ラベルをデプロイしました（53個） ✓ ワークフローをデプロイしました ✓ ローカルプロジェクトを初期化しました ✓ Welcome Issueを作成しました 🎉 セットアップ完了！ ``` ### ✅ 完成！ プロジェクトフォルダに移動します： ```bash cd my-first-project ``` GitHubを開いて確認してみましょう： ```bash gh repo view --web ``` ↑ブラウザで自動的にプロジェクトが開きます --- ## 🎯 次は何をする？ ### 💡 Issueを作成してAIに実装してもらう ```bash gh issue create --title "ログイン機能を追加" --body "ユーザーログイン機能を実装してください" ``` ↑これを実行すると... **数分後、AIエージェントが自動的に:** 1. Issueを分析 2. コードを実装 3. Pull Requestを作成 **あなたはPRをレビューしてマージするだけ！** 🎉 ### 📊 ステータスを確認する ```bash npx miyabi ``` ↑メニューから **`📊 ステータス確認`** を選ぶ エージェントの動きをリアルタイムで見られます！ --- ## 🆘 困ったときは ### トークンを忘れた もう一度作成してください（ステップ2）。古いトークンは自動的に無効化されます。 設定を更新： ```bash npx miyabi ``` ↑メニューから **`⚙️ 設定`** を選んで新しいトークンを入力 ### エラーが出た 1. **インターネット接続を確認** 2. **GitHubにログインしているか確認** 3. **トークンの権限が正しいか確認**（ステップ2の✅項目） まだ解決しない場合: - GitHub Issuesで質問: https://github.com/ShunsukeHayashi/Autonomous-Operations/issues - トークンを貼り付けないように注意！ ### コマンドが見つからない Node.jsがインストールされていない可能性があります。 **Node.jsをインストール:** - https://nodejs.org/ - 左側の「LTS（推奨版）」をダウンロード＆インストール インストール後、ターミナルを再起動してもう一度試してください。 --- ## 📚 もっと詳しく知りたい ### ドキュメント - [README.md](./README.md) - 全機能の説明 - [Agent Operations Manual](../../docs/AGENT_OPERATIONS_MANUAL.md) - エージェントの仕組み - [Testing Guide](../../docs/TESTING_GUIDE.md) - テスト方法 ### コミュニティ - GitHub Discussions: https://github.com/ShunsukeHayashi/Autonomous-Operations/discussions - Issues: https://github.com/ShunsukeHayashi/Autonomous-Operations/issues --- ## ✨ まとめ **今日学んだこと:** ✅ GitHubトークンの作成方法 ✅ Miyabiのインストールと設定 ✅ 最初のプロジェクト作成 ✅ AIエージェントの使い方 **次のステップ:** 1. 実際にIssueを作成してみる 2. AIが作成したPRをレビューする 3. プロジェクトを育てていく **🎉 おめでとうございます！** あなたは今、AI駆動開発の世界に足を踏み入れました。 --- **何か質問がありますか？** 気軽にIssueを立ててください： https://github.com/ShunsukeHayashi/Autonomous-Operations/issues/new **楽しい開発ライフを！** 🚀✨