Yapay Zeka Kodlama Ajanına İlk Görevinizi Nasıl Atarsınız?

TL;DR: Bir yapay zekâ ajanına ilk görevinizi atamak için, ajanın kendi kendine kontrol edebileceği küçük bir iş seçin; başlığı hedeflenen sonuç, açıklamayı ise kapsam ve “tamamlanma kriteri” şeklinde yazın; ardından süreci sürekli yönlendirmek yerine işi devredip sonucu inceleyin. Sharkly'de bu; Claude Code veya Codex oturumu açık bir Computer bağlamak, tek bir görevi olan bir Agent oluşturmak, bir Task açıp Assignee alanını bu Agent olarak belirlemek anlamına gelir. Assignee seçildiğinde çalıştırma işlemi başlar. Sonuç Task'e iletilir ve bir kişi görevi Done durumuna getirir.

Haftalardır terminalinizde Claude Code veya Codex kullanıyor olabilirsiniz. Siz yazarsınız, o düzenler; siz düzeltirsiniz, o tekrar düzenler. Ancak bir görev atamak bambaşka bir yaklaşımdır: İşi bir kez yazılı olarak tanımlar, teslim eder ve ardından sonuca bakmak üzere geri dönersiniz. İlk denemeler genellikle can sıkıcı derecede basit nedenlerle başarısız olur: Görevde yalnızca “giriş hatasını düzelt” yazıyordur ve başka detay yoktur. Computer üzerindeki kodlama aracında oturum açılmamıştır. Ajanın çalıştırabileceği bir test bulunmadığından tahmin yürüterek işi tamamlandı saymıştır.

Bu rehber, bir yapay zekâ ajanına ilk görevinizi başarıyla tamamlayabileceği şekilde nasıl atayacağınızı ele alıyor: Doğru görevi seçme, görevi yazma, Sharkly'deki adımlar ve dönen sonucu inceleme. Bir konunun sohbette mi kalması yoksa görev olarak mı atanması gerektiğine henüz karar veremiyorsanız, öncelikle yapay zekâ ajanıyla sohbet mi etmeli, görev mi atamalı? yazımıza göz atın.

Bir yapay zekâ ajanının tamamlayabileceği bir ilk görev seçin

Bir yapay zekâ ajanına görev atamak; bir kodlama ajanına kendi başına yürüteceği yazılı bir iş birimi teslim etmek ve her istemle onu adım adım yönlendirmek yerine dönen sonucu incelemek demektir. İlk görevi bilerek basit ve sıradan seçin. Burada test ettiğiniz şey ajanın sınırları değil, kurduğunuz altyapıdır.

İyi bir ilk görev; ortaya çıkacak farkı tek bir cümleyle özetleyebileceğiniz kadar küçük, ajanın kendi kendine çalıştırabileceği bir doğrulamaya sahip, tek bir modül içinde kalan ve geri almaktan çekineceğiniz hiçbir şeye dokunmayan bir iştir: veritabanı migrasyonları, canlı ortam yapılandırmaları veya gizli anahtarlar olmamalıdır.

Sağdaki sütundaki işler yanlış işler değildir. Ancak sınırları çizilmemiş işlerdir; bu yüzden ajanın kapsamı kendisinin uydurması gerekir, sizin de hedefe ulaşıp ulaşmadığını tahmin etmeniz gerekir. Anthropic'in Claude Code ile çalışma rehberi en kritik özelliği şöyle tanımlar: “Claude'a çalıştırabileceği bir kontrol verin: testler, bir derleme veya karşılaştırabileceği bir ekran görüntüsü.” Kontrol mekanizması olmayan bir ajan size sadece işi bitirdiğini söyleyebilir. Kontrol mekanizması olan bir ajan ise bunu kanıtlayabilir.

Görevi yapay zekâ ajanının bitirebileceği şekilde yazın

Sharkly'nin Tasks dokümantasyonu başlıklar için şu kuralı koyar: “Kullanışlı bir başlık, konuyu değil varılacak sonucu belirtir.” Açıklama kısmı ise ekibe yeni katılan bir kişinin veya bir Ajanın ihtiyaç duyacağı her şeyi içerir: İşin neden önemli olduğu, nelerin kapsam içi ve kapsam dışı olduğu, ilgili dosyalar ve örnekler, önceden alınmış kararlar ve tamamlanmanın nasıl doğrulanacağı. OpenAI'ın Codex prompt rehberi de neredeyse aynı çerçeveyi kullanır: Hedef, Bağlam, Kısıtlamalar, Tamamlanma kriteri.

İşte bu formatta yazılmış, SH-312 numaralı örnek bir ilk görev:

Title: Reject empty and malformed strings in parseDate()

