Document ★ 18,759

handoff

Geçerli konuşmayı başka bir agentin devam ettirebilmesi için kompakt bir handoff dökümanına dönüştürün. Kullanıcı tarafından yapılandırılan bir konuma (OS temp, home folder veya per-project .handoff/) kaydedin, yazılmadan önce sırları redakte edin, sonraki oturum için beceri önerileri sunun ve SessionStart'ta en son handoff'u otomatik yükleyin. İlk çalıştırmada proje klasörünün asla karışmaması için kaydetme konumunun sorulması sağlanır.

cd ~/.claude/skills
git clone https://github.com/alirezarezvani/claude-skills.git claude-skills

Devir

Mevcut konuşmayı özetleyen bir devir belgesi yazın, böylece yeni bir ajan çalışmaya devam edebilsin. Kullanıcının işletim sisteminin geçici dizinine kaydedin — mevcut çalışma alanına değil.

Belgede bir "önerilen beceriler" bölümü ekleyin ve ajanın çağırması gereken becerileri önerin.

Diğer yapıtlarda zaten yakalanan içeriği çoğaltmayın (PRD'ler, planlar, ADR'ler, sorunlar, commit'ler, diff'ler). Bunun yerine yol veya URL ile referans verin.

API anahtarları, parolalar veya kişisel olarak tanımlanabilir bilgiler gibi hassas bilgileri redakte edin.

Kullanıcı argümanlar geçtiyse, bunları bir sonraki oturumun odaklanacağı şeyin açıklaması olarak kabul edin ve belgeyi buna göre uyarlayın.

Çağrı Tetikleyicileri

Açık ifadeler (herhangi biri):

  • "bu işi devret"
  • "devir belgesi"
  • "bunu yeni bir oturum için özetle"
  • "bu konuşmayı sıkıştır"
  • "bu oturumu bitiriyorum"
  • "bunu daha sonra al"
  • "bunu yarın için hazırla"
  • "bunu bir sonraki oturum için kaydet"

Örtük sinyaller (ifade yok, ama niyet açık):

  • Kullanıcı makine değiştirmeyi veya görevin ortasında durduğunu duyurur
  • Konuşma bağlamı doğal bir durma noktası olmadan uzun hale geliyor
  • Kullanıcı "buna daha sonra döneyim" veya "bunu daha sonra devam ettireceğim" diyor

Örtük bir tetikleyici algıladığınızda, çalıştırmadan önce devri öneyin: "Bir sonraki oturum için devir belgesi yazayım mı?" — asla sessizce çalıştırmayın.

İlk Çalıştırma Kurulumu

İlk çağrıda, beceri devir belgelerinin nereye kaydedileceğini sorar, böylece proje klasörü asla karışmaz. Kurulum bir kez "Şimdi kurulum çalıştırmak ister misin? (E/h)" şeklinde sunulur — h cevabı bu çalıştırma için OS-temp varsayılanlarını kullanır ve asla yeniden sorulmaz. Kullanıcı /cs:handoff-setup aracılığıyla herhangi bir zamanda kurulumu yeniden çalıştırabilir.

Tam yapılandırma alanı referansı için references/configuration.md bölümüne bakın.

Çıktı Yolu

Kaydetme konumu kullanıcının yapılandırmasından okunur (~/.config/handoff/config.json veya varsa proje-lokal .handoff/config.json). Yapılandırma yok ve kullanıcı kurulumu reddetmişse, şu şekilde geri dönün:

mktemp -t handoff-XXXXXX.md

Yazı yazmadan önce dosyayı okuyun.

Bölüm Şablonu

Devir belgesi beş bölüme sahiptir. Bu tam başlıkları kullanın:

  • Bir sonraki oturumun hedefi — kullanıcının argümanından veya konuşmanın en son iş parçacığından çıkarsanmış.
  • Oyunun durumu — ne tamamlandı, ne devam ediyor, ne engellendi. Yapıtlara referans verin, yapıştırmayın.
  • Açık kararlar — bir sonraki ajanın devam etmeden önce karar vermesi gereken şeyler.
  • Kullanılacak beceriler — bir sonraki oturumun çağırması gereken 3-5 beton beceri listesi, her biri bir satırlık neden ile.
  • Yapıtlar — PRD'ler, planlar, ADR'ler, sorunlar, dallar, PR'ler için yollar/URL'ler. İçeriklerini çoğaltmayın.

Çalışılan örnek için references/handoff_structure.md bölümüne bakın.

Ajanın İşi

Beş bölümü doldurmak ajanın işidir, komut dosyasının değil. references/handoff_prompt.md öğesini zorunlu bir kontrol listesi olarak izleyin:

Konuşmada tartışılan her konu için açıkça karar verin: Oyunun Durumunda Dahil Et / Açık karar olarak Kaydet / Nedenle Sil.

Özeti serbest şekilde yazın, pembe ilerleme raporları ve kaybedilen engeller alır. Kontrol listesi bunu engeller.

Kötü Desenler

