Bulut ajanları (cloud agents) vs Yerel terminal ajanları (local agents) 比較

// クラウドエージェント — GitHub Copilot cloud agentの環境セットアップ
// リポジトリに追加するこのワークフローファイルは、エフェメラル(GitHub Actions基盤)な
// クラウド環境がどの依存関係で起動するかを定義する。
// ファイルパス: .github/workflows/copilot-setup-steps.yml
name: "Copilot Setup Steps"

on:
  workflow_dispatch:
  push:
    paths:
      - .github/workflows/copilot-setup-steps.yml
  pull_request:
    paths:
      - .github/workflows/copilot-setup-steps.yml

jobs:
  # ジョブ名は "copilot-setup-steps" でなければならない ――
  # cloud agentが環境を起動する際にこのジョブを自動的に実行する。
  copilot-setup-steps:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - name: Checkout repository
        uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v7
        with:
          node-version: "22"
          cache: "npm"

      - name: Install dependencies
        run: npm ci

      - name: Warm build cache
        run: npm run build --if-present

# ローカルターミナルエージェント — Aiderで単一マシン上で作業
# インストールはワンコマンド、環境は自分のマシン。社内ネットワーク/
# localhostへ直接アクセスでき、シークレット/コードは外に出ない。

# 1) インストール
python -m pip install aider-install
aider-install

# 2) プロジェクトルートに永続設定(.aider.conf.yml)
cat > .aider.conf.yml <<'CONF'
model: sonnet          # aiderの組み込みエイリアス(docs/config/model-aliases)
auto-commits: true
dark-mode: true
test-cmd: npm test
lint-cmd: npm run lint
CONF

# 3) 特定のファイルに対してターミナルで実行
# (同期的、単一セッション――すべてのdiffが即座に画面に表示される)
aider src/api/auth.ts src/api/session.ts \
  --message "リフレッシュトークンのローテーションにレート制限を追加し、テストを更新する"

# 4) 社内ネットワークのlocalhostサービスへ直接アクセス
# (追加のトンネル/許可リストは不要――エージェントは自分のシェルで動く)
pg_isready -h localhost -p 5432 && aider --message "DBヘルスチェックをCIに追加する"