68 lines
3.2 KiB
Markdown
68 lines
3.2 KiB
Markdown
# Kurulum Rehberi — Skill'i VS Code'daki Claude Code'a ekleme
|
||
|
||
## Neden proje skill'i?
|
||
Skill proje klasöründeki `.claude/skills/` altında durur. Böylece:
|
||
- VS Code'u bu klasörde açtığınız her an Claude Code skill'i otomatik görür,
|
||
- skill git deposuyla birlikte yedeklenir ve sürümlenir,
|
||
- `CLAUDE.md` her oturumda otomatik okunur ve `PROJECT_MEMORY.md`'yi (hafıza) içe aktarır.
|
||
|
||
## Ön koşullar
|
||
- Node.js 22 LTS veya üzeri (`node -v`)
|
||
- Git (`git --version`)
|
||
- VS Code + **Claude Code** eklentisi (Marketplace'te "Claude Code", yayıncı Anthropic), Claude hesabınızla giriş yapılmış
|
||
|
||
## Adımlar
|
||
|
||
1. **Zip'i açın** ve içeriğini **proje klasörünüzün köküne** kopyalayın. Sonuç şöyle olmalı:
|
||
|
||
```
|
||
proje-klasoru/
|
||
├── .claude/
|
||
│ └── skills/
|
||
│ └── ta1sph-site/
|
||
│ ├── SKILL.md
|
||
│ ├── references/ (7 dosya)
|
||
│ └── templates/article.md
|
||
├── docs/
|
||
│ ├── design-reference/ (5 ekran görüntüsü)
|
||
│ ├── ILK_PROMPT.md
|
||
│ └── KURULUM.md
|
||
├── CLAUDE.md
|
||
└── PROJECT_MEMORY.md
|
||
```
|
||
|
||
> `.claude` gizli bir klasördür. macOS Finder'da görmek için `Cmd+Shift+.`, Windows'ta Gezgin → Görünüm → Gizli öğeler.
|
||
|
||
2. **Git'i başlatın** (önerilir, terminalde proje klasöründe):
|
||
|
||
```bash
|
||
git init -b main
|
||
git add .
|
||
git commit -m "chore: add Claude Code skill and project memory"
|
||
```
|
||
|
||
3. **VS Code'u bu klasörde açın:** `Dosya → Klasör Aç…` (veya terminalde `code .`).
|
||
|
||
4. **Claude Code panelini açın** (kenar çubuğundaki Claude simgesi veya Komut Paleti → "Claude Code: Open"). Klasör ilk açıldığında "bu klasöre güveniyor musunuz" sorulursa onaylayın.
|
||
|
||
5. **Skill'in yüklendiğini doğrulayın.** Panelde şunu yazın:
|
||
|
||
```text
|
||
Hangi skill'ler yüklü? ta1sph-site skill'ini görüyor musun, kısaca ne yaptığını söyle.
|
||
```
|
||
|
||
Claude `ta1sph-site`'ı ve komutları (Siteyi Kur, Makale Ekle…) saymalı. Görmüyorsa: dosya yolunun tam olarak `.claude/skills/ta1sph-site/SKILL.md` olduğunu kontrol edin ve paneli yeniden başlatın.
|
||
|
||
6. **İlk prompt'u gönderin:** `docs/ILK_PROMPT.md` içindeki kod bloğunu kopyalayıp yapıştırın.
|
||
|
||
7. **Aşamaları onaylayarak ilerleyin.** Claude her aşamanın sonunda durup özet verecek. "Devam" yazmanız yeterli. Komut çalıştırma izinleri sorulduğunda (`npm install`, `git commit` vb.) okuyup onaylayın.
|
||
|
||
## Kullanım ipuçları
|
||
- Yeni bir sohbet başlattığınızda Claude hafızayı `CLAUDE.md` → `PROJECT_MEMORY.md` üzerinden okur; projeyi baştan taramaz.
|
||
- Bir oturum çok uzarsa yeni sohbet açın; hafıza sayesinde kaldığı yerden devam eder.
|
||
- Hafızanın kodla uyumsuz olduğunu düşünürseniz: `Hafızayı Güncelle`.
|
||
- Skill'i daha sonra değiştirmek isterseniz `SKILL.md` veya `references/*.md` dosyalarını düzenleyin ya da Claude'a "skill'e şu kuralı ekle" deyin.
|
||
|
||
## Deploy (site hazır olduğunda)
|
||
`Yayına Al` komutunu verin; Claude size `references/deployment.md`'deki Dokploy kontrol listesini (DNS, port yönlendirme, domain, SSL, volume, www→apex) adım adım uygulatacak.
|