Matt'in çoğaltmama disiplini somut hale getirildi:

  • Diff'i yapıştırmayın. Dala veya PR'ye referans verin.
  • PRD'yi yeniden yazmayın. Yoluna bağlantı verin.
  • Commit mesajında zaten olanları özetlemeyin. Commit hash'ine bağlantı verin.
  • 20 beceri listelemeyin. Bir sonraki oturumun gerçekten ihtiyacı olan 3-5 tanesini seçin.
  • Konuşmada her mesajı anlatmayın. Durum + Kararlar halinde sıkıştırın.

Tam liste için references/deduplication_discipline.md bölümüne bakın.

Redaksiyon

Kaydetmeden önce, linter taslağı sırlar ve PII açısından tarar. Katı modda (varsayılan) bulgular üzerine kaydetmeyi engeller; uyar modunda satır içi bayraklar ve yine de kaydeder.

Redakte edin:

  • API anahtarları, OAuth belirteçleri, JWT belirteçleri
  • Parolalar ve VT bağlantı dizeleri
  • -----BEGIN ... PRIVATE KEY----- blokları
  • Sır içeren .env-stili ANAHTAR=değer satırları
  • E-posta adresleri, telefon numaraları, ilgisiz üçüncü tarafların adları
  • Token veya oturum kimliği içeren iç URL'ler

Tam desen listesi ve regex'in yakalayamadığı şeyler için manuel inceleme adımları için references/redaction_checklist.md bölümüne bakın.

SessionStart Otomatik Yükleme

Eklenti kurulduğunda, bir SessionStart kancası yapılandırılmış kaydetme konumunu, en son devir belgesi (bekletme penceresi içinde) için tarar ve bunu yeni oturuma <handoff_from_previous_session> verisi olarak ortaya çıkarır. Bir sonraki ajan bunu talimatlar olarak değil, bağlam olarak okur — önerilen eylemler yürütülmeden önce mevcut durum açısından doğrulanmalıdır.

Oturum başına /cs:handoff-setup --project ile devre dışı bırakın.

SessionEnd Anımsatıcısı

Eşleştirilmiş bir SessionEnd kancası, oturum sona erdiğinde yakın zamanda bir devir belgesinin var olup olmadığını kontrol eder. Hiçbiri yoksa (veya en yakın olanı 30 dakikadan eski ise), kullanıcı bağlam kaybolmadan önce bir tane yazması için istenir, böylece bir satırlık anımsatıcı yazdırılır.

Kanca etkileşimli olarak istemi yapamaz veya oturum sonunu engelleyemez — oturum günlüğünde metin yüzeyler.

Oturum başına HANDOFF_SESSIONSTART=0 ile devre dışı bırakın.

Mevcut Bir Devri Yenileme

İş orijinal devir zamanının ötesine geçtiğinde, yeni bir dosya oluşturmak yerine yerinde yenileyin:

python3 scripts/handoff_template_generator.py --refresh --goal "<güncellenmiş hedef>"

En yakın devirin yolunu yazdırır. Ajan bunu doğrudan düzenler. Kaydetme konumunu düzenli tutar ve SessionStart kancasının her zaman güncel sürümü yüklemesini sağlar.

Araçlar

Araç Amaç
setup.py İlk çalıştırma S&C — kaydetme konumu, bekletme, redaksiyon sıkılığı, git-bağlamı, tavsiye yelpazesi.
handoff_template_generator.py 5 bölümlü iskeleyi yapılandırılmış yolda yazar. --refresh yeni bir dosya oluşturmak yerine en yakın devri yeniden kullanır.
redaction_linter.py Taslağı kaydetmeden önce sırlar/PII açısından tarar. Katı modda bulgular üzerine çıkış 1.
handoff_self_check.py Sadakat kontrolü — boş Hedef, yapıt olmayan Durum maddeleri, git kirli olduğunda eksik Kararlar, çok az/çok Beceri, Yapıtlar içinde satır içi içeriği işaretler. Linter'dan önce çalıştırın.
skill_recommender.py Hedef metin + repo taramasına dayalı bir sonraki oturum için 3-5 beceri önerir.
cleanup.py Bekletme penceresinden daha eski iskelesi siler. mtime-korumalı — kullanıcının düzenlediği devri asla silmez.
config_loader.py Paylaşılan yardımcı: proje yapılandırmasını → genel yapılandırma → varsayılanları okuyun.

Slash Komutları

  • /cs:handoff [isteğe bağlı bir sonraki oturum açıklaması] — devir oluştur.
  • /cs:handoff-setup — kaydetme konumunu, bekletmeyi, redaksiyonu yeniden yapılandırın.

Ajan

cs-handoff-author — beceriyi koordine eden Matt-sesi kişiliği. Kısa, çoğaltmama, referanslar-kopya değil.

Örnekler

Örnek 1 — hedefli açık çağrı

Kullanıcı: /cs:handoff "redaksiyon linter'ı kullanıma hazırlamayı bitir ve taslak PR aç"

Beceri zorunlu kontrol listesinde yürür, 5 bölümlü iskele oluşturur, konuşmadan doldurur, redaksiyon linter'ı çalıştırır ve yapılandırılmış konuma kaydeder. Tam çalışılan örnek için assets/example_handoff.md bölümüne bakın.

