Antigravity エディタ AIコード品質保証：レビュー自動化・テスト生成・CI/CD 品質ゲート統合

# プロジェクト品質ポリシー
 
## コーディング規約
- 言語: TypeScript strict モード必須
- フォーマッター: Biome（設定は biome.json 参照）
- 命名規則: camelCase（変数・関数）、PascalCase（クラス・型）
- ファイル構成: Feature-based モジュール構造
 
## 必須の実装パターン
- エラーは Result 型でラップして返す（throw 禁止）
- 非同期処理には必ず Promise.allSettled を使用（複数並行時）
- 外部 API コールは必ずリトライロジックを含める（最大3回）
 
## 禁止パターン
- `any` 型の使用（`unknown` を使用すること）
- `console.log` を本番コードに残す（logger サービスを使用）
- 未使用のインポートや変数
 
## テスト要件
- カバレッジ目標: ユニットテスト 80% 以上
- テストファイル: `{filename}.test.ts` で同一ディレクトリに配置
- モックは `vi.mock()` を使用（Vitest）

{
  "quality": {
    "review": {
      "focus_areas": [
        "security",
        "performance",
        "error_handling",
        "type_safety"
      ],
      "severity_threshold": "warning",
      "auto_fix": ["formatting", "imports", "unused_vars"]
    },
    "generation": {
      "require_tests": true,
      "require_types": true,
      "require_error_handling": true,
      "comment_density": "moderate"
    },
    "metrics": {
      "complexity_threshold": 10,
      "function_length_max": 50,
      "file_length_max": 300
    }
  }
}

# .antigravity/commands/review-security.md
 
選択したコードのセキュリティレビューを実施します。
 
## チェック項目
- [ ] 入力値のバリデーション（XSS, SQLi, Path Traversal）
- [ ] 認証トークンの安全な取り扱い
- [ ] 機密情報のログ出力防止
- [ ] CORS ポリシーの適切な設定
- [ ] Rate Limiting の必要性
 
## 出力形式
問題点を重大度（Critical/High/Medium/Low）別に列挙し、
各問題に対して具体的な修正案を提示してください。

// 生成されたテストコードの例（Vitest + Testing Library）
import { describe, it, expect, vi, beforeEach } from 'vitest'
import { render, screen, fireEvent, waitFor } from '@testing-library/react'
import { PaymentForm } from './PaymentForm'
import * as stripeModule from '@/lib/stripe'
 
vi.mock('@/lib/stripe')
 
describe('PaymentForm', () => {
  beforeEach(() => {
    vi.clearAllMocks()
  })
 
  describe('正常系', () => {
    it('有効なクレジットカード情報を入力したとき、決済処理が完了すること', async () => {
      const mockCharge = vi.spyOn(stripeModule, 'createCharge')
        .mockResolvedValue({ id: 'ch_test_001', status: 'succeeded' })
 
      render(<PaymentForm amount={1000} />)
 
      fireEvent.change(screen.getByLabelText('カード番号'), {
        target: { value: '4242424242424242' }
      })
      fireEvent.click(screen.getByRole('button', { name: '決済する' }))
 
      await waitFor(() => {
        expect(screen.getByText('決済が完了しました')).toBeInTheDocument()
      })
      expect(mockCharge).toHaveBeenCalledWith({ amount: 1000 })
    })
 
    it('金額が0円のとき、決済ボタンが非活性になること', () => {
      render(<PaymentForm amount={0} />)
      expect(screen.getByRole('button', { name: '決済する' })).toBeDisabled()
    })
  })
 
  describe('異常系', () => {
    it('決済APIがエラーを返したとき、エラーメッセージが表示されること', async () => {
      vi.spyOn(stripeModule, 'createCharge')
        .mockRejectedValue(new Error('カードが拒否されました'))
 
      render(<PaymentForm amount={1000} />)
      fireEvent.click(screen.getByRole('button', { name: '決済する' }))
 
      await waitFor(() => {
        expect(screen.getByText('カードが拒否されました')).toBeInTheDocument()
      })
    })
  })
})

# .github/workflows/ai-quality-gate.yml
name: AI Quality Gate
 
on:
  pull_request:
    types: [opened, synchronize]
 
