Blog

Claude Kod Becerileri ile CI/CD Nasıl Kullanılır

Ashley Innocent

Ashley Innocent

22 January 2026

Claude Kod Becerileri ile CI/CD Nasıl Kullanılır

enterprise.banner.title

enterprise.banner.feature1

enterprise.banner.feature2

enterprise.banner.feature3

enterprise.banner.ctaB

Karmaşık otomasyon komut dosyalarıyla uğraşmadan CI/CD hattınıza zeka katmanın bir yolunu arıyorsanız, Claude Code Skills tam da ihtiyacınız olan şey olabilir. Bu özel, yapay zeka destekli iş akışları, ön-taahhüt güvenlik kontrollerinden dağıtım doğrulamasına kadar her şeyi otomatikleştirir. Bunları kırılgan kabuk komut dosyaları yerine doğal dil talimatlarıyla tanımlarsınız.

Claude Code Skills'i CI/CD için güçlü kılan nedir:

💡
API merkezli işlem hatları mı oluşturuyorsunuz? Uçtan uca API otomasyonu için Claude Code Skills'i Apidog ile birleştirin. Apidog, görsel API testi, OpenAPI belirtimlerinden otomatik test oluşturma ve yeteneklerinizle sorunsuz bir şekilde entegre olan CI/CD hazır CLI araçları sağlar. API iş akışlarınızı hızlandırmak için Apidog'u ücretsiz deneyin.
button

Bu kılavuzda, Claude Code Skills'in ne olduğunu, özel CI/CD iş akışlarının nasıl oluşturulacağını ve bugün uygulayabileceğiniz gerçek dünya örneklerini keşfedeceğiz.

Claude Code Skills'i Anlamak

Beceriler (Skills) Nelerdir?

Claude Code Skills, Claude Code'un yeteneklerini genişleten özel, yeniden kullanılabilir yapay zeka iş akışlarıdır. Onları şu yeteneklere sahip akıllı komut dosyaları olarak düşünebilirsiniz:

Katı mantığı takip eden geleneksel komut dosyalarının aksine, beceriler Claude'un akıl yürütme yeteneklerini kullanarak uç durumları ele alır, iyileştirmeler önerir ve değişen koşullara uyum sağlar.

Beceriler Nasıl Çalışır?

Beceriler birkaç temel mekanizma aracılığıyla çalışır:

1. Kullanıcı Tarafından Çağrılabilir Komutlar

# Bir beceriyi eğik çizgi komutuyla çalıştırın
/deploy-validation --env production
/security-review
/ci-pipeline-monitor --branch main

2. İzin Verilen Araçlar

Beceriler, kullanabilecekleri araçları belirtir:

3. Yaşam Döngüsü Kancaları

Beceriler belirli noktalarda eylemleri tetikleyebilir:

4. Planlama Dosyaları

Beceriler, ilerlemeyi izlemek, bulguları depolamak ve devam ettirilebilir iş akışlarını etkinleştirmek için markdown dosyalarını kullanarak durumu koruyabilir.

Beceriler Neden CI/CD'de Üstündür?

Geleneksel CI/CD komut dosyaları, beklenmedik koşullarla karşılaştığında kolayca bozulur. Beceriler otomasyona zeka getirir:

Beceri Anatomisi: Bileşenler ve Yapı

Dizin Yapısı

Beceriler, .claude/skills/ içinde şu düzenle yaşar:

.claude/
├── skills/
│   ├── deploy-validation/
│   │   ├── SKILL.md              # Beceri manifesti ve talimatları
│   │   ├── planning.md           # Durum takibi (isteğe bağlı)
│   │   └── scripts/              # Yardımcı komut dosyaları (isteğe bağlı)
│   ├── security-review/
│   │   └── SKILL.md
│   └── ci-monitor/
│       └── SKILL.md
└── skills.md                     # Tüm becerilerin indeksi

SKILL.md Manifesti

