Özellik spesifikasyonu: gereksinimler ve aşamalı bir teslimat planı
Son güncelleme
Tek satırlık bir talebi Discovery & Spec ile kabul kriterlerine ve aşamalı bir plana dönüştürün: bir Researcher, bir Product Analyst ve bir Project Planner.
Bir özellik hâlâ bir iş kaydında tek bir cümleyken buradan başlayın. Discovery & Spec onu, herhangi bir uygulama kodu yazılmadan önce, birinin kontrol edebileceği gereksinimlere ve birinin takvime koyabileceği bir plana dönüştürür.
Hangi ajanlar çalışır
- Prior art. Researcher, özellikle ilgili kodu, kütüphaneleri ve kaynakları tarar. Bir fatura dışa aktarımı için bu, faturaların bugün nerede sorgulandığı ve servisin hâlihazırda hangi serileştiricileri kullandığı demektir.
- Requirements. Product Analyst, kabul kriterleri ve kapsam sınırlarıyla birlikte gereksinimleri yazar.
- Delivery plan. Project Planner işi bağımlılıklar, kilometre taşları ve efor tahminleriyle aşamalara böler.
Her adım, öncekilerin yazdıklarını okur.
Ne elde edersiniz
- Önerilen bir ADR. Üzerinde uzlaşılan gereksinimler, bir kişinin kabul etmesi veya reddetmesi için Plan → ADRs altında proposed (önerilen) olarak kaydedilir.
- Plan panosu maddeleri. Delivery plan adımının liste maddeleri, her biri onu öneren oturuma bağlı pano girdilerine dönüşür.
- Kod değişikliği yok. Discovery & Spec yalnızca belge yazar; bu yüzden oturum diff olmadan ve bir diff'i uygulamak için onay olmadan sona erer. Spesifikasyonu repoda tutmak için onu
docs/specs/içinde bir dosya olarak isteyen bir Plan, Build, Review & Test oturumu başlatın. Bu değişiklik, diğer her değişiklik gibi test komutunuzdan, yapay zekâ bulgu incelemesinden ve bir insan onayından geçer; böylece spesifikasyon, ekibin zaten yorum yaptığı bir pull request'te tartışılır.
Ajanlara koddan çıkaramayacakları bilgileri verin: kullanıcıların kim olduğu, beklenen hacimler ve neyin açıkça kapsam dışında olduğu.
Ajanlar iş kayıtlarını okusun, yazmasın
İş takip aracınız "Tracker" adlı (ID tracker) uzak bir MCP sunucusu olarak bağlıysa, bu politika kuralları yazma araçlarını her oturumdan uzak tutarken okuma araçlarını kullanılabilir bırakır:
[
{ "id": "tracker-no-create", "action": "mcp.invoke", "resource": "tracker/create_*", "decision": "deny" },
{ "id": "tracker-no-update", "action": "mcp.invoke", "resource": "tracker/update_*", "decision": "deny" }
]
mcp.invoke kuralları allow veya deny alır, asla ask almaz ve reddedilen bir araç ajanlara hiçbir zaman sunulmaz. Araç adları bağladığınız sunucuya bağlıdır; bu yüzden desenleri onun gerçek araç adlarına göre ayarlayın. Neyi engelleyeceklerini görmek için kuralları önce log-only modunda deneyin.
Sırada ne var
ADR'yi kabul edin veya reddedin, pano maddelerini triyajdan geçirin, ardından ilk aşamayı full-stack özellik şablonuyla veya aşama başına daha küçük bir Plan, Build, Review & Test oturumuyla geliştirin.
Sık sorulan sorular
Plan, Plan panosuna eklenir mi?
Evet. Oturum tamamlandığında Delivery plan adımının liste maddeleri, bir seferde en fazla 50 tane olmak üzere ve panoda zaten bulunan başlıklar atlanarak Plan panosu girdilerine dönüşür.
Researcher iş takip aracımızı okuyabilir mi?
Yalnızca bağladığınız uzak bir MCP sunucusu üzerinden ve yalnızca çalışma alanı politikanızın izin verdiği araçlarla.
İlgili içerikler
- Kod yazılmadan önce yaklaşımı belirleyen yapay zekâ planlaması
- MCP sunucuları
- Politika kuralları referansı
- Full-stack özellik: gereksinimlerden kullanıcı dokümantasyonuna tek oturumda
- Yapay zekâ kodlama ajanlarıyla çalışan repolar için CODEOWNERS başlangıç dosyası
- Altyapı değişikliği: canlı ortama dokunmadan risk incelemesi
- Tüm şablonlar