Xcode Agent Skills: Xcode 27'de Nasıl Dışa Aktarılır ve Kullanılır?

Kodlama ajanları Swift yazmakta iyidir, ama API'leri eğitildikleri veriden öğrenirler ve bu veri genellikle bir iki sürüm geridedir. Xcode agent skills bu açığı kapatıyor. Xcode 27, bir ajana güncel en iyi uygulamaları ve en yeni API'leri nasıl kullanacağını anlatan, Apple tarafından yazılmış skill'lerle geliyor ve tek bir komut bunları Xcode dışında çalışan ajanlar için dışa aktarıyor. Bu rehber skill'lerin ne olduğunu, nasıl dışa aktarılacaklarını, Xcode 27.1 öncesinden kalma bir kopyanın neden eskidiğini ve App Resizability skill'inin bir uygulamayı iPhone Duo'ya hazırlamanıza nasıl yardım ettiğini anlatıyor.

Buradaki her şey Apple'ın WWDC26 oturumlarından, iPhone Duo Tech Talk'larından, Apple'ın dokümantasyonu ve sürüm notlarından ve tek kaynak oldukları yerde belirttiğimiz geliştirici raporlarından geliyor. AppleDuo ekibi bu skill'leri yayında olan bir uygulamada çalıştırmadı. Xcode 27.x yeni; bu yüzden adlar ve davranışlar sürümler arasında değişebilir.

Xcode 27 agent skills nedir?

Skill, bir ajanın bir görev gerektirdiğinde yükleyebildiği bir uzmanlık paketidir. Apple'ın ajanları genişletme ve özelleştirme dokümantasyonu bunu "ajanları üst düzey görevler için en iyi API'leri ve iş akışlarını kullanmaya yönlendirebilen" yerleşik bir uzmanlık olarak tanımlıyor. Xcode'un içinde nadiren bir skill istemeniz gerekir: Xcode, yazdığınız isteme göre doğru skill'i kullanır.

Bir skill'i doğrudan da çağırabilirsiniz. Xcode 27 sürüm notlarına göre skill'ler "tamamlama desteğiyle slash komutu olarak çağrılabilir." Xcode kopyanızdaki tüm skill'leri görmek için kodlama asistanının mesaj alanına / yazın. Aynı sürüm skill'leri, MCP sunucularını ve ajan yapılandırmalarını bir araya getiren plug-in'leri de ekledi; yani liste Apple'ın kendi skill'lerinin ötesine geçebilir.

WWDC26 oturumu What's new in SwiftUI'da Apple, yeni skill'lerin 2027 sürümlerindeki özellikleri benimsemenize "ve uygulamanızın performansını ve kod doğruluğunu iyileştirmenize" yardımcı olmak için var olduğunu söylüyor. Ana fikir bu: ajan eski eğitim verisine güvenmek yerine Apple'ın güncel yönergelerini alır.

Xcode 27 ile hangi agent skills geliyor?

Apple tek bir liste yayınlamadı. Aşağıdakiler Apple'ın kendi oturumlarında ve sürüm notlarında adı geçen skill'ler ve her birinin geldiği sürüm.

Xcode ayrıca plan mode için /plan gibi iş akışı skill'leri de içeriyor; sürüm notları da yerelleştirme, UIKit yeniden boyutlandırma ve erişilebilirlik için Apple'ın geliştirdiği uzmanlardan bahsediyor. Kurulu Xcode sürümünüz için en güvenilir liste, dışa aktardığınız klasördür.

Xcode agent skills xcrun ile nasıl dışa aktarılır?

Apple komutu iki WWDC26 oturumunda veriyor. Modernize your UIKit app'da sunucu, skill'leri başka araçlarda kullanmak için xcrun agent skills export ile "Xcode'un kullandıklarını dışa aktarabileceğinizi" söylüyor; bu komut iş akışlarınıza aktarabileceğiniz Markdown dosyaları oluşturuyor.

@sarunw çıktı klasörlü versiyonu paylaştı:

xcrun agent skills export --output-dir ~/Downloads/xcode-skills

xcrun aracı etkin developer dizininizden çalıştırır; bu yüzden önce onun Xcode 27 veya sonrasını gösterdiğinden emin olun. Reda Lemeden'in yazısı, dışa aktarılan dosyalar koyduğunuz yerde kaldığı için sonrasında geri dönebileceğinizi belirtiyor. Aşağıdaki xcode-select komutları standart macOS araçları; yolu Xcode'unuzun bulunduğu yere göre düzenleyin.