Her beceri, bir YAML ön alanı ve ardından markdown talimatlarıyla başlar:

---
name: deploy-validation
version: "1.0.0"
description: Kapsamlı kontrollerle dağıtım hazırlığını doğrular
user-invocable: true
allowed-tools:
  - Bash
  - Read
  - Edit
  - Grep
  - Glob
hooks:
  SessionStart:
    - matcher: command
      command: "echo '[Dağıtım Doğrulayıcı] Ön-dağıtım kontrolleri başlatılıyor...'"
  Stop:
    - matcher: command
      command: "echo '[Dağıtım Doğrulayıcı] Kontroller tamamlandı. Yukarıdaki çıktıyı inceleyin.'"
---

# Dağıtım Doğrulama Becerisi

Üretim sürümleri için kapsamlı ön-dağıtım doğrulaması.

## Kullanım

```bash
/deploy-validation --env production
/deploy-validation --env staging --dry-run
/deploy-validation --skip-tests  # Dikkatli kullanın

Bu Beceri Ne Yapar?

Ortam Doğrulama

Kod Kalitesi Kontrolleri

Test Etme

Yapı Doğrulama

Güvenlik Taraması

Dokümantasyon Kontrolü

Dağıtım Raporu

Claude İçin Talimatlar

Çağrıldığında, şu süreci izleyin:

  1. Ortamı ve seçenekleri belirlemek için komut satırı argümanlarını ayrıştırın
  2. Mevcut git dalını ve commit SHA'sını kontrol edin
  3. Her doğrulama adımını sırayla çalıştırın
  4. Her hata için sorunu günlüğe kaydedin ve devam edin (tüm hataları toplayın)
  5. Tüm kontrollerden sonra bir özet rapor oluşturun
  6. Kritik kontrollerden herhangi biri başarısız olursa, 1 hata koduyla çıkış yapın
  7. Tüm kontroller başarılı olursa, 0 koduyla çıkış yapın ve başarı mesajını gösterin

---

## Beceriler İçin CI/CD Kullanım Durumları

### 1. Ön-Taahhüt Doğrulama

**Beceri: `/pre-commit-guard`**

Değişiklikleri taahhüt etmeden önce otomatik olarak doğrular:
- Kod kalitesi denetimi ve biçimlendirme
- Sırlar için güvenlik taraması
- Birim testi yürütme
- Dosya boyutu kontrolleri
- Bozan değişiklik tespiti

**Fayda**: Sorunları kod tabanına girmeden önce yakalayın.

### 2. Çekme İsteği Analizi

**Beceri: `/pr-review`**

Şu işlevlere sahip akıllı PR incelemesi:
- Kod değişikliklerini kalite sorunları açısından analiz eder
- Güvenlik açıklarını kontrol eder
- Test kapsamını doğrular
- İyileştirmeler önerir
- İnceleme yorumları oluşturur

**Fayda**: İnsan engelleri olmadan tutarlı, kapsamlı kod incelemesi.

### 3. Otomatik Test İş Akışları

**Beceri: `/test-runner`**

Şu işlevlere sahip akıllı test yürütme:
- Değişikliklerle ilgili testleri tespit eder
- Testleri en uygun sırada çalıştırır
- Hataları analiz eder ve düzeltmeler önerir
- Kapsam raporları oluşturur
- Test performans eğilimlerini izler

**Fayda**: Akıllı test seçimiyle daha hızlı geri bildirim.

### 4. Dağıtım Doğrulama

**Beceri: `/deploy-validator`**

Ön-dağıtım kontrolleri şunları içerir:
- Ortam yapılandırma doğrulaması
- Bağımlılık doğrulaması
- Veritabanı geçiş kontrolleri
- API uyumluluk testi
- Performans gerilemesi tespiti

**Fayda**: Dağıtım hatalarını meydana gelmeden önce önleyin.

### 5. CI İşlem Hattı İzleme

**Beceri: `/ci-monitor`**

İşlem hattı sağlığını izler:
- Yapı başarı oranlarını izler
- Hatalı testleri belirler
- Performans eğilimlerini analiz eder
- Bozulma durumunda uyarır
- Optimizasyonlar önerir

**Fayda**: Proaktif işlem hattı bakımı ve optimizasyonu.

### 6. Sürüm Otomasyonu

**Beceri: `/release-manager`**

Sürüm sürecini düzenler:
- Sürüm yükseltme
- Değişiklik günlüğü oluşturma
- Etiket oluşturma
- Yapı yapıtı doğrulama
- Sürüm notları taslağı hazırlama

**Fayda**: Tutarlı, hatasız sürümler.

### 7. API Test Otomasyonu

**Beceri: `/api-test-runner`**

API'ler oluşturan ekipler için, kapsamlı API doğrulaması için Claude Code Skills'i [Apidog](https://apidog.com) ile birleştirin:

- **Test senaryoları oluşturun**: OpenAPI/Swagger belirtimlerinden API testleri oluşturun
- **Otomatik testleri çalıştırın**: İşlem hattınızda Apidog test koleksiyonlarını yürütün
- **Yanıtları doğrulayın**: Durum kodlarını, şemaları ve yanıt sürelerini kontrol edin
- **Bağımlılıkları taklit edin**: Yalıtılmış test için sahte sunucular kurun
- **Kapsamı izleyin**: API uç noktası test kapsamını izleyin

**Örnek beceri entegrasyonu:**
```bash
/api-test-runner --collection ./tests/api-collection.json --env production

