wizard

Files (1)

• SKILL.md

SKILL.md (first lines)

# Sihirbaz (wizard)

Bir insanı, elle yapması sıkıcı ve AI'ya her seferinde yeniden anlatması zor olan manuel bir prosedürden adım adım geçiren bir **bash betiği**. Her URL'yi açar, tam olarak neye tıklanacağını/kopyalanacağını söyler, değerleri yakalar, yerlerine yazar (`.env`, GitHub secrets), her aşamada onaylar ve kaç aşama kaldığını gösterir.

Sihirbaz varsayılan olarak geçicidir — tek çalıştırma için üretilir, iş bitince silinir. Yalnızca tekrarlanabilir bir kurulum yolu isteniyorsa commit'le.

## Süreç

### 1. Prosedürü kapsamla
Her manuel adımı ve yakalanan her değeri çıkar. Önce repoyu oku (boş soru sorma):
- Kurulum için: `.env`, `.env.example`, `README`, `docker-compose*`, `.github/workflows/*` (her `secrets.*`/`vars.*` referansı, sihirbazın üretmesi gereken bir değerdir)
- Migration için: mevcut durum, hedef durum, geri alınamaz eylemler

Aşama listesini ve üretilen değerleri kullanıcıya göster, onay al.

**Bitti:** her aşama sıralı adlandırıldı; her değer için (a) insan onu nereden alır, (b) nereye yazılır, (c) gizli mi açık mı biliniyor.

### 2. Her aşamanın yolunu haritala
Her aşama için insanın izlediği kesin yol: hangi URL, orada ne yapılır, değer nerede gösterilir, hangi değişkeni doldurur. Güncel UI'yi bilmiyorsan söyle ve sor — olmayan adımları uydurma.

### 3. Sihirbazı yaz
`template.sh`'i hedef yola kopyala. Örnek aşamayı, her adım için bir `stage` ile değiştir. Yardımcıları kullan: `stage`, `say`/`step`, `open_url`, `ask`/`ask_secret`, `write_env`, `set_secret`/`set_var`, `pause`/`confirm`. `TOTAL_STAGES`'ı yazdığın aşama sayısına ayarla.

Barı koru: değerini sormadan önce URL'yi aç, gizli olan için `ask_secret` kullan, her kalıcı değeri `write_env` ile yaz, CI'ın gerçekten ihtiyaç duyduğu değerleri `set_secret` ile yaz, geri alınamaz eylemden önce `confirm`. Marker üstündeki kitaplığı değiştirme.

### 4. Doğrula ve devret
- `bash -n <script>`; `shellcheck` varsa çalıştır
- `chmod +x <script>`
- Uçtan uca kendin çalıştırma (tarayıcı açar, insan girdisi bekler) — statik izle: her değer yakalanıyor ve söylenen yere yazılıyor mu, her `set_secret` adı CI'daki bir `secrets.*` ile birebir eşleşiyor mu
- Kullanıcıya nasıl çalıştıracağını söyle. Tekrarlanabilir kurulum yoluyas commit'le ve README'den linkle

## Ne zaman KULLANMA

- Adımı ajan kendisi yapabiliyorsa
- Prosedür tek seferlikse ve tekrar etmeyecekse

From murataslan1/kamuyz-agent-starter, MIT.

More from murataslan1/kamuyz-agent-starter