Kurallar
Kural dosyaları aracılığıyla Verdent'in davranışını kontrol etme
Kural dosyaları, kodlama oturumları sırasında Verdent'in nasıl davranacağını tanımlayan Markdown belgeleridir. Yapay zeka aracısının davranışını, çıktı biçimlendirmesini ve proje standartlarına uyumu yönlendirir.
Neler öğreneceksiniz
- Kullanıcı kuralları ve proje kurallarını anlama
- Her kural türünün ne zaman kullanılacağı
- Etkili kurallar yazma
Kural türleri
| Kural türü | Dosya | Kapsam | Amaç |
|---|---|---|---|
| Kullanıcı kuralları | VERDENT.md | Genel (tüm projeler) | Kişisel kodlama tercihleri |
| Proje kuralları | AGENTS.md | Geçerli proje | Ekip kuralları, proje standartları |
Konum:
- Kullanıcı kuralları:
~/.verdent/VERDENT.md - Proje kuralları:
<project>/AGENTS.md
Kullanıcı kuralları (VERDENT.md)
Kullanıcı kuralları, Verdent'in tüm projelerde nasıl davrandığını özelleştirmenizi sağlar.
Erişim: Settings → User Rules
Otomatik kaydetme: Değişiklikler 500 ms sonra otomatik kaydedilir
- Kodlama stili tercihleri: Girintileme, adlandırma kuralları
- Framework kuralları: React, Vue, dil standartları
- Yanıt biçimlendirme: Ayrıntı düzeyi, açıklama stili
- Kişisel iş akışı tercihleri: Üslup, iletişim stili
# User Rules
## Code Style
- Always use TypeScript with strict mode
- Prefer functional components over class components
- Use Tailwind CSS for styling
- Follow the project's existing naming conventions
## Communication
- Provide brief explanations
- Show code first, explain after
- Write concise commit messages in conventional formatProje kuralları (AGENTS.md)
Proje kuralları, geçerli projeye özgü standartları tanımlar. Ekip genelinde paylaşmak için sürüm kontrolüne ekleyin.
Erişim: Project Settings paneli
Konum: Proje kök dizini (<project>/AGENTS.md)
- Ekip kuralları: Ortak kodlama standartları
- Mimari: Tasarım desenleri, durum yönetimi
- Test: Kapsam gereksinimleri, framework'ler
- İş akışları: Derleme komutları, PR yönergeleri
# AGENTS.md
## Dev Environment
- Run `pnpm install` to set up
- Use `pnpm dev` for local development
## Testing
- Run `pnpm test` before committing
- Minimum 80% coverage required
## PR Guidelines
- Use conventional commit format
- Include tests for new featuresTüm ekip üyeleri arasında tutarlı yapay zeka davranışı sağlamak için AGENTS.md dosyasını sürüm kontrolü aracılığıyla ekibinizle paylaşın.
Etkili kurallar yazma
Belirgin olun:
# Good
- Use async/await for asynchronous operations
- Include JSDoc comments for exported functions
# Avoid
- Try to use modern JavaScript features
- Add comments when necessaryEn iyi uygulamalar:
- Açık, yönlendirici bir dil kullanın ("Her zaman...", "Asla...", "Tercih et...")
- İlgili kuralları bölüm başlıkları altında gruplandırın
- Kuralları kısa tutun (madde başına bir kavram)
- Proje geliştikçe kuralları gözden geçirin ve güncelleyin
SSS
Kural dosyalarını nasıl oluştururum?
Kişisel tercihler için VERDENT.md dosyasını düzenlemek üzere Settings → User Rules bölümüne gidin. Projeye özgü kurallar için proje kök dizininizde AGENTS.md oluşturun. Madde işaretleriyle düz Markdown kullanın.
Kural değişiklikleri ne zaman geçerli olur?
Kural değişiklikleri yeni konuşmalarda hemen geçerli olur ve geçerli konuşmanın yanıtlarını etkiler.
Kuralları geçici olarak geçersiz kılabilir miyim?
Tek bir istek için kuralları geçersiz kılmak amacıyla isteminizde belirli talimatlar verebilirsiniz.