Fayda: Görsel hata ayıklama ve ayrıntılı raporlarla dağıtımdan önce API gerilemelerini yakalayın. Apidog'un CI/CD entegrasyonu, herhangi bir işlem hattına API testini eklemeyi kolaylaştırır.

İlk CI/CD Becerinizi Oluşturma

Şimdi pratik bir beceri oluşturalım: taahhüt etmeden önce kodu kontrol eden bir güvenlik inceleme aracı.

Adım 1: Beceri Dizinini Oluşturun

mkdir -p .claude/skills/security-review

Adım 2: Beceri Manifestini Yazın

.claude/skills/security-review/SKILL.md dosyasını oluşturun:

---
name: security-review
version: "1.0.0"
description: Yaygın güvenlik açıkları ve sırlar için güvenlik taraması
user-invocable: true
allowed-tools:
  - Bash
  - Read
  - Grep
  - Glob
  - Write
hooks:
  SessionStart:
    - matcher: command
      command: "echo '[Güvenlik İncelemesi] Güvenlik taraması başlatılıyor...'"
  Stop:
    - matcher: command
      command: "echo '[Güvenlik İncelemesi] Tarama tamamlandı'"
---

# Güvenlik İnceleme Becerisi

Taahhüt etmeden önce kodu güvenlik sorunları için tarar.

## Kullanım

```bash
/security-review                    # Tüm değiştirilen dosyaları tara
/security-review --all              # Tüm kod tabanını tara
/security-review --file src/auth.js # Belirli bir dosyayı tara

Algılama Desenleri

Bu beceri şunları kontrol eder:

Sabit Kodlanmış Sırlar

Yaygın Güvenlik Açıkları

Güvensiz Yapılandırmalar

Bağımlılık Sorunları

Talimatlar

Çağrıldığında:

Tarama kapsamını belirle

Sırları ara

Güvenlik açığı desenlerini kontrol et

Bağımlılıkları tara

Rapor oluştur

Çıkış durumu


### Adım 3: Beceriyi Kaydedin

.claude/skills.md'ye ekleyin:

```markdown
# Mevcut Beceriler

## Güvenlik & Kalite

