AI CodeOps

Next.js pull request'i: üç inceleme, testleriniz ve CI'dan yayın kontrolü

Son güncelleme

Parallel Review ile doğruluk, güvenlik ve test kapsamı açısından incelenen, kendi test paketinizle test edilen ve merge öncesinde CI'dan yeniden kontrol edilen bir Next.js değişikliği.

Bu şablonu kullan

Tarayıcıdan girdi kabul eden bir route handler, birden fazla kişinin gözünden geçmeyi hak eder. Bu şablon bir Next.js değişikliği üzerinde odaklı üç inceleme çalıştırır, kendi test paketinizi yazılan koda karşı çalıştırır ve CI'ınızın merge öncesinde aynı soruyu yeniden sormasını sağlar.

Hangi ajanlar çalışır

AdımAjan
Correctness reviewReviewer
Security reviewSecurity Auditor
Test coverage reviewTester
Merge findingsArchitect

Architect üç incelemeyi tek bir listede birleştirir. Ardından kod geçişi değişikliği yazar ve verify adımı (doğrulama), lockfile'ınızın işaret ettiği paket yöneticisiyle package.json test script'inizi çevrimdışı bir sandbox içinde çalıştırır. Vitest ve Jest çıktıları toplamlara ayrıştırılır.

İlgili kalite kapıları

  • Bulgular. Bir bulgu incelemesi, üç incelemeyi bağlam olarak alarak gerçek diff'i okur. Açık yüksek (high) veya kritik (critical) bulgular, triyajdan geçirilene kadar pull request'i engeller.
  • Bu sürümdeki testler. Başarısız testler engeller. Testleri çalıştıktan sonra değişikliği düzenlemek onu test edilmemiş olarak işaretler.
  • Onay. Çalışma alanında onay verebilecek başka biri olduğu sürece oturumu başlatan kişi onay oyunu veremez.

CI'dan yeniden kontrol edin

Konsol pull request'i codeops/run-<id> adlı bir branch üzerinde açar. GitHub Actions'ta, pull request'lerde çalışan iş akışına bir adım ekleyin ve secret olarak saklanan bir çalışma alanı API anahtarı kullanın:

- name: AI CodeOps release check
  if: startsWith(github.head_ref, 'codeops/run-')
  env:
    AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
    PR_URL: ${{ github.event.pull_request.html_url }}
  run: |
    curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
      -H "Authorization: Bearer $AICODEOPS_API_KEY" \
      -H "Content-Type: application/json" \
      -d "{\"pullRequestURL\":\"$PR_URL\",\"blockOnInFlight\":true}" \
      | jq -e '.allowed == true'

Uç nokta, değişikliğe izin verilse de verilmese de 200 yanıtı verir; bu yüzden adım allowed alanını okur. blockOnInFlight, pull request'in arkasındaki herhangi bir oturum hâlâ çalışırken reddeder. Konsolu açtığınız adresi kullanın. Tüm alanlar API sayfasındadır.

Sonraki adımlar

Bu kontrol geçip değişiklik merge edildiğinde, canlı ortama giden yolu kapı denetimli staging dağıtımı şablonu ele alır. Hiçbir pull request'in dokunmadığı kod için haftalık kod tabanı incelemesi zamanlayın.

Sık sorulan sorular

Üç inceleme aynı anda mı çalışır?

Hayır. Birbiri ardına çalışırlar ve her biri öncekilerin yazdıklarını okur. Parallel sözcüğü işin nasıl bölündüğünü anlatır.

CI adımı elle yazılmış pull request'leri reddeder mi?

Evet, arkasında oturum olmayan bir pull request No workflow runs found yanıtını alır. Bu yüzden adım yalnızca codeops/run- branch'lerinde çalışır.