Why: Support tickets show a 500 when the import form gets a blank date.

Scope: src/dates/parse.ts and its tests only. Do not change callers.

Context: Follow the pattern in src/dates/format.ts.
Errors use InvalidInputError from src/errors.ts.

Constraints: No new dependencies. Keep the public signature.

Done when:
- parseDate("") and parseDate("31/02/2026") throw InvalidInputError
- npm test passes
- Your final comment lists the files you changed and the test command you ran

Son satır göründüğünden çok daha önemlidir. “Bitirdim” ifadesini on saniye içinde doğrulayabileceğiniz somut bir kanıta dönüştürür.

Görevler çoğaldıkça süreci düzenli tutacak iki alışkanlık vardır: Değişmeyen hedefi, kapsamı ve kabul kriterlerini yorumlara dağıtmak yerine açıklama alanında tutun. Ayrıca, “talep belirsiz olduğunda soru sor” gibi genel ve süreklilik arz eden davranışları Ajanın talimatlarında tutun; böylece her Task yalnızca kendisine özgü detayları içerir.

Sharkly'de bir yapay zekâ ajanına ilk görevinizi atayın

Halihazırda kodlama ajanlarına sahipsiniz; Sharkly onları bir ekibe dönüştürür. İlk çalıştırma için dört unsur gerekir: bir çalışma alanı, bir Computer, bir Agent ve bir Task. Buradaki adımlar Sharkly hızlı başlangıç kılavuzunu takip eder:

1. Giriş yapın ve çalışma alanını oluşturun. app.sharkly.ai adresinden e-posta kodu, Google veya GitHub ile giriş yapın, bir Organization oluşturun ve Initialize workspace aşamasında Software development seçeneğini belirleyin. Sharkly, Requirement ve Bug görev türlerini içeren Default Space alanını oluşturur.
2. Bir Computer bağlayın. İşi yürütecek bilgisayara Claude Code, Codex, Gemini, OpenClaw, Hermes veya Pi Agent kurun ve oturum açın. Masaüstü uygulaması bu araçları algılar ve ilgili bilgisayarı kaydeder. Web sürümünde ise Get started ve ardından Connect Computer adımları, o makinede çalıştırmanız için bir komut verir. Dokümantasyonda “Online yalnızca bağlantının kurulduğu anlamına gelir” uyarısı yer aldığından, Computer'ı açıp Runtime durumunun Available olduğunu kontrol edin. Sharkly'de Computers yazımız dizüstü bilgisayarlar ile sunucuların karşılaştırmasını ele almaktadır.
3. Tek bir işe odaklanan bir Agent oluşturun. Agents bölümünü açın, New Agent'ı seçin, Code development'ı ve ardından “the Agent automatically pulls Git repositories” seçeneğini belirleyip deponuzu ekleyin. İlgili Computer'ı seçin ve talimatları kısa tutun. Her Task'in kendi worktree'sini alması için çalışma dizinini Create temporary directory olarak bırakın ve Ajan işe yarar hale gelene kadar görünürlüğü Personal olarak tutun. Burada bir model seçici bulunmaz: Belirli bir model istiyorsanız bunu Custom arguments alanında belirtin.
4. Salt okunur bir kontrol çalıştırın. Kod değiştiren herhangi bir işten önce, Repositories dokümantasyonu şu tarz bir Task önerir: “Depoyu inceleyin; ana dili, paket yöneticisini ve en uygun test komutunu raporlayın. Dosyaları değiştirmeyin.” Bu kontrol, Ajanın depoya erişebildiğini, Git erişimini kullanabildiğini ve komut çalıştırabildiğini doğrular.
5. Task'i oluşturun ve atayın. Tasks sayfasında New Task'i seçin, başlığı ve açıklamayı yapıştırın. Yeni bir Task, Todo olarak başlar. Assignee alanını Agent olarak ayarlayın. Hızlı başlangıç kılavuzundaki ifadeyle: “Assignee'yi belirlemek Ajanı başlatır. Durumu önceden değiştirmeniz gerekmez.” İstisna ise bir bekleme durumu olan Backlog'dur: Buradaki bir Task, siz onu başka bir duruma taşıyana kadar çalıştırılmaz.

Yapay zekâ ajanının çalışmasını izleyin ve sonucu inceleyin

Bir çalıştırma işlemi, Task'in durumundan ayrı olarak kendi durumlarına sahiptir. Agent task execution sayfası bunları şöyle tanımlar:

Task üzerinde Activity sekmesi, Ajanın nihai değerlendirmesi de dahil olmak üzere yorumları; Executions sekmesi ise çalıştırma geçmişini gösterir. Dikkatinizi gerektiren her şey Inbox altında Primary bölümüne düşer: Yanıtınızı veya incelemenizi bekleyen bir konuşma, başarısız olan ya da engellenen işler ve doğrudan sizden bahsedilen durumlar.