### /security-review
Güvenlik açıkları ve sırlar için güvenlik taraması.
- **Sürüm**: 1.0.0
- **Kullanım**: `/security-review [--all] [--file PATH]`
- **Ne zaman kullanılmalı**: Taahhüt etmeden önce, PR incelemesi sırasında

Adım 4: Beceriyi Test Edin

# Claude Code'da
/security-review

Claude şimdi güvenlik inceleme iş akışını yürütecek ve kodunuzu sorunlar açısından kontrol edecektir.

Gelişmiş Beceri Desenleri

Desen 1: Planlama Dosyaları ile Durum Koruyan İş Akışları

Çok adımlı süreçler için, ilerlemeyi izlemek üzere planlama dosyalarını kullanın:

---
name: release-manager
version: "1.0.0"
user-invocable: true
allowed-tools:
  - Bash
  - Read
  - Write
  - Edit
---

# Sürüm Yöneticisi

Tüm sürüm sürecini yönetir.

## Durum Yönetimi

Bu beceri, sürüm ilerlemesini izlemek için `planning.md` dosyasını kullanır:

```markdown
# Sürüm v2.5.0 İlerleme Durumu

## Aşama 1: Ön-Sürüm Doğrulama [TAMAMLANDI]
- [x] Tüm test paketini çalıştır
- [x] Kod kapsamı > %80 kontrol et
- [x] Güvenlik sorunları için tara

## Aşama 2: Sürüm Artırma [DEVAM EDİYOR]
- [x] package.json dosyasını güncelle
- [ ] CHANGELOG.md dosyasını güncelle
- [ ] Dokümantasyonu güncelle

## Aşama 3: Oluşturma & Etiketleme [BEKLEYEN]
- [ ] Üretim sürümü oluştur
- [ ] Sanity testlerini çalıştır
- [ ] Git etiketi oluştur
- [ ] Kayıt defterine gönder

## Aşama 4: Sürüm Sonrası [BEKLEYEN]
- [ ] GitHub sürümü oluştur
- [ ] Sürüm notlarını güncelle
- [ ] Ekibi bilgilendir

Talimatlar

planning.md dosyasının var olup olmadığını kontrol edin

Her aşamayı yürütün:

Her görev için:


### Desen 2: Koşullu İş Akışları

Beceriler proje türüne göre adapte olabilir:

```markdown
## Talimatlar

1. **Proje türünü tespit et**
   - `package.json` için kontrol et → Node.js projesi
   - `requirements.txt` için kontrol et → Python projesi
   - `Cargo.toml` için kontrol et → Rust projesi

2. **Uygun testleri çalıştır**
   - Node.js: `npm test`
   - Python: `pytest`
   - Rust: `cargo test`

3. **Kapsam raporları oluştur**
   - Node.js: Jest/Istanbul kullan
   - Python: pytest-cov kullan
   - Rust: tarpaulin kullan

Desen 3: Paralel Yürütme

Bağımsız görevler için, bunları eş zamanlı olarak çalıştırın:

## Talimatlar

1. **Paralel kontroller** (eş zamanlı çalıştırılır):
   - Kod kalitesi denetimi (ESLint, Prettier)
   - Tür kontrolü (TypeScript)
   - Güvenlik taraması (npm audit)
   - Dokümantasyon oluşturma

2. **Sonuçları topla**
   - Tüm görevlerin tamamlanmasını bekle
   - Bulguları topla
   - Herhangi bir hatayı rapor et

Desen 4: Etkileşimli Karar Verme

Beceriler kullanıcı girişi isteyebilir:

## Talimatlar

1. **Dağıtım risklerini analiz et**
   - Kırılgan değişiklikleri kontrol et
   - Geçiş komut dosyalarını incele
   - Geri alma karmaşıklığını değerlendir

2. **YÜKSEK risk tespit edilirse**
   - Kullanıcıya bulguları sun
   - Sor: "Yine de dağıtılsın mı? (evet/hayır/iptal)"
   - Evet ise: dağıtıma devam et
   - Hayır ise: iptal et ve kararı kaydet
   - İptal ise: işlem yapmadan çık

