Autonomous development operations powered by GitHub as OS architecture
This plugin is not yet in any themed marketplace. To install it, you'll need to add it from GitHub directly.
Choose your preferred installation method below
A marketplace is a collection of plugins. Every plugin gets an auto-generated marketplace JSON for individual installation, plus inclusion in category and themed collections. Add a marketplace once (step 1), then install any plugin from it (step 2).
One-time setup for access to all plugins
When to use: If you plan to install multiple plugins now or later
Step 1: Add the marketplace (one-time)
/plugin marketplace add https://claudepluginhub.com/marketplaces/all.json
Run this once to access all plugins
Step 2: Install this plugin
/plugin install miyabi-operations@all
Use this plugin's auto-generated marketplace JSON for individual installation
When to use: If you only want to try this specific plugin
Step 1: Add this plugin's marketplace
/plugin marketplace add https://claudepluginhub.com/marketplaces/plugins/miyabi-operations.json
Step 2: Install the plugin
/plugin install miyabi-operations@miyabi-operations
npx miyabi
たったこれだけ。 全て自動で完結します。
Miyabiは、GitHub as OSアーキテクチャに基づいた完全自律型AI開発オペレーションプラットフォームです。
Issue作成からコード実装、PR作成、デプロイまでを完全自動化します。
Agent | 役割 | 主な機能 |
---|---|---|
🎯 CoordinatorAgent | タスク統括 | DAG分解、並列実行制御、進捗管理 |
🏷️ IssueAgent | Issue分析 | 53ラベル自動分類、優先度判定 |
💻 CodeGenAgent | コード生成 | Claude Sonnet 4による高品質実装 |
🔍 ReviewAgent | 品質判定 | 静的解析、セキュリティスキャン |
📝 PRAgent | PR作成 | Conventional Commits準拠 |
🚀 DeploymentAgent | デプロイ | Firebase自動デプロイ・Rollback |
🧪 TestAgent | テスト | Vitest自動実行、80%+カバレッジ |
graph LR
A[Issue作成] --> B[IssueAgent]
B --> C[CoordinatorAgent]
C --> D[CodeGenAgent]
D --> E[TestAgent]
E --> F[ReviewAgent]
F --> G[PRAgent]
G --> H[DeploymentAgent]
H --> I[✅ 完了]
style A fill:#FF6B6B
style I fill:#51CF66
style C fill:#FFD93D
style D fill:#6C5CE7
style F fill:#00D2FF
Miyabiは Claude AI を使用して自動的にコードを生成します。以下の点にご注意ください:
Miyabiプロジェクトは、AI生成コードに起因する問題について一切の責任を負いません。 生成されたコードの品質、セキュリティ、動作については、ユーザー自身で確認・検証してください。
npx miyabi
npm install -g miyabi
miyabi
npm install --save-dev miyabi
npx miyabi
MiyabiはClaude Codeの公式Pluginとしても利用できます。
# Claude Code内で実行
/plugin install miyabi
インストール後、以下のコマンドが利用可能になります:
/miyabi-init # 新規プロジェクト作成
/miyabi-status # ステータス確認
/miyabi-auto # Water Spider自動モード
/miyabi-todos # TODO検出・Issue化
/miyabi-agent # Agent実行
/miyabi-docs # ドキュメント生成
/miyabi-deploy # デプロイ実行
/miyabi-test # テスト実行
Claude Code Pluginとして使用すると、以下のイベントフックが自動実行されます:
pre-commit # コミット前チェック
post-commit # コミット後通知
pre-pr # PR作成前チェック
post-test # テスト後カバレッジレポート
Hooksの機能:
Hook | タイミング | 実行内容 |
---|---|---|
pre-commit | コミット前 | ✅ Lint実行✅ Type check✅ テスト実行 |
post-commit | コミット後 | ✅ コミット情報表示✅ メトリクス更新 |
pre-pr | PR作成前 | ✅ Rebase確認✅ テスト実行✅ カバレッジ確認✅ Conventional Commits検証 |
post-test | テスト後 | ✅ カバレッジレポート生成✅ HTMLレポート出力✅ 結果アーカイブ |
$ npx miyabi
? 何をしますか? 🆕 新しいプロジェクトを作成
? プロジェクト名: my-awesome-app
? プライベートリポジトリにしますか? No
🚀 セットアップ開始...
✓ GitHubリポジトリ作成
✓ ラベル設定(53個)
✓ ワークフロー配置(10+個)
✓ Projects V2設定
✓ ローカルにクローン
🎉 完了!
$ cd my-existing-project
$ npx miyabi
? 何をしますか? 📦 既存プロジェクトに追加
? ドライランで確認しますか? Yes
🔍 プロジェクト解析中...
✓ 言語検出: JavaScript/TypeScript
✓ フレームワーク: Next.js
✓ ビルドツール: Vite
✓ パッケージマネージャー: pnpm
📋 インストール予定:
- 53個のラベル
- 10+個のワークフロー
- Projects V2連携
- セキュリティスキャン設定
$ npx miyabi
? 何をしますか? 📊 ステータス確認
? ウォッチモードを有効にしますか? No
╔════════════════════════════════════╗
║ 📊 Miyabi ステータス ║
╚════════════════════════════════════╝
┌─────────────┬───────┬─────────────┐
│ State │ Count │ Status │
├─────────────┼───────┼─────────────┤
│ Pending │ 2 │ ⏳ 待機中 │
│ Implementing│ 3 │ ⚡ 作業中 │
│ Reviewing │ 1 │ 🔍 レビュー │
│ Done │ 15 │ ✓ 完了 │
└─────────────┴───────┴─────────────┘
📝 最近のPR:
#42 ユーザーダッシュボード追加 (merged 2h ago)
#41 ログインリダイレクト修正 (merged 5h ago)
#40 APIエンドポイントのドキュメント化 (merged 1d ago)
// DAGベースの依存関係解析
const dag = await coordinator.analyzeDependencies(issue);
// 並列実行可能なタスクを自動検出
const parallelTasks = dag.getParallelizableTasks();
// Critical Path最適化
const optimizedPlan = dag.optimizeCriticalPath();
機能:
// Claude Sonnet 4による高品質コード生成
const code = await codeGen.generate({
task: "Implement user authentication",
framework: "Next.js",
testFramework: "Vitest",
coverage: 80
});
機能:
// 静的解析 + セキュリティスキャン
const review = await reviewer.analyze(code);
// 品質スコアリング(80点以上でマージ可能)
if (review.qualityScore >= 80) {
await pr.approve();
}
機能:
Miyabiは明確な組織理論の5原則に基づいた自律型システム設計:
責任の明確化
Clear Accountability
権限の委譲
Delegation of Authority
階層の設計
Hierarchical Structure
結果の評価
Result-Based Evaluation
曖昧性の排除
Elimination of Ambiguity
各AgentがIssueに対する明確な責任を負う
Agentは自律的に判断・実行可能
Coordinator → 各専門Agent
品質スコア、カバレッジ、実行時間で評価
DAGによる依存関係明示、状態ラベルで進捗可視化
カテゴリ | ラベル数 | 例 |
---|---|---|
📊 優先度 | 4 | P0-Critical , P1-High , P2-Medium , P3-Low |
🎯 ステータス | 8 | status:backlog , status:implementing , status:done |
🔧 タイプ | 12 | type:feature , type:bug , type:refactor |
📦 エリア | 15 | area:frontend , area:backend , area:infra |
🤖 Agent | 7 | agent:coordinator , agent:codegen , agent:review |
🎓 難易度 | 5 | complexity:trivial , complexity:simple , complexity:complex |
📈 その他 | 2 | good-first-issue , help-wanted |
従来のシーケンシャル実行:
A → B → C → D → E → F (36時間)
Miyabiの並列実行:
┌─ B ─┐
A ──┤ ├─ F (26時間)
└─ E ─┘
↓ 72%効率化 (-10時間)
目標: 80%+
マージ可能基準
Issue → PR
自動PR作成
.env
ファイル自動除外脆弱性を発見した場合: SECURITY.md
ドキュメント | 説明 |
---|---|
📊 Entity-Relationグラフ | リアルタイムセッション活動の可視化 |
📱 Termux環境ガイド | Android/Termux環境での使用方法 |
🔒 セキュリティポリシー | セキュリティ脆弱性の報告方法 |
🔐 プライバシーポリシー | データ収集とプライバシー保護 |
🤝 コントリビューション | プロジェクトへの貢献方法・CLA |
💬 コミュニティガイドライン | Discordコミュニティの行動規範 |
📦 パブリッシュガイド | npm公開手順 |
🤖 Agent開発ガイド | カスタムAgent作成 |
🔌 Claude Code統合 | Claude Code設定 |
Miyabi Community Discord で開発者と交流しましょう!
🌟 コミュニティで得られるもの:
📚 準備中のドキュメント:
詳細計画: Discord Community Plan • Status: 準備中(Phase 1)
npx miyabi
? 何をしますか?
🌸 初めての方(セットアップガイド)
🆕 新しいプロジェクトを作成
📦 既存プロジェクトに追加
📊 ステータス確認
📚 ドキュメント生成
⚙️ 設定
❌ 終了
# 新規プロジェクト作成
npx miyabi init <project-name> [--private] [--skip-install]
# 既存プロジェクトに追加
npx miyabi install [--dry-run]
# ステータス確認
npx miyabi status [--watch]
# ドキュメント生成
npx miyabi docs [--input ./src] [--output ./docs/API.md] [--watch] [--training]
# 設定管理
npx miyabi config
# セットアップガイド
npx miyabi setup
推奨方法: gh CLI
# GitHub CLIで認証(推奨)
gh auth login
# アプリケーションは自動的に 'gh auth token' を使用
代替方法: 環境変数(CI/CD用)
export GITHUB_TOKEN=ghp_xxxxx
export MIYABI_LOG_LEVEL=info
export MIYABI_PARALLEL_AGENTS=3
要件 | バージョン | 説明 |
---|---|---|
>= 18.0.0 | 推奨: v20 LTS | |
Latest | バージョン管理 | |
- | GitHubアカウント | |
- | Personal Access Token |
OS | サポート状況 |
---|---|
✅ macOS (Intel / Apple Silicon) | |
✅ Linux (Ubuntu, Debian, RHEL系) | |
✅ Windows (WSL2推奨) | |
⚠️ Termux (一部機能制限あり) |
Miyabiへのコントリビューションを歓迎します!
# 1. リポジトリをフォーク
# 2. フィーチャーブランチを作成
git checkout -b feature/amazing-feature
# 3. 変更をコミット(Conventional Commits準拠)
git commit -m 'feat: Add amazing feature'
# 4. ブランチをプッシュ
git push origin feature/amazing-feature
# 5. Pull Requestを作成
Conventional Commits準拠:
feat:
- 新機能fix:
- バグ修正docs:
- ドキュメント更新chore:
- ビルド・設定変更test:
- テスト追加・修正refactor:
- リファクタリングperf:
- パフォーマンス改善Miyabiの開発を支援してください:
プラットフォーム | リンク |
---|---|
🐦 X (Twitter) | @The_AGI_WAY |
💬 Discord | Miyabi Community |
Contact via GitHub profile | |
🌐 Website | note.ambitiousai.co.jp |
Copyright (c) 2025 Shunsuke Hayashi
このソフトウェアは商標保護と特許保護を含むApache 2.0ライセンスの下で提供されています。
AIペアプログラミング
階層的Agent設計の理論的基盤
全ての依存パッケージと コントリビューター
❌ エラーが発生しました: Error: Failed to request device code: Not Found
原因: OAuth Appが未設定のため、デバイスフロー認証が使えません。
解決方法:
repo
- Full control of private repositoriesworkflow
- Update GitHub Action workflowsread:project
, write:project
- Access projects.env
ファイルを作成:
echo "GITHUB_TOKEN=ghp_your_token_here" > .env
npx miyabi
を実行解決方法:
# グローバルインストールを削除
npm uninstall -g miyabi
# npxキャッシュをクリア
rm -rf ~/.npm/_npx
# 最新版を明示的に指定
npx miyabi@latest
⚠️ トークンが無効です。再認証が必要です
解決方法:
# 古いトークンを削除
rm .env
# 新しいトークンを作成(上記の手順に従う)
echo "GITHUB_TOKEN=ghp_new_token" > .env
npx miyabi
🤖 Powered by Claude AI • 🔒 Apache 2.0 License • 💖 Made with Love
npx miyabi
That's it. Everything runs automatically.
Miyabi is a complete autonomous AI development operations platform built on the "GitHub as OS" architecture.
From issue creation to code implementation, PR creation, and deployment—everything is fully automated.
Agent | Role | Key Functions |
---|---|---|
🎯 CoordinatorAgent | Task Orchestration | DAG decomposition, parallel execution, progress tracking |
🏷️ IssueAgent | Issue Analysis | 53-label auto-classification, priority assessment |
💻 CodeGenAgent | Code Generation | High-quality implementation with Claude Sonnet 4 |
🔍 ReviewAgent | Quality Assessment | Static analysis, security scanning |
📝 PRAgent | PR Creation | Conventional Commits compliance |
🚀 DeploymentAgent | Deployment | Firebase auto-deploy & rollback |
🧪 TestAgent | Testing | Vitest auto-execution, 80%+ coverage |
Miyabi uses Claude AI for automatic code generation. Please note:
The Miyabi project is not liable for issues arising from AI-generated code. Users must verify the quality, security, and functionality of generated code themselves.
# Run directly with npx (recommended)
npx miyabi
# Global installation
npm install -g miyabi
miyabi
Miyabi is also available as an official Claude Code Plugin.
# Inside Claude Code
/plugin install miyabi
Available commands after installation:
/miyabi-init # Create new project
/miyabi-status # Check status
/miyabi-auto # Water Spider auto mode
/miyabi-todos # TODO detection & Issue creation
/miyabi-agent # Run agent
/miyabi-docs # Generate documentation
/miyabi-deploy # Execute deployment
/miyabi-test # Run tests
Details: Claude Code Plugin Integration Guide
When used as a Claude Code Plugin, the following event hooks are automatically executed:
pre-commit # Pre-commit checks
post-commit # Post-commit notifications
pre-pr # Pre-PR checks
post-test # Post-test coverage reports
Hook Features:
Hook | Timing | Actions |
---|---|---|
pre-commit | Before commit | ✅ Run linter✅ Type check✅ Run tests |
post-commit | After commit | ✅ Display commit info✅ Update metrics |
pre-pr | Before PR creation | ✅ Check rebase status✅ Run tests✅ Check coverage✅ Validate Conventional Commits |
post-test | After tests | ✅ Generate coverage report✅ Output HTML report✅ Archive results |
npx miyabi
✨ Miyabi
Everything completes with one command
? What would you like to do?
🆕 Create new project
📦 Add to existing project
📊 Check status
❌ Exit
AI agents automatically:
PR completes in 10-15 minutes. Just review and merge.
Documentation | Description |
---|---|
📊 Entity-Relation Graph | Real-time session activity visualization |
📱 Termux Guide | Usage in Android/Termux environment |
🔒 Security Policy | Security vulnerability reporting |
🔐 Privacy Policy | Data collection and privacy protection |
🤝 Contributing | How to contribute & CLA |
💬 Community Guidelines | Discord community code of conduct |
📦 Publication Guide | npm publishing process |
🤖 Agent SDK | Custom agent development |
🔌 Claude Code | Claude Code integration |
Support Miyabi's development:
Platform | Link |
---|---|
🐦 X (Twitter) | @The_AGI_WAY |
💬 Discord | Miyabi Community |
Contact via GitHub profile | |
🌐 Website | note.ambitiousai.co.jp |
Copyright (c) 2025 Shunsuke Hayashi
This software is provided under the Apache 2.0 License with trademark and patent protection.
AI pair programming
Theoretical foundation for hierarchical agent design
All dependency packages and contributors
npx miyabi
🤖 Powered by Claude AI • 🔒 Apache 2.0 License • 💖 Made with Love
1.0.0