{"id":31023821,"url":"https://github.com/shinya-reiji/github-mcp-auto-git","last_synced_at":"2025-09-23T07:51:31.264Z","repository":{"id":306577568,"uuid":"1026673534","full_name":"Shinya-Reiji/github-mcp-auto-git","owner":"Shinya-Reiji","description":"🚀 Claude Code サブエージェント機能を活用した自動Git操作ツール","archived":false,"fork":false,"pushed_at":"2025-07-27T03:31:14.000Z","size":17209,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-13T15:16:55.973Z","etag":null,"topics":["ai-tools","claude-code","developer-tools","git-automation","github-integration","subagent","typescript"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Shinya-Reiji.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-26T11:21:36.000Z","updated_at":"2025-07-27T03:31:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"077ccc90-7657-4ded-9c8d-10344ccbef64","html_url":"https://github.com/Shinya-Reiji/github-mcp-auto-git","commit_stats":null,"previous_names":["shinya-reiji/github-mcp-auto-git"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Shinya-Reiji/github-mcp-auto-git","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shinya-Reiji%2Fgithub-mcp-auto-git","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shinya-Reiji%2Fgithub-mcp-auto-git/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shinya-Reiji%2Fgithub-mcp-auto-git/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shinya-Reiji%2Fgithub-mcp-auto-git/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Shinya-Reiji","download_url":"https://codeload.github.com/Shinya-Reiji/github-mcp-auto-git/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shinya-Reiji%2Fgithub-mcp-auto-git/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276538267,"owners_count":25659932,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-23T02:00:09.130Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","claude-code","developer-tools","git-automation","github-integration","subagent","typescript"],"created_at":"2025-09-13T14:52:30.055Z","updated_at":"2025-09-23T07:51:31.254Z","avatar_url":"https://github.com/Shinya-Reiji.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 GitHub MCP Auto Git System v3.0\n\n**プロダクション完成・メモリ効率化・統合MCP完了の超高性能自動Git操作ツール**\n\nファイルを保存するだけで、AIが自動的にコミットメッセージを作成し、安全性をチェックして、Gitにコミットしてくれる革新的なツールです！Constitutional AI原則に基づく企業級品質を実現。\n\n## 🎉 バージョン3.0のプロダクション完成\n\n### 🌟 企業級完全実装達成\n- **メモリ効率化システム**: MemoryEfficientExecutor・並列エージェント最適化\n- **統合MCPマネージャー**: UnifiedMCPManager・重複排除・一元管理\n- **モジュール完全分割**: 672行→5モジュール・保守性大幅向上\n- **95テストケース**: 包括的品質保証・企業級信頼性\n- **Constitutional AI 100%準拠**: Fail Fast・Be Lazy・TypeScript First\n\n### 🔧 技術的完全実装\n- **プロダクション品質**: 実用環境完全対応・即座実用可能\n- **完全型安全**: TypeScript strict mode・コンパイル時検証\n- **高性能並列処理**: 3エージェント効率実行・メモリ監視\n- **企業級エラーハンドリング**: 多層防御・グレースフル処理\n\n## 📖 このツールができること\n\n### 🎯 主な機能\n- **📁 ファイル監視**: 保存したファイルを自動で検出\n- **🛡️ 安全チェック**: 機密情報や危険な変更を自動検出\n- **📝 メッセージ生成**: 非エンジニアにも分かりやすいコミットメッセージを自動作成\n- **🔀 プルリクエスト管理**: 適切なマージ戦略を自動判定\n- **⚡ 並列処理**: 3つのAIエージェントが同時に作業\n- **🧙‍♂️ セットアップウィザード**: インタラクティブな初期設定ガイド\n- **🔧 Claude Code最適化**: 適応的タイムアウトとパフォーマンス追跡\n- **🌐 GitHub MCP統合**: 高度なGitHub操作をMCPプロトコル経由で実行\n\n### 💡 誰に役立つか\n- **個人開発者**: 面倒なGit操作から解放\n- **チーム開発**: 一貫したコミットメッセージでプロジェクト管理\n- **非エンジニア**: 技術的な詳細を知らなくても安全にファイル管理\n- **学習者**: 良いGit運用を自動で学習\n\n## 🎬 使用例\n\n### ❌ 従来の方法（面倒...）\n```bash\n# 毎回これを繰り返す必要がありました\ngit add .\ngit commit -m \"何を変更したか考える...\"  # ← 何を書けばいいか分からない\ngit push\n```\n\n### ✅ このツールを使うと\n```bash\n# 1. 最初に一度だけ設定\ngithub-auto-git init      # 設定ファイル作成\ngithub-auto-git watch     # ⭐ 監視開始（メイン機能）\n\n# 2. 後はファイルを保存するだけ！\n# → AIが自動的に以下を実行:\n#   ✓ 安全性チェック（機密情報の検出など）\n#   ✓ 分かりやすいコミットメッセージ生成\n#   ✓ 自動コミット・プッシュ\n#   ✓ 必要に応じてプルリクエスト作成\n```\n\n## 🚀 かんたんセットアップ\n\n### 1. インストール\n\n#### オプション A: npm から（推奨）\n```bash\n# Node.jsが必要です（https://nodejs.org/）\nnpm install -g github-mcp-auto-git\n```\n\n#### オプション B: GitHubから直接\n```bash\ngit clone https://github.com/Shinya-Reiji/github-mcp-auto-git.git\ncd github-mcp-auto-git\nnpm install\nnpm run build\nnpm link  # グローバルにリンク\n```\n\n### 2. 初期設定\n\n#### オプション A: セットアップウィザード（推奨）\n```bash\n# プロジェクトフォルダで実行\ncd your-project\ngithub-auto-git setup  # 🧙‍♂️ インタラクティブガイド\n```\n\nウィザードが全ての設定を案内してくれます！\n\n#### オプション B: 手動設定\n```bash\n# 従来の方法\ngithub-auto-git init\n```\n\n### 3. 環境変数設定（オプション）\nプルリクエスト機能を使いたい場合のみ：\n\n```bash\n# .env ファイルを作成\ncp .env.example .env\n\n# .env ファイルを編集\nGITHUB_OWNER=あなたのGitHubユーザー名\nGITHUB_REPO=リポジトリ名\nGITHUB_TOKEN=GitHubトークン\n```\n\n\u003e 💡 **詳細なGITHUB_TOKEN設定方法**: `github-auto-git token` コマンドで詳しいガイドを表示できます。\n\n\u003e 💡 **重要**: OpenAI APIキーは不要です！Claude Codeの組み込み機能を使用します。\n\n### 4. 監視開始（推奨・メイン機能）\n```bash\ngithub-auto-git watch\n```\n\n**⭐ これがメインの使い方です！** ファイルを保存するたびに自動でGit操作が実行されます。\n\nこれで完了！後はファイルを編集・保存するだけです。\n\n## 🛠️ コマンド一覧\n\n| コマンド | 説明 | 使用例 |\n|---------|------|--------|\n| `setup` | 🧙‍♂️ **インタラクティブセットアップウィザード（初回推奨）** | `github-auto-git setup` |\n| `watch` | ⭐ **ファイル監視を開始（推奨・メイン機能）** | `github-auto-git watch` |\n| `commit` | 手動でGit操作実行 | `github-auto-git commit` |\n| `commit [files]` | 特定ファイルのみコミット | `github-auto-git commit src/app.js` |\n| `status` | システム状態を表示 | `github-auto-git status` |\n| `token` | GITHUB_TOKEN設定ガイド表示 | `github-auto-git token` |\n| `init` | 設定ファイルを作成 | `github-auto-git init` |\n\n## 🤖 サブエージェント機能\n\nこのツールは3つの専門AIエージェントが連携して動作します：\n\n### 🛡️ Git Safety Analyzer（安全性分析エージェント）\n- **役割**: 危険な変更を事前に検出\n- **チェック項目**:\n  - 🔐 APIキーやパスワードの漏洩\n  - 💥 大量ファイル削除などの破壊的操作\n  - 📦 大容量ファイルの検出\n  - ⚙️ 重要設定ファイルの変更\n\n### 📝 Commit Message Generator（メッセージ生成エージェント）\n- **役割**: 分かりやすいコミットメッセージを自動生成\n- **特徴**:\n  - 👥 非エンジニアにも理解できる表現\n  - 📋 変更理由と効果を明確に説明\n  - 🏷️ 技術標準（Conventional Commits）にも準拠\n  - 💝 親しみやすく温かい表現\n\n### 🔀 PR Management Agent（プルリクエスト管理エージェント）\n- **役割**: 最適なマージ戦略を自動判定\n- **機能**:\n  - 📊 変更規模に応じたマージ戦略選択\n  - 👥 適切なレビュアーの自動選択\n  - 🏷️ 関連ラベルの自動付与\n  - ⚡ 安全な変更の自動マージ判定\n\n## 📊 実行結果の例\n\n### ✅ 正常実行時\n```\n🔄 Git操作を開始します...\n\n📝 サブエージェント git-safety-analyzer を実行しています...\n📝 サブエージェント commit-message-generator を実行しています...\n📝 サブエージェント pr-management-agent を実行しています...\n\n✅ Git操作が完了しました\n\n📝 コミット: 機能追加: ユーザーログイン画面を作成\n🔒 安全性: SAFE (スコア: 92)\n🆔 ハッシュ: a1b2c3d4\n🔀 PR: #123\n\n⏱️ 処理時間: 2341ms\n```\n\n### ⚠️ 警告がある場合\n```\n⚠️ 安全性チェックで問題を検出しました\n\n🔒 セキュリティ上の問題:\n  • ファイルにAPIキーが含まれています\n  • 対策: 環境変数に移動して.gitignoreに追加してください\n\n📝 コミット作成を一時停止しました\n💡 問題を修正してから再度実行してください\n```\n\n## 🔧 高度な設定\n\n### 設定ファイル（git-auto-mcp.config.js）\n```javascript\nmodule.exports = {\n  enabled: true,                    // システムの有効/無効\n  triggers: ['save', 'auto'],       // 実行トリガー\n  paths: [                          // 監視対象パス\n    'src/**/*',\n    '!node_modules/**'\n  ],\n  subAgents: {\n    gitSafetyAnalyzer: {\n      enabled: true,\n      safetyThreshold: 0.85         // 安全性閾値（0-1）\n    },\n    commitMessageGenerator: {\n      enabled: true,\n      language: 'ja',               // 言語設定\n      style: 'friendly'             // メッセージスタイル\n    },\n    prManagementAgent: {\n      enabled: true,\n      autoMergeThreshold: 0.85      // 自動マージ閾値\n    }\n  }\n};\n```\n\n### 除外設定例\n```javascript\n// 特定のファイルやフォルダを監視対象から除外\npaths: [\n  'src/**/*',\n  'docs/**/*',\n  '!node_modules/**',     // node_modulesを除外\n  '!dist/**',             // ビルド結果を除外\n  '!*.log',               // ログファイルを除外\n  '!.env'                 // 環境変数ファイルを除外\n]\n```\n\n## 🛡️ セキュリティ機能\n\n### 自動検出される危険なパターン\n- **機密情報**: APIキー、パスワード、トークン\n- **AWS認証情報**: アクセスキー、シークレットキー\n- **データベース接続文字列**: MongoDB、PostgreSQL、MySQL\n- **秘密鍵**: SSH鍵、SSL証明書\n- **破壊的操作**: 大量ファイル削除、DROP TABLE文\n\n### 安全性レベル\n- **🟢 SAFE (85-100点)**: 自動実行可能\n- **🟡 WARNING (60-84点)**: 注意確認後に実行\n- **🔴 DANGER (0-59点)**: 実行停止、手動確認必須\n\n## ⚡ パフォーマンス最適化\n\n### 適応的タイムアウト機能\n- **学習機能**: 実行履歴から最適なタイムアウト時間を自動計算\n- **優先度管理**: critical/high/medium/low レベルでリソース割り当て\n- **リトライ最適化**: 段階的タイムアウト延長 (1.0x → 1.5x → 2.0x)\n\n### Claude Code統合最適化\n- **環境検出**: Claude Code実行時の自動最適化\n- **メモリ管理**: 大量ファイル処理時のガベージコレクション\n- **バッチ処理**: 50ファイル以上の効率的な並列処理\n\n### パフォーマンス統計\n- **実行時間追跡**: 各操作の平均実行時間を記録\n- **システム健全性**: optimal/good/warning/critical レベルでの監視\n- **定期メンテナンス**: 古いログとパフォーマンス履歴の自動クリーンアップ\n\n## 🤝 チーム開発での活用\n\n### メリット\n- **一貫性**: 全員が同じ品質のコミットメッセージ\n- **安全性**: 機密情報の漏洩を自動防止\n- **効率性**: コードレビューの負荷軽減\n- **学習効果**: 良いGit運用を自然に身につけられる\n\n### チーム設定例\n```javascript\n// プロジェクト全体で共通の設定\nmodule.exports = {\n  subAgents: {\n    commitMessageGenerator: {\n      language: 'ja',\n      style: 'professional'    // チーム用にフォーマル設定\n    },\n    prManagementAgent: {\n      autoMergeThreshold: 0.95  // チーム用に厳格設定\n    }\n  }\n};\n```\n\n## 🚨 トラブルシューティング\n\n### よくある問題と解決方法\n\n#### ❓ コマンドが見つからない\n```bash\n# 解決方法：グローバルインストールを確認\nnpm install -g github-mcp-auto-git\nnpm list -g github-mcp-auto-git\n```\n\n#### ❓ サブエージェントの読み込みエラー\n```bash\n# 解決方法：設定確認\ngithub-auto-git status\n\n# エージェントファイルの確認\nls src/agents/\n```\n\n#### ❓ GitHub連携ができない\n```bash\n# 解決方法1：詳細なトークン設定ガイド表示\ngithub-auto-git token\n\n# 解決方法2：トークン設定確認\necho $GITHUB_TOKEN\n# または .envファイルの内容確認\n\n# 解決方法3：権限確認\n# GitHub → Settings → Developer settings → Personal access tokens\n# 必要な権限：repo, workflow, write:packages（オプション）\n```\n\n#### ❓ 監視が動作しない\n```bash\n# 解決方法：権限とパス確認\ngithub-auto-git status\n# 監視パターンの確認\n```\n\n#### ✅ v1.0.4で解決済みの問題\n- **PIDファイル無限ループ**: システムが自分のPIDファイルを監視してしまう問題 → **完全解決**\n- **セキュリティ検証の誤検知**: 正常なGit設定が脅威として判定される問題 → **完全解決** \n- **システム応答性の問題**: 処理が重くなる問題 → **大幅改善**\n\n\u003e 💡 **v1.0.4をお使いの場合**: 上記の問題は既に修正済みです。最新版の使用を強く推奨します。\n\n## 📚 学習リソース\n\n### Git初心者向け\n- [Gitとは？](https://git-scm.com/book/ja/v2)\n- [GitHub入門](https://docs.github.com/ja)\n- [良いコミットメッセージの書き方](https://chris.beams.io/posts/git-commit/)\n\n### このツールの技術詳細\n- [Claude Code サブエージェント機能](https://docs.anthropic.com/en/docs/claude-code/sub-agents)\n- [TypeScript](https://www.typescriptlang.org/)\n- [Node.js](https://nodejs.org/)\n\n## 🙋‍♀️ よくある質問\n\n### Q: OpenAI APIキーは必要ですか？\nA: **不要です！** Claude Codeの組み込みサブエージェント機能を使用するため、外部APIキーは必要ありません。\n\n### Q: どのくらい安全ですか？\nA: 非常に安全です。機密情報を自動検出し、危険な操作は事前に停止します。また、全ての処理はローカルで実行されます。\n\n### Q: チームで使えますか？\nA: はい！設定ファイルをGitで共有することで、チーム全体で一貫した運用が可能です。\n\n### Q: Windowsで動作しますか？\nA: はい。Node.jsが動作する環境であれば、Windows、Mac、Linuxで利用できます。\n\n### Q: 既存のGitリポジトリで使えますか？\nA: はい。既存のプロジェクトにも簡単に導入できます。\n\n### Q: 料金はかかりますか？\nA: このツール自体は無料です。Claude Codeのライセンスについては[Anthropic公式サイト](https://claude.ai/)をご確認ください。\n\n## 🤝 コントリビューション\n\nこのプロジェクトへの貢献を歓迎します！\n\n### 貢献方法\n1. このリポジトリをフォーク\n2. 機能ブランチを作成 (`git checkout -b feature/AmazingFeature`)\n3. 変更をコミット (`git commit -m 'Add some AmazingFeature'`)\n4. ブランチにプッシュ (`git push origin feature/AmazingFeature`)\n5. プルリクエストを作成\n\n### 開発環境セットアップ\n```bash\n# リポジトリをクローン\ngit clone https://github.com/Shinya-Reiji/github-mcp-auto-git.git\ncd github-mcp-auto-git\n\n# 依存関係をインストール\nnpm install\n\n# 開発モードで実行\nnpm run dev\n\n# ビルド\nnpm run build\n\n# テスト\nnpm test\n```\n\n## 📄 ライセンス\n\nMIT License - 詳細は [LICENSE](LICENSE) ファイルをご確認ください。\n\n## 🌟 サポート\n\n### バグ報告・機能要望\n[GitHub Issues](https://github.com/Shinya-Reiji/github-mcp-auto-git/issues) でお気軽にご報告ください。\n\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**🎉 開発体験を革新する、AI駆動のGit自動化ツール 🎉**\n\n[📖 ドキュメント](https://github.com/Shinya-Reiji/github-mcp-auto-git#readme) • \n[🐛 バグ報告](https://github.com/Shinya-Reiji/github-mcp-auto-git/issues) • \n[💡 機能要望](https://github.com/Shinya-Reiji/github-mcp-auto-git/issues)\n\n**⭐ このツールが役に立ったら、ぜひスターをお願いします！ ⭐**\n\n---\n\n## 🆕 最新アップデート情報\n\n### v1.0.4 の重要な修正（2024年最新）\n- 🔥 **重大なバグ修正**: PIDファイル無限ループ問題を完全解決\n- 🛡️ **セキュリティ検証最適化**: 誤検知を大幅削減、正常なGit操作をスムーズに\n- ⚡ **パフォーマンス向上**: システム応答性が大幅に改善\n- 🎯 **プロダクション対応**: 実用環境での安定性を大幅強化\n\n### v1.0.3 の新機能\n- 🎯 **インタラクティブ監視設定**: `watch`起動時に監視範囲を選択可能\n- 📁 **プロジェクト全体監視**: README.mdなどルートファイルも自動監視\n- ⚙️ **カスタムパターン設定**: 柔軟な監視対象カスタマイズ\n- 🚀 **エンタープライズ級品質**: 包括的テスト・セキュリティ・エラーハンドリング\n\n**✨ 現在は完全に安定動作！プロダクション環境での使用に最適化されました。**\n\n### 🔧 v1.0.4 技術的改善詳細\n\n#### 修正された問題\n1. **PIDファイル無限ループ**\n   - **問題**: システムが自身の `.github-auto-git.pid` ファイルを監視してしまい、無限処理ループが発生\n   - **解決**: chokidarの`ignored`パターンに `**/*.pid` と `.github-auto-git.pid` を追加\n\n2. **セキュリティ検証の過敏反応**\n   - **問題**: 正常なGit設定オブジェクト（`autoCommit`, `autoPush`等）が脅威として誤検知\n   - **解決**: \n     - 検証レベルを `INTERNAL` → `PUBLIC` に変更\n     - Git設定オブジェクト専用のホワイトリスト機能追加\n     - パターンマッチングロジックを最適化\n\n3. **応答性の向上**\n   - **問題**: 重複するセキュリティチェックによる処理遅延\n   - **解決**: Git設定オブジェクトには機密情報チェックのみ適用\n\nこれらの修正により、システムは**0個の脅威検出**で正常動作し、実用性が大幅に向上しました。\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshinya-reiji%2Fgithub-mcp-auto-git","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshinya-reiji%2Fgithub-mcp-auto-git","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshinya-reiji%2Fgithub-mcp-auto-git/lists"}