3. **DÜŞÜK risk ise**
   - Dağıtımı otomatik onayla
   - Denetim için kararı kaydet

Becerileri GitHub Actions ile Entegre Etme

Yöntem 1: Doğrudan Beceri Çağrısı

Claude Code'u GitHub Actions iş akışınıza ekleyin:

# .github/workflows/security-scan.yml
name: Güvenlik Taraması

on:
  pull_request:
    branches: [main, develop]

jobs:
  security-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Claude Code Yükle
        run: |
          curl -fsSL https://install.claude.com | sh

      - name: Güvenlik İncelemesi Çalıştır
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude /security-review --all

      - name: Rapor Yükle
        if: always()
        uses: actions/upload-artifact@v3
        with:
          name: security-report
          path: .claude/security-reports/

Yöntem 2: Özel GitHub Eylemi

Yeniden kullanılabilir bir eylem oluşturun:

# .github/actions/claude-skill/action.yml
name: 'Claude Kod Becerisini Çalıştır'
description: 'CI'da bir Claude Kod becerisini yürüt'
inputs:
  skill-name:
    description: 'Çalıştırılacak becerinin adı'
    required: true
  skill-args:
    description: 'Beceriye iletilecek argümanlar'
    required: false
    default: ''
  api-key:
    description: 'Anthropic API anahtarı'
    required: true

runs:
  using: 'composite'
  steps:
    - name: Claude Kurulumu
      shell: bash
      run: |
        curl -fsSL https://install.claude.com | sh

    - name: Beceri Çalıştır
      shell: bash
      env:
        ANTHROPIC_API_KEY: ${{ inputs.api-key }}
      run: |
        claude /${{ inputs.skill-name }} ${{ inputs.skill-args }}

İş akışlarında kullanım:

# .github/workflows/deploy.yml
name: Dağıtım

on:
  push:
    branches: [main]

jobs:
  validate-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Ön-Dağıtım Doğrulama
        uses: ./.github/actions/claude-skill
        with:
          skill-name: deploy-validation
          skill-args: '--env production'
          api-key: ${{ secrets.ANTHROPIC_API_KEY }}

      - name: Dağıt
        if: success()
        run: ./deploy.sh production

      - name: Dağıtım Sonrası Kontrol
        uses: ./.github/actions/claude-skill
        with:
          skill-name: health-check
          skill-args: '--url https://api.example.com'
          api-key: ${{ secrets.ANTHROPIC_API_KEY }}

Yöntem 3: Matris Testi

Becerileri birden fazla ortamda çalıştırın:

# .github/workflows/test-matrix.yml
name: Test Matrisi

on: [push, pull_request]

jobs:
  test:
    strategy:
      matrix:
        node-version: [16, 18, 20]
        os: [ubuntu-latest, macos-latest, windows-latest]

    runs-on: ${{ matrix.os }}

    steps:
      - uses: actions/checkout@v3

      - name: Node Kurulumu
        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.node-version }}

      - name: Test Becerisini Çalıştır
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude /test-runner --node-version ${{ matrix.node-version }}

Git Kancaları Entegrasyonu

Git Kancalarını Kurma

Git kancaları, becerilerin git olaylarında otomatik olarak çalışmasını sağlar.

Ön-Taahhüt Kancası

Kötü taahhütleri gerçekleşmeden önce önleyin:

# .git/hooks/pre-commit
#!/bin/bash

echo "Ön-taahhüt güvenlik incelemesi çalıştırılıyor..."

# Claude Kod güvenlik incelemesini çalıştır
claude /security-review

if [ $? -ne 0 ]; then
    echo "BAŞARISIZ: Güvenlik sorunları tespit edildi. Taahhüt engellendi."
    echo "Yukarıdaki sorunları düzeltin veya bypass etmek için 'git commit --no-verify' kullanın (önerilmez)"
    exit 1