Çalıştırma bittiğinde worktree değişikliklerini inceleyin; ardından bunları koruyun, birleştirin veya iptal edin. Bir sorun varsa, düzeltilmesini istediğiniz somut noktayı belirterek yorumda Ajandan @bahsedin: “Boş dizgi durumu hâlâ null döndürüyor. InvalidInputError fırlat.” Düz bir yorum Ajanı tetiklemez; onu başlatan şey etiketlemedir. Sonuç doğru olduğunda, bir kişi görevi Done durumuna getirir. Ajanlar araştırır, uygular, test eder ve raporlar. İnsanlar ise yönü belirler, yetki verir ve sonucu kabul eder. Değişikliklerde nelere dikkat etmeniz gerektiğiyle ilgili olarak görev düzeyinde kanıtlarla yapay zekâ tarafından üretilen kodu inceleme başlıklı yazımıza göz atın.

Tek bir yapay zekâ ajanı mı, bir Crew mu, yoksa yalnızca terminaliniz mi?

Klavyenin başındaysanız ve şu an tek bir değişiklik yapmak istiyorsanız, terminalinizde açacağınız bir Claude Code veya Codex oturumu herhangi bir görev atama akışından daha hızlıdır ve bunun için Sharkly'ye ihtiyacınız olmaz. Görev atamak; bilgisayarın başından kalkmak istediğinizde, sonucu başka biri inceleyeceğinde veya yapılan işin ekibin görebileceği bir kayıtta kalması gerektiğinde değer kazanır.

Sharkly içinde, Crews dokümantasyonu temel kuralı şöyle ortaya koyar: “Küçük ve net şekilde tanımlanmış işler için Task'i doğrudan tek bir Agent'a atayın. Liderin hedefi yorumlaması, diğer Agent üyelerini dahil etmesi ve onların sonuçlarını bir araya getirmesi gerektiğinde ise bir Crew kullanın.” İlk göreviniz tek bir Agent'a gitmelidir. Sharkly Crews yazısı ikinci senaryoyu ayrıntılarıyla ele alır.

Bir Agent belirli bir türdeki Task'i istikrarlı şekilde tamamlamaya başladığında, hızlı başlangıç rehberi daha uzmanlaşmış bir Agent ayırmanızı veya tekrarlanan bir prosedürü Skill olarak kaydetmenizi önerir. Bundan sonraki adım genellikle aynı anda birden fazla Task yürütmektir; birden fazla Claude Code ajanını paralel çalıştırma rehberimiz yalıtım ve birleştirme sırasını kapsamaktadır. Agents özellik sayfası tüm bu kurulumu uçtan uca göstermektedir.

Zaten ücretini ödediğiniz kodlama ajanlarına iş delege etmek ve tüm sonuçları tek bir yerde toplamak istiyorsanız, Sharkly tam olarak bu sorunu çözmek için tasarlanmıştır.

SSS

Bir görev atamak yapay zekâ ajanını hemen başlatır mı? Genellikle evet. Task; Backlog, Completed, Canceled veya Duplicate durumlarında olmadığı sürece Assignee belirlendiğinde çalıştırma başlar. Bununla birlikte çalıştırma işlemi; Computer'ın müsaitliği, eşzamanlılık sınırları veya boş bir dizin için Queued durumunda bekleyebilir.

Computer çevrimdışı olursa ne olur? Yeni çalıştırmalar normal şartlarda makinenin yeniden bağlanmasını bekler; Computer dağıtımdan önce koparsa çalıştırma kuyrukta kalabilir. İş almaya devam etmesi gereken bir dizüstü bilgisayar için Prevent sleep ayarını açık tutun.

Model ücretini Sharkly üzerinden mi ödüyorum? Hayır. Çalıştırmalar doğrudan Computer üzerinde tanımlı olan Claude Code, Codex veya API planı üzerinden faturalandırılır; Sharkly token satışı yapmaz. Sharkly'nin kendisi ise 5 kişiye kadar olan organizasyonlar için şu anda ücretsizdir; detaylar için Sharkly fiyatlandırma rehberine göz atabilirsiniz.

Ajan bilgisayarımda nelere erişebilir? Computer'ın sağladığı her şeye: “bir Ajanın ihtiyaç duyduğu işletim sistemi, dosyalar, kimlik bilgileri, ağ erişimi ve araçlar.” Kendi kimlik bilgilerinizi kullandıkları sürece Agent ve Computer görünürlüğünü Personal olarak tutun, Task içine asla token yapıştırmayın ve bir ajana neye izin verilip verilmemesi gerektiğine ilişkin yazımızı okuyun.