CursorとCI/CD連携 - 開発フロー全体でのAI活用

1
2
3

# Cursorのコマンドパレットから「Shell Command: Install 'cursor' command in PATH」を実行
# または手動でシンボリックリンクを作成
sudo ln -sf /Applications/Cursor.app/Contents/Resources/app/bin/cursor /usr/local/bin/cursor

1
2
3

# インストーラーが自動的にPATHに追加
# 手動で追加する場合は環境変数を設定
$env:PATH += ";C:\Users\<username>\AppData\Local\Programs\cursor\resources\app\bin"

1
2

cursor --version
# Cursor 2.3.x のようなバージョン情報が表示されれば成功

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 基本的な使い方
cursor agent "この関数にドキュメントコメントを追加してください" --file src/utils/helpers.ts

# 複数ファイルを対象にする
cursor agent "これらのファイル間の不整合を修正してください" \
  --file src/api/users.ts \
  --file src/types/user.ts

# ディレクトリ全体を対象にする
cursor agent "テストカバレッジを向上させてください" --dir src/services/

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

#!/bin/bash
# pre-commit-check.sh

# 変更されたファイルを取得
CHANGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(ts|tsx|js|jsx)$')

if [ -n "$CHANGED_FILES" ]; then
    echo "変更されたファイルのコードレビューを実行中..."
    
    for file in $CHANGED_FILES; do
        cursor agent "このファイルの潜在的な問題点を指摘してください。セキュリティ、パフォーマンス、ベストプラクティスの観点から確認してください。" \
          --file "$file" \
          --output json > /tmp/review_$$.json
        
        # 重大な問題があれば警告
        if grep -q '"severity": "critical"' /tmp/review_$$.json; then
            echo "警告: $file に重大な問題が見つかりました"
            cat /tmp/review_$$.json
        fi
    done
fi

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

#!/bin/bash
# generate-tests.sh

TARGET_FILE=$1
TEST_FILE="${TARGET_FILE%.ts}.test.ts"

cursor agent "このファイルに対する包括的なユニットテストを生成してください。
カバレッジ目標: 80%以上
テストフレームワーク: Jest
含めるべきテストケース:
- 正常系
- エラーハンドリング
- エッジケース" \
  --file "$TARGET_FILE" \
  --output "$TEST_FILE"

echo "テストファイルを生成しました: $TEST_FILE"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

# .github/workflows/ai-review.yml
name: AI Code Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  ai-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      
      - name: Setup Cursor CLI
        run: |
          # Cursor CLIのセットアップ
          curl -fsSL https://download.cursor.sh/cli/install.sh | sh
          export PATH="$HOME/.cursor/bin:$PATH"
      
      - name: Get Changed Files
        id: changed-files
        run: |
          FILES=$(git diff --name-only origin/main...HEAD | grep -E '\.(ts|tsx|js|jsx)$' | tr '\n' ' ')
          echo "files=$FILES" >> $GITHUB_OUTPUT
      
      - name: Run AI Review
        if: steps.changed-files.outputs.files != ''
        env:
          CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
        run: |
          for file in ${{ steps.changed-files.outputs.files }}; do
            cursor agent "このコードの変更をレビューしてください" --file "$file"
          done

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

# リポジトリに追加する設定ファイル（オプション）
# .bugbot/config.yml

enabled: true
review_on:
  - pull_request
  - push_to_main

ignore_patterns:
  - "*.md"
  - "*.json"
  - "test/**/*"

severity_threshold: medium

custom_rules:
  - name: security-check
    description: "セキュリティ関連のコードを重点的にチェック"
    patterns:
      - "**/*auth*"
      - "**/*security*"
      - "**/*crypto*"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# Bugbot Rules

## 重点チェック項目

### セキュリティ

- ハードコードされた認証情報の検出
- SQLインジェクションの可能性
- XSS脆弱性の検出
- 安全でない暗号化方式の使用

### パフォーマンス

- N+1クエリの検出
- 不要な再レンダリング（React）
- メモリリークの可能性
- 非効率なアルゴリズム

### コード品質

- 重複コードの検出
- 複雑度が高い関数
- 未使用のインポート/変数
- 型の不整合

1
2
3
4
5
6
7
8

# バックグラウンドでAgentを実行
cursor agent --background "プロジェクト全体のESLintエラーを修正してください"

# 実行状況の確認
cursor agent --status

# 結果の取得
cursor agent --result <job-id>

1
2
3
4

使用シーン:
- 異なるアプローチでの実装比較
- 複数のリファクタリング案の同時生成
- 大規模な変更を分割して並列処理

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

プロンプト例:
「このプロジェクト全体で非推奨のAPIを使用している箇所を特定し、
新しいAPIに移行してください。
- lodashの_.getを optional chaining に置換
- moment.jsをdate-fnsに移行
- classコンポーネントをfunctional componentsに変換」

実行オプション:
- Background Agent: ON
- 並列Agent数: 4

1
2
3
4
5
6
7
8

プロンプト例:
「src/servicesディレクトリ内のすべてのファイルに対して、
カバレッジ80%以上を目標にユニットテストを生成してください。
既存のテストパターンを参考にしてください。」

実行オプション:
- Background Agent: ON
- 対象ディレクトリ: src/services/

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

// .cursor/hooks.json
{
  "hooks": [
    {
      "name": "pre-agent",
      "event": "agent:before",
      "command": "npm run lint",
      "description": "Agent実行前にリントを実行"
    },
    {
      "name": "post-save",
      "event": "file:save",
      "command": "npm run format -- ${file}",
      "description": "ファイル保存時に自動フォーマット"
    },
    {
      "name": "post-agent",
      "event": "agent:after",
      "command": "npm test",
      "description": "Agent実行後にテストを実行"
    }
  ]
}

1
2
3
4
5
6
7

{
  "name": "security-scan",
  "event": "agent:after",
  "command": "npm run security:check",
  "condition": "fileChanged('**/*auth*') || fileChanged('**/*security*')",
  "description": "認証・セキュリティ関連ファイル変更時にセキュリティスキャンを実行"
}

1
2
3
4
5
6
7

{
  "name": "update-docs",
  "event": "agent:after",
  "command": "npm run docs:generate",
  "condition": "fileChanged('src/api/**/*.ts')",
  "description": "API変更時にドキュメントを自動更新"
}

1
2
3
4
5
6

{
  "name": "slack-notify",
  "event": "review:complete",
  "command": "curl -X POST -H 'Content-type: application/json' --data '{\"text\":\"コードレビューが完了しました: ${review.summary}\"}' $SLACK_WEBHOOK_URL",
  "description": "レビュー完了時にSlackに通知"
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

# CI/CD環境での最適化設定例

cursor:
  # 並列実行の制限
  max_parallel_agents: 4
  
  # タイムアウト設定
  agent_timeout: 300  # 5分
  
  # キャッシュの活用
  cache:
    enabled: true
    ttl: 3600  # 1時間
  
  # 対象ファイルの制限
  file_patterns:
    include:
      - "src/**/*.ts"
      - "src/**/*.tsx"
    exclude:
      - "**/*.test.ts"
      - "**/node_modules/**"

1
2
3
4
5

# PATHの確認
echo $PATH | grep cursor

# シンボリックリンクの確認（macOS/Linux）
ls -la /usr/local/bin/cursor

1
2
3
4
5

# 実行状況の確認
cursor agent --status

# ログの確認
cursor agent --logs <job-id>