fi

echo "BAŞARILI: Güvenlik kontrolü geçti"
exit 0

Yürütülebilir yapın:

chmod +x .git/hooks/pre-commit

Ön-Gönderme Kancası

Uzağa göndermeden önce doğrula:

# .git/hooks/pre-push
#!/bin/bash

echo "Ön-gönderme doğrulaması çalıştırılıyor..."

# Gönderilen dalı al
BRANCH=$(git rev-parse --abbrev-ref HEAD)

# Dala göre farklı kontroller çalıştır
if [ "$BRANCH" = "main" ]; then
    echo "main'e gönderiliyor - tam doğrulama çalıştırılıyor..."
    claude /deploy-validation --env production
elif [ "$BRANCH" = "develop" ]; then
    echo "develop'a gönderiliyor - hazırlık doğrulaması çalıştırılıyor..."
    claude /deploy-validation --env staging
else
    echo "Özellik dalı - hızlı doğrulama çalıştırılıyor..."
    claude /quick-check
fi

if [ $? -ne 0 ]; then
    echo "BAŞARISIZ: Doğrulama başarısız oldu. Gönderme engellendi."
    exit 1
fi

echo "BAŞARILI: Doğrulama geçti"
exit 0

Birleştirme Sonrası Kancası

Dalları birleştirdikten sonra çalıştırın:

# .git/hooks/post-merge
#!/bin/bash

echo "Birleştirme sonrası kontroller..."

# Bağımlılıkların değişip değişmediğini kontrol et
if git diff-tree -r --name-only --no-commit-id HEAD@{1} HEAD | grep -q "package-lock.json"; then
    echo "Bağımlılıklar değişti - güvenlik denetimi çalıştırılıyor..."
    claude /dependency-audit
fi

# Veritabanı geçişlerinin olup olmadığını kontrol et
if git diff-tree -r --name-only --no-commit-id HEAD@{1} HEAD | grep -q "migrations/"; then
    echo "Geçişler tespit edildi - doğrulanıyor..."
    claude /migration-validator
fi

exit 0

Husky Entegrasyonu

Git kancalarını yönetmek için Husky kullanan ekipler için:

// package.json
{
  "husky": {
    "hooks": {
      "pre-commit": "claude /security-review && claude /lint-check",
      "pre-push": "claude /test-runner --quick",
      "post-merge": "claude /dependency-audit"
    }
  }
}

Veya Husky v6+ ile:

# .husky/pre-commit
#!/bin/sh
. "$(dirname "$0")/_/husky.sh"

claude /security-review
claude /lint-check

Sonuç

Claude Code Skills, CI/CD'yi kırılgan komut dosyalarından akıllı, uyarlanabilir iş akışlarına dönüştürür. Yapay zeka akıl yürütmesini geleneksel otomasyonla birleştirerek, beceriler şunları yapabilir:

CI/CD hattınız API uç noktaları içeriyorsa, Claude Code Skills'i Apidog ile birleştirmek size her iki dünyanın en iyisini sunar:

ÖzellikFayda
Görsel API TestiKod yazmadan test senaryoları oluşturun
OpenAPI İçe AktarmaSpesifikasyonlarınızdan otomatik olarak testler oluşturun
Sahte SunucularArka uçlar hazır olmadan önce entegrasyonları test edin
CI/CD CLIApidog testlerini herhangi bir işlem hattında çalıştırın
Ekip İşbirliğiTest koleksiyonlarını ekibinizle paylaşın

API iş akışınızı kolaylaştırmaya hazır mısınız? Apidog'u ücretsiz indirin ve ilk API test koleksiyonunuzu dakikalar içinde oluşturun.

button

API Tasarım-Öncelikli Yaklaşımı Apidog'da Uygulayın

API'leri oluşturmanın ve kullanmanın daha kolay yolunu keşfedin

Ücretsiz Kaydolİndir