mergegate/docs/GETTING_STARTED.md

Getting Started with miyabi-cli-standalone

Miyabiプロジェクトへようこそ！このガイドでは、ゼロからMiyabiを使い始めるまでの手順を詳しく解説します。

📋 前提条件

必須

• Rust: 1.75.0以上

  rustc --version  # 確認
  

• Git: バージョン管理用

  git --version
  

• GitHubアカウント: Issue/PR管理用

推奨

• GitHub CLI (gh): GitHub操作を簡単に

  brew install gh  # macOS
  gh --version
  

🚀 セットアップ手順

Step 1: 環境変数の設定

1.1 GitHub Personal Access Token取得

1. https://github.com/settings/tokens/new にアクセス
2. Token名を入力（例: "Miyabi Local Dev"）
3. 以下のスコープを選択：
   • ✅ repo (Full control of private repositories)
   • ✅ workflow (Update GitHub Action workflows)
4. "Generate token"をクリック
5. トークンをコピー（一度しか表示されません！）

1.2 環境変数をシェルプロファイルに追加

Bash (.bashrc / .bash_profile):

echo 'export GITHUB_TOKEN=ghp_xxxxx' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY=sk-ant-xxxxx' >> ~/.bashrc
source ~/.bashrc

Zsh (.zshrc):

echo 'export GITHUB_TOKEN=ghp_xxxxx' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=sk-ant-xxxxx' >> ~/.zshrc
source ~/.zshrc

1.3 環境変数確認

echo $GITHUB_TOKEN
echo $ANTHROPIC_API_KEY

Step 2: GitHubリポジトリ作成

2.1 GitHub CLI使用（推奨）

cd miyabi-cli-standalone
gh repo create miyabi-cli-standalone --private --source=. --remote=origin

2.2 手動作成

1. https://github.com/new にアクセス
2. Repository nameに miyabi-cli-standalone を入力
3. "Private"を選択
4. "Create repository"をクリック
5. ローカルリポジトリと接続：

   git remote add origin https://github.com/YOUR_USERNAME/miyabi-cli-standalone.git
   git branch -M main
   git add .
   git commit -m "feat: initial commit 🚀"
   git push -u origin main
   

Step 3: Label体系のセットアップ

Miyabiは53ラベル体系で自動化を制御します。

3.1 自動セットアップ（将来実装予定）

miyabi setup labels

3.2 手動セットアップ

GitHubリポジトリの設定から、以下のラベルを作成：

STATE（8個）:

• 📥 state:pending (Gray)
• 🔍 state:analyzing (Blue)
• 🏗️ state:implementing (Yellow)
• 👀 state:reviewing (Orange)
• ✅ state:done (Green)
• ❌ state:blocked (Red)
• ⏸️ state:on-hold (Purple)
• 🔄 state:reopened (Pink)

（残り45ラベルは.github/labels.ymlを参照）

Step 4: 最初のIssue作成

4.1 GitHub Web UIで作成

1. リポジトリの"Issues"タブをクリック
2. "New issue"をクリック
3. Title: "✨ Setup project configuration"
4. Body:

   ## 概要
   プロジェクトの初期設定を行う
   
   ## タスク
   - [ ] .miyabi.yml の設定確認
   - [ ] GitHub Actionsの設定
   - [ ] 開発環境の準備
   
   ## 期待される成果
   - プロジェクトが動作可能な状態
   

5. Labels:
   • ✨ type:feature
   • ⚠️ priority:P1-High
   • 📥 state:pending
6. "Submit new issue"をクリック

4.2 GitHub CLIで作成

gh issue create --title "✨ Setup project configuration" \
  --body "初期設定タスク" \
  --label "type:feature,priority:P1-High,state:pending"

Step 5: Agent実行

5.1 ステータス確認

miyabi status

出力例：

📊 Project Status

Miyabi Installation:
  ✅ Miyabi is installed
    ✓ .claude/agents
    ✓ .github/workflows

Environment:
  ✅ GITHUB_TOKEN is set
  ✅ DEVICE_IDENTIFIER: YourMac.local

Git Repository:
  ✅ Git repository detected
    Branch: main
    Remotes: origin

5.2 CoordinatorAgent実行

miyabi agent run coordinator --issue 1

Agentは以下を実行します：

1. Issue分析
2. Task分解（DAG構築）
3. Worktree作成
4. Specialist Agent割り当て
5. 並列実行
6. 結果統合

🎯 よくある使い方

Issue処理の基本フロー

# 1. Issue作成（GitHub UI または gh CLI）
gh issue create --title "新機能実装" --label "type:feature"

# 2. Agent実行
miyabi agent run coordinator --issue 2

# 3. ステータス確認
miyabi status

# 4. ログ確認
cat logs/miyabi-*.log

複数Issue並列処理

miyabi agent run coordinator --issues 1,2,3 --concurrency 2

Worktree確認

git worktree list

📚 次に読むべきドキュメント

1. CLAUDE.md - プロジェクトコンテキスト（Claude Codeが自動参照）
2. .claude/QUICK_START.md - 3分で始めるクイックガイド
3. .claude/agents/README.md - Agent一覧と使い方
4. docs/TROUBLESHOOTING.md - トラブルシューティング

🆘 困ったときは

エラーが出た場合

1. docs/TROUBLESHOOTING.md を確認
2. miyabi status で環境確認
3. GitHub Issuesで質問: https://github.com/ShunsukeHayashi/Miyabi/issues

ログ確認

# 最新のログファイル
tail -f logs/miyabi-$(date +%Y%m%d).log

# エラーログのみ抽出
grep -i error logs/miyabi-*.log

🎉 次のステップ

おめでとうございます！Miyabiのセットアップが完了しました。

次は：

1. 独自のAgent仕様作成: .claude/agents/specs/coding/ にカスタムAgent追加
2. Label体系のカスタマイズ: プロジェクトに合わせたLabel追加
3. GitHub Actionsの設定: .github/workflows/ でCI/CD自動化
4. Worktree並列実行: 複数Issueの同時処理

---

Miyabi - Beauty in Autonomous Development 🌸