Jules を使用した GitHub Issues の自動化

複数の GitHub Issues を自動的に分析し、実装タスクを計画して、並列の Jules コーディングエージェントを実行するようにリポジトリを設定します。

セットアップの概要

GitHub Actions (またはローカル) を通じて実行される 5 段階の自動パイプライン:

1. 分析 — オープンな Issues を取得して、構造化 Markdown として整形
2. 計画 — Jules セッションがコードレベルの詳細なトリアージを実行し、自己完結したタスクプロンプトを生成
3. 検証 — 複数のタスクが同じファイルを修正しないことを確認 (マージコンフリクトを防止)
4. 実行 — タスクごとに並列の Jules セッションをスポーン
5. マージ — CI 検証を伴う順序付き PR マージ

セットアップ手順

ステップ 1: fleet スクリプトをリポジトリにコピー

このスキルの scripts/ ディレクトリ全体をターゲットリポジトリの scripts/fleet/ にコピーします:

ターゲット構造:
scripts/fleet/
├── fleet-analyze.ts
├── fleet-plan.ts
├── fleet-dispatch.ts
├── fleet-merge.ts
├── types.ts
├── prompts/
│   ├── analyze-issues.ts
│   └── bootstrap.ts
└── github/
    ├── git.ts
    ├── issues.ts
    ├── markdown.ts
    └── cache-plugin.ts

重要: ディレクトリ構造は正確に保持してください。スクリプトはファイル間で相対インポートを使用します。

ステップ 2: ワークフローテンプレートをコピー

assets/ からワークフローファイルをリポジトリの .github/workflows/ ディレクトリにコピーします:

• assets/fleet-dispatch.yml → .github/workflows/fleet-dispatch.yml
• assets/fleet-merge.yml → .github/workflows/fleet-merge.yml

ステップ 3: fleet スクリプト用の package.json を作成

必要な依存関係を含む scripts/fleet/package.json を作成します:

{
  "name": "fleet-scripts",
  "private": true,
  "type": "module",
  "dependencies": {
    "@google/jules-sdk": "^0.1.0",
    "octokit": "^4.1.0",
    "find-up": "^7.0.0"
  },
  "devDependencies": {
    "@types/bun": "^1.2.0"
  }
}

ステップ 4: 環境テンプレートを作成

assets/.env.example をリポジトリのルートにコピーします。

ステップ 5: 依存関係をインストール

cd scripts/fleet && bun install

ステップ 6: ユーザー向けの次のステップを表示

ユーザーに以下を実行する必要があることを伝えます:

1. JULES_API_KEY を GitHub リポジトリシークレットとして追加 (設定 → シークレット → アクション)
2. GITHUB_TOKEN は GitHub Actions によって自動的に提供されます
3. .github/workflows/fleet-dispatch.yml の cron スケジュールをカスタマイズ (デフォルト: 毎日午前 6 時 UTC)
4. 生成されたすべてのファイルをコミット

手動での使用方法

セットアップ後、ユーザーはパイプラインをローカルで実行できます:

cd scripts/fleet

# オープンな Issues を取得
bun fleet-analyze.ts

# タスクを計画 (Jules 計画セッションを作成)
JULES_API_KEY=<key> bun fleet-plan.ts

# 並列エージェントを実行
JULES_API_KEY=<key> bun fleet-dispatch.ts

# PR を順序付きでマージ
GITHUB_TOKEN=<token> bun fleet-merge.ts

カスタマイズ

プロンプトの調整

scripts/fleet/prompts/analyze-issues.ts の分析プロンプトは、Issues がどのレベルの深さで調査されるかを制御します。ユーザーは以下を調整できます:

• 根本原因分析の深度
• ソリューション実装の詳細レベル
• マージコンフリクト回避ルール
• ファイル所有権の制約

Issue フィルタリング

scripts/fleet/github/issues.ts を編集して、ラベル、マイルストーン、または状態で Issues をフィルタリングします。

リソースリファレンス

• Architecture Overview — 5 段階のパイプラインの詳細な説明

トラブルシューティング

• "Unable to parse git remote URL": リポジトリに有効な GitHub リモート (git remote get-url origin) があることを確認してください
• 所有権競合エラー: 2 つのタスクが同じファイルを要求しています。タスク JSON を調整するか、手動でマージしてください
• マージ中の CI タイムアウト: fleet-merge.ts の maxWaitMs を増やしてください (デフォルト: 10 分)
• Bun が見つからない: Bun をインストール: curl -fsSL https://bun.sh/install | bash