# xcrun'ın hangi Xcode'u kullanacağını kontrol edin
xcode-select -p

# Xcode 27.1 veya sonrasını gösterin, ardından dışa aktarın
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
xcrun agent skills export --output-dir ~/Downloads/xcode-skills
ls ~/Downloads/xcode-skills

Lemeden'e göre komutu --output-dir olmadan çalıştırmak, her skill için bir klasörle birlikte geçerli dizine dışa aktarır. Apple başka bayrak belgelemedi; bu yüzden biz de listelemedik.

Xcode'un agent skills'ini Claude Code veya diğer ajanlarla kullanabilir miyim?

Evet, dışa aktarmanın amacı bu. Apple'ın iPhone Duo hazırlık sayfası bunu açıkça söylüyor: "Farklı bir kodlama ajanı kullanıyorsanız skill'i dışa aktarın." Apple'ın belgelemediği şey, her ajanın dosyaları nasıl yüklemesi gerektiği. Bu ajana bağlı.

Lemeden, dosyaları doğrudan bir Claude Code skills klasörüne aktardığını bildiriyor ve Claude Code ile OpenCode'u örnek vererek dosyaların skills biçimini destekleyen her harness ile çalıştığını söylüyor:

xcrun agent skills export --output-dir ~/.claude/skills

Skill'leri tek bir repository ile birlikte tutmayı tercih ederseniz proje başına bir klasör de işe yarar. Hangi ajanı kullanırsanız kullanın, skill'lerin nerede durduğunu ve nasıl tetiklendiğini o ajanın kendi dokümantasyonundan kontrol edin.

İki pratik not var. Birincisi, skill'ler Apple'ın içeriği. Başkasının paylaştığı bir kopyayı almak yerine kendi Xcode kopyanızdan dışa aktarın; böylece SDK'nızla eşleşen versiyonu alırsınız. İkincisi, Xcode dışındaki bir ajan işini ancak uygulamanızı derleyip çalıştırabiliyorsa kontrol edebilir. Xcode 27 sürüm notları, açık bir workspace olmadan çalışan ve sudo xcrun mcp-server enable ile açılan bir Xcode MCP sunucusunun önizlemesini tarif ediyor. Erken bir önizleme olduğundan pürüzler bekleyin.

Ajanlar kodunuzun yanında proje dosyanızı da düzenleyecekse Xcode 27.2'nin yeni JSON proje biçimi onlar için okuması ve birleştirmesi daha kolay. Bunu Xcode 27 .xcproj biçimi yazımızda anlatıyoruz.

Xcode 27.1'den sonra skill'leri neden yeniden dışa aktarmalıyım?

Skill'ler Xcode ile birlikte sürümlenir ve Xcode 27.1, iPhone Duo için önemli olan birini değiştirdi. Prepare your app for iPhone Duo Tech Talk'unda Apple, "Modernize your UIKit app"teki app modernization skill'inin Xcode 27.1'de yeni bir adı olduğunu söylüyor: "App Resizability. Artık SwiftUI ve iPhone Duo'yu destekliyor."

@sarunw bunun dışa aktarılmış kopyalar için ne anlama geldiğini açıkça yazdı: Xcode 27.1'den önce dışa aktardıysanız yeniden aktarın, çünkü uikit-app-modernization artık app-resizability. Xcode 27.0'dan dışa aktarılan bir klasör, iPhone Duo veya SwiftUI hakkında hiçbir şey bilmeyen eski skill'i tutar.

Yeniden dışa aktarırken ajanınızın iki versiyonu birden yüklememesi için önce eski klasörü silin veya yeni bir yola aktarın. Apple herhangi bir skill'i sürümler arasında güncelleyebileceğinden, her Xcode güncellemesinden sonra da aynısını yapın.

App Resizability skill'i iPhone Duo için nasıl kullanılır?

