Başvuru
Tarif: GitHub
Holarch Model denetimlerini GitHub Actions'tan çalıştırın ve bulguları bir GitHub sorunu olarak izleyin; Claude Code'un bir dalın uyguladığı gereksinimler için test senaryoları önermesine izin verin; kurulum, iş akışı dosyası, çalışılmış bir örnek ve sorun giderme.
Bu sayfada
Genel bakış
Bu tarif bir GitHub deposunu bir Holarch projesine bağlar. İki bölümü vardır:
- GitHub Actions'ta model denetimleri (REST API): zamanlanmış bir iş akışı Holarch'ın model denetimlerini projenin gereksinimleri üzerinde çalıştırır. Bulguları çalıştırmanın özetine yazar ve tek bir GitHub sorununu onlarla güncel tutar.
- Kod incelemesinde gereksinimler (MCP, Claude Code aracılığıyla): Claude Code üzerinde çalıştığınız dalı okur, Holarch'ta onun uyguladığı gereksinimleri bulur ve onları doğrulayan test senaryoları önerir. Herhangi bir şey değişmeden önce öneriyi Holarch'ta incelersiniz.
Holarch'ın yerleşik bir GitHub uygulaması yoktur. Tarif REST API ve MCP kullanır, böylece her adımı uyarlayabilirsiniz.
Ön koşullar
- API ve MCP içeren bir plan: Individual veya Team ya da Individual denemesi. Free planında doğrulanmış bir akademik e-posta adresine sahip veya etkin bir sınıf kuruluşundaki bir hesapta da bulunur (Planlar ve sınırlar).
- Bir Holarch projesi. İş akışı onu yalnızca okur; Claude Code'dan gelen öneriler düzenleyici veya sahip rolü gerektirir.
- Actions gizli bilgileri ve değişkenleri ekleyebildiğiniz ve Actions'ın sorun oluşturabildiği bir GitHub deposu.
- Claude bölümü için: Okuma ve değişiklik önerme erişimiyle Holarch'a bağlı Claude Code (Holarch'ı Claude'a bağlama).
Nasıl kullanılır
Ne zaman ve neden
Model denetimleri modeldeki boşlukları bulur, örneğin doğrulayan test senaryosu olmayan gereksinimler. Bunları bir zamanlamayla çalıştırmak ve bulguları ekibin zaten çalıştığı yerde izlemek, boşlukları incelemeler arasında görünür tutar. Claude Code döngüyü diğer taraftan kapatır: kod bir gereksinimi uyguladığında onu doğrulayan test senaryosunun taslağını hazırlar.
Depoyu kurma
- Holarch'ta projeyle sınırlı bir Salt okunur belirteç oluşturun: Hesap ayarları → API belirteçleri → Yeni belirteç (Belirteç oluşturma).
- Proje kimliğini bulun:
GET /api/v1/projectsprojeleriniziiddeğerleriyle listeler.
curl -H "Authorization: Bearer hol_…" https://app.holarch.app/api/v1/projects
- GitHub'da deponun Settings → Secrets and variables → Actions sayfasını açın:
- Secrets altında belirteçle birlikte
HOLARCH_TOKENekleyin. - Variables altında proje kimliğiyle birlikte
HOLARCH_PROJECTekleyin.
- Secrets altında belirteçle birlikte
- Issues → Labels altında
holarchetiketini oluşturun. İş akışı sorununu bulmak için onu kullanır.
Model denetimlerini bir zamanlamayla çalıştırma
Bu dosyayı .github/workflows/holarch-checks.yml olarak kaydedin ve işleyin (commit).
# Holarch Model Checks: requirement findings in the run summary and in one GitHub issue.
name: Holarch model checks
on:
schedule:
- cron: "0 6 * * 1-5" # weekdays at 06:00 UTC
workflow_dispatch:
permissions:
issues: write
jobs:
checks:
runs-on: ubuntu-latest
env:
HOLARCH_TOKEN: ${{ secrets.HOLARCH_TOKEN }}
HOLARCH_PROJECT: ${{ vars.HOLARCH_PROJECT }}
GH_TOKEN: ${{ github.token }}
GH_REPO: ${{ github.repository }}
steps:
- name: Run Model Checks
run: |
curl -sS --fail-with-body -H "Authorization: Bearer $HOLARCH_TOKEN" \
"https://app.holarch.app/api/v1/projects/$HOLARCH_PROJECT/model-checks?class=Requirement" > checks.json
jq -r '"Holarch Model Checks: \(.total) requirement findings\n",
(.issues[] | "- [ ] \(.rule) \(.entity.number) \(.entity.name): \(.heading)")' checks.json > findings.md
cat findings.md >> "$GITHUB_STEP_SUMMARY"
- name: Update the tracking issue
run: |
total=$(jq .total checks.json)
issue=$(gh issue list --label holarch --state open --json number --jq '.[0].number')
if [ "$total" -gt 0 ] && [ -z "$issue" ]; then
gh issue create --title "Holarch Model Checks findings" --label holarch --body-file findings.md
elif [ "$total" -gt 0 ]; then
gh issue edit "$issue" --body-file findings.md
elif [ -n "$issue" ]; then
gh issue close "$issue" --comment "Holarch Model Checks find no requirement issues."
fi
Şimdi çalıştırmak için Actions → Holarch model checks → Run workflow açın.
Bulguları çalıştırmanın özetinde, her bulgu için bir satır olarak görürsünüz, örneğin Requirement.10 <number> <name>: Leaf requirements with no verifying test case. Holarch Model Checks findings sorunu aynı listeyi tutar. Bulgular düzeltildiğinde sonraki çalıştırma onu kapatır.
Nasıl çalışır:
GET /api/v1/projects/<project>/model-checks?class=Requirement, denetimleri projenin kendi kural ayarlarıyla çalıştırır ve bulguları döndürür:rule,heading,entity(id,number,name) ve ilişkili öğeler. Sonuçlar döndürülür, saklanmaz.curl --fail-with-bodybir hatada adımı başarısız kılar ve Holarch'ın iletisini yazdırır, örneğin{"error": "…", "code": "token-invalid"}.ghvejq, GitHub'ın Ubuntu çalıştırıcılarıyla gelir.
Varyasyonlar:
- Diğer kurallar:
class=Requirementdeğerini başka bir sınıfa değiştirin (Test Case,Asset, kural kümeleriniz içinCustom) veyarule=Requirement.10ile tek bir kuralı adlandırın. - Gereksinim kalitesi:
GET /api/v1/projects/<project>/qualityher gereksinimi dokuz kalite özniteliğine göre puanlar.scoredeğeri eşiğinizin altında olan gereksinimleri aynı şekilde listeleyin. - Bulgularda çalıştırmayı başarısız kılma: örneğin bir sürüm dalının denetimlerinde son satır olarak
test "$total" -eq 0ekleyin.
Claude Code ile bir dal için test senaryoları önerme
Bir değişikliğin uyguladığı gereksinimlerin doğrulayan bir test senaryosu alması için bunu bir çekme isteği açmadan önce kullanın.
- Claude Code'u Holarch'a bir kez bağlayın:
claude mcp add --transport http holarch https://app.holarch.app/mcp
Ardından /mcp yazın, holarch → Kimlik doğrula seçin, Holarch'ta oturum açın ve Okuma ve değişiklik önerme ile İzin ver seçeneğine tıklayın.
- Depoda, dalınızdayken Claude Code'a örneğin şunu sorun: “Bu dalı main ile karşılaştır. Holarch CubeSat projesinde değişikliğin uyguladığı gereksinimleri bul ve doğrulayan test senaryosu olmayan her biri için bir test senaryosu öner. Öneri özetinde dalın adını belirt.”
- Claude Code farkı git ile okur. Holarch'ta gereksinimleri bulmak için
search_entitiesveget_entity, hangilerinin doğrulayan test senaryosu olmadığını görmek içinRequirement.10kuralıylarun_model_checkskullanır. Her test senaryosunucreate_entityve verifies ilişkisiyle ekler, ardından öneriyipropose_changesile gönderir.Claude Code önerinin başlığı ve onu incelemek için bir bağlantıyla yanıt verir.
- Holarch'ta ✦ YZ ▾ → “<title>” incele… veya zil simgesinin altındaki bildirimi açın.
- Gerekirse adları ve açıklamaları düzenleyin, ardından Seçilenleri uygula seçeneğine tıklayın.
Test senaryoları geçmişte sizin adınızla oluşturulur ve tek bir Geri al ile hepsi geri alınır. Sonraki zamanlanmış iş akışı çalıştırması bu gereksinimleri artık listelemez.
Gereksinimin bağlantısını çekme isteği açıklamasına yapıştırın: get_entity ve REST API onu url olarak döndürür. Projenin üyesi olan herkes için gereksinimi açar.
Uygulamalı örnek: CubeSat EO-1 demosu
- Demoyu Projeleri yönet → Proje dosyaları ▾ → Yeni demo proje ile oluşturun ve kimliğini
HOLARCH_PROJECTolarak kullanın. - İş akışını Run workflow ile çalıştırın.
Özet, model denetimlerinin işaretlediği gereksinimleri listeler, örneğin doğrulayan test senaryosu olmayan yaprak gereksinimler. Holarch Model Checks findings sorunu aynısını listeler.
- Tutum kontrol kodunu değiştiren bir dalda, Claude Code'dan dalın uyguladığı gereksinimler için test senaryoları önermesini isteyin.
Bu kodun gereksinimleri 2.1 Pointing Accuracy ve 2.2 Pointing Stability öğeleridir. Her ikisi de zaten TC-04 Pointing Accuracy Test tarafından doğrulanır, bu yüzden yeni test senaryosuna ihtiyaçları yoktur.
- Bunun yerine ondan sorunun listesindeki bir gereksinim için test senaryosu önermesini isteyin, ardından öneriyi Holarch'ta inceleyip uygulayın.
- İş akışını yeniden çalıştırın.
O gereksinim artık listelenmez.
İpuçları
- İş akışına projeyle sınırlı kendi salt okunur belirtecini verin. İş akışını kaldırdığınızda onu Hesap ayarları → API belirteçleri altında iptal edin.
- Zamanlanmış iş akışı Holarch'ın kural ayarlarını kullanır: model denetimlerinde bir kuralı kapatın veya düzeyini değiştirin, sonraki çalıştırma bunu izler.
- Bir belirtecin süresi seçtiğiniz tarihte dolar. Bir iş akışı için bir yıl veya hiçbir zaman seçin ve tarihi not edin.
Sorun giderme
| İleti veya belirti | Neden ve çözüm |
|---|---|
"code": "token-required" | HOLARCH_TOKEN gizli bilgisi boş veya eksik. Onu Settings → Secrets and variables → Actions altında ekleyin. |
"code": "token-invalid" | Belirteç yanlış, iptal edilmiş veya süresi dolmuş. Yeni bir tane oluşturun ve gizli bilgiyi güncelleyin. |
"code": "plan-api" | Hesabın planı API ve MCP'yi içermiyor. Individual denemesini başlatın veya bir plan seçin; belirteç ardından yeniden çalışır. |
"code": "org-policy" | Projenin kuruluşu API erişimini kapattı. Bir kuruluş yöneticisine sorun. |
"code": "not-found" | HOLARCH_PROJECT, belirtecin kullanabileceği bir proje değil. Kimliği ve belirtecin Projeler ayarını denetleyin. |
"code": "rate-limited" | Bu belirteçle dakikada 600'den fazla istek. İş akışını daha seyrek çalıştırın veya diğer betiklere kendi belirteçlerini verin. |
gh issue create başarısız oluyor: etiket bulunamadı | Depoda holarch etiketini oluşturun. |
gh HTTP 403 yanıtı veriyor | İş akışı permissions: issues: write gerektirir ve deponun Actions ayarları buna izin vermelidir. |
| Claude Code Holarch yazma araçlarını sunmuyor | Bağlantı salt okunur. /mcp çalıştırın, holarch bağlantısını Okuma ve değişiklik önerme ile yeniden kurun, ardından yeni bir konuşma başlatın. |