Бот для ревью кода на Claude: пишем сами на TypeScript

PR открыт/обновлён в GitHub
   ↓
Срабатывает GitHub Action
   ↓
Тянем дифф через GitHub API
   ↓
Шлём в Claude Sonnet 4.6 (через codexkey)
   ↓
Парсим JSON-ответ
   ↓
Постим комменты ревью через GitHub API

Ты — senior staff engineer, ревьюишь pull request. Твоя задача — ловить
баги, проблемы безопасности и ошибки дизайна, а НЕ следить за стилем
(для этого есть линтеры) и НЕ хвалить хороший код.

SCOPE:
- Комментируй только строки, изменённые в этом диффе.
- Не комментируй неизменённые контекстные строки.
- Не требуй изменений, которые не можешь обосновать конкретным сценарием
  отказа.

СЕРЬЁЗНОСТЬ:
- blocker: приведёт к продакшн-инциденту, потере данных, бреши в
  безопасности или очевидному багу корректности. Чинить до мерджа.
- warning: реальная проблема, но не блокер. Гонки под маловероятной
  нагрузкой, отсутствующие error-пути, плохое именование, которое
  выстрелит позже.
- nit: мелкая придирка. Используй экономно — максимум 2 на PR.

ВЫВОД:
Вызови инструмент `post_review` со списком комментариев в JSON. Каждый
комментарий должен содержать:
- file: путь относительно корня репо
- line: номер строки в новом файле (после изменения)
- severity: "blocker" | "warning" | "nit"
- comment: 1–3 предложения. Сначала проблема, затем как чинить.
- justification: почему это важно. Если не можешь это сформулировать —
  выкини коммент.

Если PR выглядит нормально — верни пустой список. Не выдумывай проблемы.

КОНТЕКСТ РЕПО:
{кэшированный системный блок: стайл-гайд, заметки по архитектуре,
недавние решения}

ДИФФ:
{собственно дифф}

const postReviewTool = {
  name: "post_review",
  description: "Опубликовать комменты ревью на PR. Передай пустой массив, если проблем нет.",
  input_schema: {
    type: "object",
    properties: {
      comments: {
        type: "array",
        items: {
          type: "object",
          properties: {
            file: { type: "string" },
            line: { type: "integer" },
            severity: {
              type: "string",
              enum: ["blocker", "warning", "nit"]
            },
            comment: { type: "string" },
            justification: { type: "string" }
          },
          required: ["file", "line", "severity", "comment", "justification"]
        }
      }
    },
    required: ["comments"]
  }
};

import Anthropic from "@anthropic-ai/sdk";
import { Octokit } from "@octokit/rest";

const claude = new Anthropic({
  apiKey: process.env.CODEXKEY_API_KEY,
  baseURL: "https://api.codexkey.ru/v1",
});

const gh = new Octokit({ auth: process.env.GITHUB_TOKEN });

async function reviewPR(owner: string, repo: string, pull_number: number) {
  // 1. Тянем дифф
  const { data: files } = await gh.pulls.listFiles({
    owner, repo, pull_number, per_page: 100,
  });

  // 2. Бьём по файлам — параллелим для больших PR
  const reviews = await Promise.all(
    files
      .filter(f => f.patch && f.status !== "removed")
      .map(file => reviewFile(file))
  );

  // 3. Сплющиваем + дедуп по (file, line, severity)
  const all = reviews.flat();
  const seen = new Set<string>();
  const unique = all.filter(c => {
    const k = `${c.file}:${c.line}:${c.severity}`;
    if (seen.has(k)) return false;
    seen.add(k);
    return true;
  });

  // 4. Постим одним ревью
  await gh.pulls.createReview({
    owner, repo, pull_number,
    event: unique.some(c => c.severity === "blocker")
      ? "REQUEST_CHANGES"
      : "COMMENT",
    comments: unique.map(c => ({
      path: c.file,
      line: c.line,
      body: `**[${c.severity}]** ${c.comment}\n\n_${c.justification}_`,
    })),
  });
}

async function reviewFile(file: any) {
  const response = await claude.messages.create({
    model: "claude-sonnet-5",
    max_tokens: 4096,
    system: [
      {
        type: "text",
        text: REPO_CONTEXT,           // стайл-гайд, архитектура
        cache_control: { type: "ephemeral" },
      },
      {
        type: "text",
        text: REVIEW_INSTRUCTIONS,    // промпт выше
      },
    ],
    tools: [postReviewTool],
    tool_choice: { type: "tool", name: "post_review" },
    messages: [
      {
        role: "user",
        content: `Файл: ${file.filename}\n\nДифф:\n\`\`\`diff\n${file.patch}\n\`\`\``,
      },
    ],
  });

  const toolUse = response.content.find(b => b.type === "tool_use");
  return toolUse ? (toolUse.input as any).comments : [];
}

name: Claude Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
      contents: read
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "20"
      - run: npm ci
      - run: npx tsx scripts/review.ts
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          CODEXKEY_API_KEY: ${{ secrets.CODEXKEY_API_KEY }}
          PR_NUMBER: ${{ github.event.pull_request.number }}
          REPO_OWNER: ${{ github.repository_owner }}
          REPO_NAME: ${{ github.event.repository.name }}