Xcode'un içinde Apple'ın iPhone Duo hazırlık sayfası, kodlama asistanından "get my app ready for iPhone Duo" (uygulamamı iPhone Duo'ya hazırla) istemenizi söylüyor. Skill projenizi tarar ve bulduğu her sorun için sorunu açıklayıp bir düzeltme önerir. Dışa aktarılmış bir kopyayla ajanınıza aynı isteği verin ve onu skill'e yönlendirin.

WWDC26 UIKit oturumu skill'in kendi başına yaptıklarını listeliyor: ana ekran çağrılarını trait collection veya scene sınırı kontrollerine çevirir, arayüz yönü kontrollerini size class kontrolleriyle değiştirir ve bir uygulamayı scene yaşam döngüsüne taşıyabilir. Daha büyük işler için açıklayıcı sorular sorar; tek oturuma sığmayacak kadar büyük işler için de kalan işi takip edebilmeniz amacıyla yorumlar bırakır.

Tipik bir değişiklik şöyle görünür. İki satır da standart UIKit API'si kullanıyor ve Apple'ın hazırlık sayfası tam olarak bu değişikliği öne çıkarıyor:

// Önce: boyut ana ekrandan alınıyor
let window = UIWindow(frame: UIScreen.main.bounds)

// Sonra: scene'den oluşturuluyor, böylece scene'in boyutunu takip ediyor
let window = UIWindow(windowScene: windowScene)

Apple, skill'in "sorunların çoğunu ama hepsini değil bulduğunu" açıkça belirtiyor. Onun taramasını ilk geçiş olarak kullanın, ardından Apple'ın elle düzeltmenizi istediği kalıpları gözden geçirin:

• Boyutu ana ekrandan almayı bırakın. UIScreen.main.bounds'u view.bounds veya window.bounds ile değiştirin; SwiftUI'da GeometryReader veya onGeometryChange kullanın.
• Yerleşim için yönü kullanmayın. UIDevice.current.orientation, statusBarOrientation veya interfaceOrientation okuyan yerleşim mantığını kaldırın.
• Idiom'u veya size class'ı bir cihaz gibi ele almayın. iPhone Duo'da bir iPhone uygulaması her size class kombinasyonunu alabilir; yani regular genişlik artık iPad anlamına gelmiyor. Ayrıntıları iPhone Duo size class'ları rehberimiz anlatıyor.
• Ekranı kaplayan medyayı kontrol edin. Fill modundaki büyük görseller daha geniş iç ekranda içerik kaybedebilir.

Ardından uygulamaları dikey bar'larla tüm ekrana genişleten iOS 27.1 SDK ile derleyin ve test edin. iPhone Duo hazırlık kontrol listemiz bu adımları sıraya koyuyor.

Xcode 27.2'de Device Hub'da ne değişti?

Ajanın yaptığı değişikliklerin yine de test edilmesi gerekir ve bunu Device Hub'da yaparsınız. Xcode 27.1 ile iPhone Duo simülatörünü seçer ve cihazı açmak, kapatmak, döndürmek veya katlamak için ekranın altındaki kontrolleri kullanırsınız. Xcode 27.2 sürüm notları, @sarunw'nun öne çıkardığı birkaçı da dahil olmak üzere bir dizi iyileştirme ekliyor:

• iPhone Duo'da StandBy desteği
• Slow Motion Animation, Simulate Shake, Simulate Fall ve Simulate Memory Pressure (yalnızca simülatörlerde)
• Sidecar üzerinden dokunma olayları; böylece pinch ve rotate bir iPad ekranından çalışır
• Cihaz çerçevelerini gizleme seçeneği, ayrıca ekran görüntüsü ve klavye iyileştirmeleri

Yavaş çekim, cihaz katlanırken bir yerleşim değişikliğini izlemenize yardım eder; bellek baskısı ise state'inizin yük altında bir yeniden boyutlandırmadan sağ çıkıp çıkmadığını gösterir. Apple'ın 27.2 notları bilinen sorunları da listeliyor: VoiceOver ve Accessibility Inspector, Device Hub içindeki iPhone Duo ekran içeriğini aktaramıyor ve cihaz açıldıktan sonra birkaç dakika boyunca ekran görüntüleri siyah olabiliyor.

Önemli çıkarımlar

• Xcode 27 agent skills, kodlama ajanları için Apple tarafından yazılmış, otomatik olarak veya slash komutlarıyla uygulanan yönergelerdir.
• Başka bir ajanla kullanmak için onları xcrun agent skills export, --output-dir ve bir klasörle dışa aktarın; Apple dışa aktarmanın Markdown dosyaları ürettiğini söylüyor.
• Xcode 27.1'den sonra yeniden dışa aktarın: uikit-app-modernization, SwiftUI ve iPhone Duo desteğiyle app-resizability oldu.
• "get my app ready for iPhone Duo" isteyin, ardından skill'in kaçırdıklarını gözden geçirin; Apple onun her şeyi yakalamadığını söylüyor.
• Sonucu, Xcode 27.2'de yavaş çekim, bellek baskısı, sallama ve düşme simülasyonları kazanan Device Hub'da test edin.

Sırada iPhone Duo hazırlık kontrol listesi var. Menteşeden zaten en iyi şekilde yararlanan uygulamalar için Built for the fold sayfasına göz atın.