jobs:
  ai-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
 
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '22'
          cache: 'npm'
 
      - name: Install dependencies
        run: npm ci
 
      # 変更ファイルの差分を取得
      - name: Get changed files
        id: changed-files
        run: |
          echo "files=$(git diff --name-only origin/main...HEAD | grep -E '\.(ts|tsx|js|jsx)$' | tr '\n' ' ')" >> $GITHUB_OUTPUT
 
      # Biome による静的解析
      - name: Run Biome lint
        run: npx biome check --reporter=json . > biome-report.json || true
 
      # Vitest によるテスト実行
      - name: Run tests with coverage
        run: npm run test:coverage -- --reporter=json --outputFile=test-report.json
 
      # カバレッジ閾値チェック
      - name: Check coverage threshold
        run: |
          COVERAGE=$(node -e "
            const report = require('./coverage/coverage-summary.json');
            console.log(report.total.lines.pct);
          ")
          echo "Line coverage: ${COVERAGE}%"
          if (( $(echo "$COVERAGE < 80" | bc -l) )); then
            echo "❌ Coverage ${COVERAGE}% is below threshold (80%)"
            exit 1
          fi
          echo "✅ Coverage ${COVERAGE}% meets threshold"
 
      # PR へのレポート投稿
      - name: Post review summary to PR
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const biomeReport = JSON.parse(fs.readFileSync('biome-report.json', 'utf8'));
            const errorCount = biomeReport.diagnostics?.length || 0;
 
            const body = `## 🤖 AI Quality Gate レポート
 
            | 項目 | 結果 |
            |------|------|
            | Biome 警告数 | ${errorCount} 件 |
            | テストカバレッジ | ${process.env.COVERAGE}% |
            | 品質ゲート | ${errorCount === 0 ? '✅ 通過' : '❌ 要修正'} |
 
            ${errorCount > 0 ? '### 修正が必要な箇所\n詳細は Actions ログを確認してください。' : ''}
            `;
 
            github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body
            });

// package.json への追加
{
  "scripts": {
    "pre-commit": "biome check --apply . && npm run test:changed",
    "test:changed": "vitest run --changed HEAD"
  },
  "lint-staged": {
    "*.{ts,tsx}": [
      "biome check --apply",
      "vitest related --run"
    ]
  }
}

# Husky のセットアップ
npm install --save-dev husky lint-staged
npx husky init
echo "npx lint-staged" > .husky/pre-commit

// quality-metrics.ts — 品質指標の自動計測スクリプト
import { execSync } from 'child_process'
import { writeFileSync } from 'fs'
 
interface QualityMetrics {
  timestamp: string
  coverage: {
    lines: number
    branches: number
    functions: number
  }
  lintWarnings: number
  testCount: number
  avgComplexity: number
}
 
async function collectMetrics(): Promise<QualityMetrics> {
  // テストカバレッジ取得
  execSync('npm run test:coverage -- --reporter=json', { stdio: 'pipe' })
  const coverageSummary = require('./coverage/coverage-summary.json')
 
  // Biome 警告数取得
  const biomeOutput = execSync('npx biome check --reporter=json .', {
    stdio: 'pipe',
    encoding: 'utf8'
  })
  const biomeReport = JSON.parse(biomeOutput)
 
  const metrics: QualityMetrics = {
    timestamp: new Date().toISOString(),
    coverage: {
      lines: coverageSummary.total.lines.pct,
      branches: coverageSummary.total.branches.pct,
      functions: coverageSummary.total.functions.pct,
    },
    lintWarnings: biomeReport.diagnostics?.length || 0,
    testCount: 0, // Vitest の出力から取得
    avgComplexity: 0, // 複雑度分析ツールから取得
  }
 
  // 指標をファイルに保存（トレンド分析用）
  const history = require('./quality-history.json') || []
  history.push(metrics)
  writeFileSync('./quality-history.json', JSON.stringify(history, null, 2))
 
  return metrics
}
 
collectMetrics().then(metrics => {
  console.log('📊 品質指標レポート')
  console.log(`  カバレッジ: ${metrics.coverage.lines}%`)
  console.log(`  Lint 警告: ${metrics.lintWarnings} 件`)
})

# scripts/weekly-quality-report.sh
#!/bin/bash
 
echo "# 週次コード品質レポート $(date '+%Y年%m月%d日')"
echo ""
echo "## テストカバレッジ推移"
node -e "
const history = require('./quality-history.json');
const lastWeek = history.slice(-7);
lastWeek.forEach(m => {
  console.log('- ' + m.timestamp.split('T')[0] + ': ' + m.coverage.lines + '%');
});
"
 
echo ""
echo "## 改善が必要な領域"
# カバレッジが低いファイルを抽出
node -e "
const coverage = require('./coverage/coverage-summary.json');
Object.entries(coverage)
  .filter(([file, data]) => file !== 'total' && data.lines.pct < 70)
  .sort((a, b) => a[1].lines.pct - b[1].lines.pct)
  .slice(0, 10)
  .forEach(([file, data]) => console.log('- ' + file + ': ' + data.lines.pct + '%'));
"