Örnek 2 — örtük tetikleyici

Kullanıcı: Günü için paketliyorum, buna yarın döneyim.

Örtük sinyali algıla. Çalıştırmadan önce önerir: "Bir sonraki oturum için devir belgesi yazayım mı?" — asla sessizce. Onay üzerine Örnek 1 gibi devam edin ve çıkarsanmış bir hedef ile.

Örnek 3 — ilk çalıştırma kurulumu

Kullanıcı: /cs:handoff "göçü sevk et"
Beceri: Şimdi kurulum çalıştırmak ister misin? (E/h)
Kullanıcı: E
[kurulum 5 soruyu yürür: kaydetme konumu, bekletme, redaksiyon sıkılığı, git bağlamı, tavsiye yelpazesi]
Beceri: Yapılandırma ~/.config/handoff/config.json adresine kaydedildi. Devam ediliyor: göçü sevk et.

Kullanıcı h cevabı verirse, beceri bir sentinal yazar ve varsayılanları kullanır (OS geçici dir, 7 gün bekletme, katı redaksiyon). İstem asla yeniden görünmez.

Örnek 4 — SessionStart otomatik yükleme

Bir sonraki oturumda, SessionStart kancası yapılandırılmış kaydetme konumunu tarar, en yakın deviri bulur ve bunu <handoff_from_previous_session> verisi olarak yüzeye çıkarır. Bir sonraki ajan bunu talimatlar olarak değil, bağlam olarak okur.

Kullanım

Adım Komut
İlk çalıştırma kurulumu /cs:handoff-setup (veya ilk /cs:handoff'da E yanıtı verin)
Devir oluştur /cs:handoff [hedef]
Daha sonra yeniden yapılandır /cs:handoff-setup --reconfigure
Projeye özel yapılandırma /cs:handoff-setup --project
SessionStart kancasını devre dışı bırak HANDOFF_SESSIONSTART=0 (oturum başına)

Sürüm: 1.0.0 Esinlenen: Matt Pocock's handoff (MIT).

Benzer skill'ler

canvas-design Document

.png ve .pdf dosyalarında tasarım felsefesini kullanarak güzel görseller oluşturun. Poster, sanat eseri, tasarım veya diğer statik içerikler için bu özelliği kullanabilirsiniz. Telif hakkı ihlallerinden kaçınmak için her zaman orijinal tasarımlar yaratın, mevcut sanatçıların çalışmalarını kopya etmeyin.

anthropics/skills ★ 153,732
doc-coauthoring Document

Kullanıcıları belgelendirme konusunda işbirlikçi yazım için yapılandırılmış bir workflow içinde rehber etmek için kullanılır. Kullanıcı belgelendirme, teknik özellikler, karar dokümanları veya benzer yapılandırılmış içerik yazma istediğinde harekete geçer. Bu workflow, bağlamı verimli bir şekilde aktarmaya, içeriği yinelemelerle geliştirmeye ve dokümanın okuyucular için işe yaradığını doğrulamaya yardımcı olur.

anthropics/skills ★ 153,732
docx Document

Bu skill'i kullanıcı Word belgesi (.docx dosyası) oluşturmak, okumak, düzenlemek veya manipüle etmek istediğinde kullanın. İçindekiler tablosu, başlık, sayfa numarası veya mektup başlığı gibi formatlı profesyonel belge talepleri, "Word doc", "word document" veya ".docx" ifadeleri geçtiğinde tetiklenir. .docx dosyalarından içerik çıkarma veya yeniden düzenleme, görsel ekleme veya değiştirme işlemleri için de kullanılır.

anthropics/skills ★ 153,732
pdf Document

Kullanıcı PDF dosyaları ile herhangi bir işlem yapmak istediğinde bu skill'i kullanın. Buna PDF'lerden metin/tablo okuma ve çıkarma, birden fazla PDF'yi birleştirme, PDF'leri bölme, sayfaları döndürme, filigran ekleme, yeni PDF oluşturma, PDF formlarını doldurma, PDF şifreleme/şifre açma, görüntü çıkarma ve taranmış PDF'lerde OCR uygulaması dahildir. Kullanıcı bir .pdf dosyasından bahsettiğinde veya

anthropics/skills ★ 153,732
pptx Document

Bu skill'i .pptx dosyalarıyla çalışmanız gereken her durumda kullanın — giriş, çıkış veya her ikisi için de. Sunum oluşturma, slayt destesi hazırlama, metnini okuma ve çıkarma, düzenleme veya güncelleme, dosyaları birleştirme ve bölme gibi tüm işlemleri kapsar.

anthropics/skills ★ 153,732
theme-factory Document

Artifaktları tema ile stilize etmek için toolkit. Slaytlar, dokümanlar, raporlar, HTML landing page'ler gibi çeşitli artifaktlara uygulanabilir. 10 hazır tema ile renkler ve fontları seçebilir ya da anında yeni tema oluşturabilirsiniz.

anthropics/skills ★ 153,732
Daha fazla: Document →