---
description: Autonomous Agent実行 - Issue自動処理パイプライン
---
# Autonomous Agent実行
GitHub IssueをAutonomous Agentシステムで自動処理します。
## 実行フロー
```
Issue作成/検出
↓
CoordinatorAgent（タスク分解・DAG構築）
↓ 並行実行
├─ IssueAgent（Issue分析・Label付与）
├─ CodeGenAgent（コード生成）
├─ ReviewAgent（品質チェック≥80点）
└─ PRAgent（PR作成）
↓
Draft PR作成
↓
人間レビュー待ち
```
## コマンド
### 単一Issue処理
```bash
npm run agents:parallel:exec -- --issue 123
```
### 複数Issue並行処理
```bash
npm run agents:parallel:exec -- --issues 123,124,125 --concurrency 3
```
### Dry run（確認のみ、変更なし）
```bash
npm run agents:parallel:exec -- --issue 123 --dry-run
```
### ヘルプ表示
```bash
npm run agents:parallel:exec -- --help
```
## オプション
| オプション | 説明 | デフォルト |
|-----------|------|-----------|
| `--issue <number>` | 単一Issue番号 | - |
| `--issues <n1,n2,...>` | 複数Issue番号（カンマ区切り） | - |
| `--concurrency <number>` | 並行実行数 | 2 |
| `--dry-run` | 実行のみ（変更なし） | false |
| `--log-level <level>` | ログレベル | info |
## 環境変数
必須環境変数（`.env`ファイル）:
```bash
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
REPOSITORY=owner/repo
DEVICE_IDENTIFIER=MacBook Pro 16-inch
```
## 成功条件
✅ **必須**:
- Issue分析完了
- コード生成成功
- 品質スコア ≥80点
- Draft PR作成
✅ **品質**:
- TypeScriptエラー 0件
- ESLintエラー 0件
- セキュリティスキャン合格
- テストカバレッジ ≥80%
## エスカレーション
以下の場合、自動エスカレーション:
| 条件 | エスカレーション先 | 重要度 |
|------|------------------|--------|
| アーキテクチャ問題 | TechLead | Sev.2-High |
| セキュリティ脆弱性 | CISO | Sev.1-Critical |
| ビジネス優先度 | PO | Sev.3-Medium |
| 循環依存検出 | TechLead | Sev.2-High |
## 実行例
### 例1: 単一Issue処理
```bash
$ npm run agents:parallel:exec -- --issue 270
🤖 Autonomous Operations - Parallel Executor
✅ Configuration loaded
Device: MacBook Pro 16-inch
Repository: ShunsukeHayashi/Autonomous-Operations
Concurrency: 2
✅ Fetched Issue #270: Add user authentication
================================================================================
🚀 Executing Issue #270: Add user authentication
================================================================================
[CoordinatorAgent] 🔍 Decomposing Issue #270
[CoordinatorAgent] Found 4 tasks
[CoordinatorAgent] 🔗 Building task dependency graph (DAG)
[CoordinatorAgent] Graph: 4 nodes, 0 edges, 1 levels
[CoordinatorAgent] ✅ No circular dependencies found
[CodeGenAgent] 🧠 Generating code with Claude AI
[CodeGenAgent] Generated 3 files
[ReviewAgent] 📊 Calculating quality score
[ReviewAgent] Score: 85/100 ✅
[PRAgent] 🚀 Creating Pull Request
[PRAgent] ✅ PR created: #271
✅ Issue #270 completed successfully
Duration: 45,234ms
```
### 例2: Dry run
```bash
$ npm run agents:parallel:exec -- --issue 270 --dry-run
🤖 Autonomous Operations - Parallel Executor
Dry Run: Yes (no changes will be made)
[実行のみ、ファイル書き込みなし]
```
## トラブルシューティング
### API Key エラー
```bash
❌ Error: ANTHROPIC_API_KEY is required for CodeGenAgent
解決策:
1. .envファイルを確認
2. ANTHROPIC_API_KEY=sk-ant-... を追加
```
### GitHub API エラー
```bash
❌ Failed to fetch issue #270: Not Found
解決策:
1. Issue番号が正しいか確認
2. GITHUB_TOKEN権限を確認（repo, workflow）
3. REPOSITORYが正しいか確認
```
### 品質スコア不合格
```bash
❌ Quality score: 75/100 (Failed)
エスカレーション:
→ TechLeadにエスカレーションされました
→ Issue #270にコメントが追加されます
```
## ログ確認
```bash
# 実行ログ
cat .ai/logs/$(date +%Y-%m-%d).md
# 実行レポート
cat .ai/parallel-reports/agents-parallel-*.json | jq
```
## GitHub Actions連携
GitHub Actionsから自動実行される場合:
```yaml
- name: Execute CoordinatorAgent
run: |
npm run agents:parallel:exec -- \
--issue ${{ needs.check-trigger.outputs.issue_number }} \
--concurrency 3 \
--log-level info
```
---
実行後、Draft PRが作成されるので、人間がレビューして承認してください。
