Patricia

[!NOTE] Bu depo, bettergroupinc/patricia-monorepo adresinden plugins/patricia/ tarihinde oluşturulmuştur. Otomasyon bu genel aynayı senkronize eder. Kaynak commit: 147037702592109a4944cdbfb94bdcabb33f490f. Pull request'leri ve sorunları monorepo'da açın.

patricia Claude Code eklentisi

Bunu bir kez kurun; bir ajan, Patricia'nın MCP sunucusunu tekrar söylenmeden doğru şekilde kullanır.

Üç şey taşır.

1. Rehberlik. Beş beceri; Patricia temellerini, işe alımı, devredilen işleri, entegrasyonları ve bellek köprüsünü kapsar.
2. Bir MCP bağlantısı. Kurulum, OAuth oturum açma için Patricia'nın Streamable HTTP sunucusunu yapılandırır.
3. Beş yerel kanca. Projeleri işe alır, belleği hatırlar, önce entegrasyonları kontrol eder ve bellek gönderimleri önerir. Asla Patricia'ya yazmazlar.

Bu, dağıtılabilir bir Claude Code eklentisidir. Bir kişi onu kendi makinesine kurar ve o kişinin Claude Code oturumunda çalışır. Patricia'nın ürün beceri kataloğu değildir ve içindeki hiçbir şey Patricia içinde çalışmaz.

Kurulum

claude plugin marketplace add patricia-app/patricia-plugin
claude plugin install patricia@patricia

Ardından yeni bir oturum başlatın veya /reload-plugins komutunu çalıştırın.

Bu pazar yeri https://github.com/patricia-app/patricia-plugin.'dır. Otomasyon, içindeki her dosyayı Patricia'nın monoreposundan üretir.

Katkıda bulunan notu: monorepo özeldir. Erişimi olan bir katkıda bulunan, monoreponun kendisini bir pazar yeri olarak ekleyebilir, çünkü kök .claude-plugin/marketplace.json dosyası patricia eklentisini ./plugins/patricia adresine işaret eder.

Kurun. --plugin-dir ile yüklemeyin. Dizin yüklü bir eklenti, becerilerini alır ancak kancalarını almaz; bu nedenle rehberlik çalışır ve bellek köprüsü asla tetiklenmez. Bu varsayılmak yerine ölçülmüştür: --plugin-dir ile yüklenen bir prob kancası asla çalışmadı; aynı kanca proje ayarlarında bildirildiğinde aynı yazma işleminde aynı başsız modda çalıştı. Claude Code, bir eklentinin hooks/hooks.json öğesini yalnızca kurulu ve etkin bir eklenti için kaydeder.

claude plugin details patricia neyin yerleştiğini bildirir:

Component inventory
  Skills (5)  delegating-work, integrations, memory-bridge, onboard, using-patricia
  MCP servers (1)  patricia
  Hooks (5)  SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop

MCP sunucusunda oturum açın

Eklenti, MCP sunucusunu saklanmış bir başlık olmadan yapılandırır. İlk kullanımda /mcp komutunu çalıştırın ve Patricia'yı seçin. OAuth akışını bir terminalden de başlatabilirsiniz:

claude mcp login plugin:patricia:patricia

MCP OAuth oturum açma ve kancaların pat_mcp_ kişisel belirteci ayrı kimlik bilgileridir. OAuth tek başına belirtece bağlı kancaları etkinleştirmez.

OAuth uygun olmadığında alternatif olarak bir belirteç kullanın:

claude mcp add --transport http patricia https://api.patricia.app/v1/mcp \
  --header "Authorization: Bearer $PATRICIA_MCP_TOKEN"

Bir pat_mcp_ kişisel belirteci, sorumlu kişiyi adlandırır ve yazabilir. Bir pat_live_ kiracı API anahtarı kimseyi adlandırmaz, bu nedenle yalnızca okur ve list_skills veya list_integrations yanıtlayamaz.

Yerel kancalara kişisel bir belirteç verin

Yerel kancalar için python3 komutu aracılığıyla Python 3 kullanılabilir olmalıdır.

Patricia'da Ayarlar > Geliştirici > Kişisel anahtarlar altında bir pat_mcp_ kişisel anahtarı oluşturun. Ardından bir kurulum seçin:

export PATRICIA_MCP_TOKEN="pat_mcp_..."

Veya bu dosyayı ~/.claude/patricia.json konumuna yazın:

{
  "token": "pat_mcp_..."
}

PATRICIA_MCP_TOKEN dosyaya göre önceliklidir. Boş bir PATRICIA_MCP_TOKEN dosya geri dönüşünü devre dışı bırakır. Bu davranış bilinçlidir. Bir kişinin, dosyayı taşımadan kimliği doğrulanmış kancaları askıya almasına olanak tanır.

Yerel kancalar

Beş kancanın tümü varsayılan olarak açıktır. Eksik bir yapılandırma dosyası veya eksik bir kanca anahtarı onları açık bırakır. Bozuk veya okunamayan bir yapılandırma onları kapatır. Bir kancanın listelenen anahtarını ~/.claude/patricia-plugin.json içinde false değişmez değerine ayarlayarak yalnızca o kancayı kapatın.

İşe alım

• Ne zaman ve eylem: SessionStart, yeni veya devam eden bir oturum için çalışır. Bağlı kişiyi selamlar ve proje başına bir kez işe alım becerisini sunar.
• Maliyet: Bir belirteçle bir whoami çağrısı yapar. Ağ zaman aşımı 3 saniyedir ve kanca zaman aşımı 10 saniyedir.
• Kapatma anahtarı: hooks.onboarding.enabled değeri false olarak ayarlanır.
• Gizlilik: Bir belirteçle yalnızca kimliği doğrulanmış whoami isteği makineden çıkar. Bu kanca aracılığıyla hiçbir istem, döküm veya proje içeriği çıkmaz.

Hatırlama

• Ne zaman ve eylem: UserPromptSubmit, gönderilen her istemden önce çalışır. Komutları, kısa yanıtları, onayları ve yalnızca kod içeren girdileri atlar. Uygun istemlere ilgili belleği ekler.
• Maliyet: Bir belirteç ve uygun bir istemle bir search_memory çağrısı yapar. Ağ zaman aşımı 3 saniyedir ve kanca zaman aşımı 8 saniyedir.
• Kapatma anahtarı: hooks.recall.enabled değeri false olarak ayarlanır.
• Gizlilik: Daraltılmış istemin en fazla 300 karakterini Patricia'ya gönderir. Bu metni yalnızca bir belirteç yapılandırıldığında gönderir.

Önce entegrasyonlar

• Ne zaman ve eylem: UserPromptSubmit bir istemi kontrol eder. PreToolUse, araç çalışmadan önce WebFetch, WebSearch ve Bash girdisini kontrol eder. Yerel bir katalog bilinen sağlayıcıları tanımlar.
• Maliyet: MCP veya ağ çağrısı yapmaz ve belirteç gerektirmez. Kanca zaman aşımı bir istem için 8 saniye ve bir araç çağrısından önce 5 saniyedir.
• Kapatma anahtarı: hooks.integrations_first.enabled değeri false olarak ayarlanır.
• Gizlilik: Makineden hiçbir şey çıkmaz. Kanca, istemi veya araç girdisini yerel olarak kontrol eder.

Bellek köprüsü

• Ne zaman ve eylem: PostToolUse, Write, Edit veya MultiEdit sonrasında çalışır. Kaydedilmiş bir yerel bellek notunu fark eder ve açık bir kapsamla remember önerir.
• Maliyet: MCP veya ağ çağrısı yapmaz. Kanca zaman aşımı 5 saniyedir.
• Kapatma anahtarı: hooks.memory_bridge.enabled değeri false olarak ayarlanır. Eski ~/.claude/patricia-memory-bridge.json dosyası da enabled değerini false olarak ayarlayabilir.
• Gizlilik: Betik, kaydedilmiş notu yerel olarak okur ve ağ üzerinden hiçbir şey göndermez. Not yolunu ve hatırlatma metnini, not içeriği olmadan Claude Code'a döndürür.

Gönderim hatırlatıcısı

• Ne zaman ve eylem: Stop, ajan işini bitirdiğinde çalışır. Yerel bir bellek yazımından veya Patricia'ya bellek yazımı olmayan kapsamlı bir araç kullanan oturumdan sonra remember önerir.
• Maliyet: MCP veya ağ çağrısı yapmaz. Kanca zaman aşımı 8 saniyedir.
• Kapatma anahtarı: hooks.push_reminder.enabled değeri false olarak ayarlanır.
• Gizlilik: Yerel dökümün en fazla 5 MB'ını okur ve hiçbir şey göndermez. Yalnızca bir belirteç yapılandırıldığında çalışır; böylece önerilen bellek çağrısı, kişi kabul ettikten sonra başarılı olabilir.

Ağ ve kimlik bilgileri

Bu eklenti, Streamable HTTP üzerinden https://api.patricia.app/v1/mcp adresine bağlanır.

Patricia, PKCE S256 ile OAuth 2.1 kullanır. Tamamlanan bir OAuth akışı, istemciye kişisel bir pat_mcp_ taşıyıcı belirteci verir.

Eklenti bildirimi hiçbir kimlik bilgisi içermez. İstemci, oturum açtıktan sonra taşıyıcı belirteci api.patricia.app adresine gönderir.

Diğer pazaryerleri

• Cursor, bu paketten plugin.json ve mcp.json okur.
• OpenAI Codex ve ChatGPT, .codex-plugin/plugin.json okur.
• Uzak kaynaklı bir giriş bildirim gerektirmez. xAI, mevcut olduğunda .claude-plugin/plugin.json okur.

Tüm pazaryeri paketleri, bu paketteki tek skills/ ağacına işaret eder.

assets/icon.png, birinci taraf Patricia marka varlığıdır.

Bellek köprüsü önerir; asla yazmaz

Bir kanca bir kabuk komutudur. MCP istemcisi tutmaz, kimseden onay almaz ve bir notu okuyup ekip gerçeğini özel olandan ayırt edemez. Her yerel notu paylaşılan bir çalışma alanına gönderen bir kanca, makineye özgü, geçici ve özel notları sessizce tüm ekibin önüne koyar. Bu, köprünün kaçınmak için inşa edildiği başarısızlık modudur; ertelediği bir özellik değil.

Bu nedenle kanca tek bir şey yapar: ajana notun yalnızca yerel olduğunu ve remember için bir scope gerektiğini söyleyen hookSpecificOutput.additionalContext enjekte eder. Ajan kapsamı belirler, kişisine sorar ve çağrıyı yapar. Yargı ve yazma aynı yerde kalır.

Dört kapı onu sessiz tutar:

Kapı	Etki
Desteklenen yapılandırmalardan herhangi biri köprünün enabled değerini false olarak ayarlar	Sessiz. Bu değer olmadan köprü açıktır.
Yazılan yol bir bellek dizininin dışındadır	Sessiz.
Yazma gerçekleşmedi veya dosya boş	Sessiz.
Notun ön maddesi patricia: skip taşır	Sessiz.

Ayrıca belirli bir notu oturum başına en fazla bir kez sunar; böylece bir Write ardından bir dizi Edit çağrısı dört yerine bir hatırlatma üretir. Bu kayıt, oturum başına bir dosya olarak ~/.claude/patricia-memory-bridge-state/ içinde yaşar ve yedi gün sonra budanır.

Bunun için CLAUDE_PLUGIN_DATA kullanmaz. Bu değişken bir kancanın ortamında bulunur, ancak güvenilir şekilde çalışan eklentinin kendi dizini değildir: bu makinedeki bir proje düzeyi kancası, onun ilgisiz bir eklentinin veri dizini olan ~/.claude/plugins/data/codex-openai-codex olarak ayarlandığını gördü.

Bir bellek yazımının gerçekte hangi aracı kullandığı

Claude Code 2.1.238, memory_list, memory_read ve memory_write adlı araçları bildirir. Bunun üzerine inşa edildiği makinelerde bellek notları bunlarla yazılmaz: en son 120 oturum dökümünün taraması, ~/.claude/projects/*/memory/ içine 49 Write ve 35 Edit çağrısı buldu ve sıfır memory_write çağrısı buldu.

Bu nedenle eşleştirici Write|Edit|MultiEdit'dır. memory_write bilinçli olarak dışarıda bırakılmıştır. Yük şekli doğrulanmamış bir araç için eşleştirici eklemek, sessizce asla tetiklenmeyen ve çalışan bir kanca gibi görünen bir kanca satın alır. Gerçek bir memory_write yükü okunduğunda ekleyin.

Rehberlik ve sunucunun kalıcı kuralı iki kopya değil, tek kopyadır

start_onboarding_import, ask_first, instruction ve başka birinin CLAUDE.md sığacak boyutta bir markdown bloğu taşıyan bir standing_rule_to_offer döndürebilir. Beceri bu bloğu yeniden ifade etmez. Ajana aracı çağırmasını ve geleni kullanmasını söyler; böylece sunucu bu ifadenin tek sahibi kalır.

Kurulum sırasında getirmek alternatifti ve çalışmıyor. Bir eklentinin SKILL.md içerik adresli bir önbellekte statik metindir, onu yeniden yazabilecek kurulum zamanı adımı yoktur ve işi Patricia'yı kurmayı içeren bir eklenti, kendi talimatlarını işlemek için çalışan kimliği doğrulanmış bir Patricia bağlantısına bağımlı olamaz. Aracı kullanım sırasında okumak, bunların hiçbiri olmadan aynı tek kopyayı verir.

Buradaki her araç adı gerçek bir araçtır

Bu eklentideki her geri tırnaklı araç tanımlayıcısı, sunucunun tools/list ile oluşturduğu kendi araç kayıt defterine karşı tutulur. Aynı kontrol, boş olmayan bir tanımlayıcı kümesi bulduğunu da doğrular; böylece bozuk bir çıkarıcı hiçbir şey bulamayarak geçemez.

Katkıda bulunan notu: bu kontrol, Patricia'nın monoreposunda backend/api/tests/test_patricia_claude_plugin.py'dır ve bu eklentideki her değişiklikte çalışır.

Ayarlar ve dosya keşfi

Araç	Kullanım
get_settings	Ayarları listeleyin veya anlamları, değerleri ve izinleriyle seçili anahtarları veya grupları okuyun. Her iki kimlik bilgisi de çalışma alanı gruplarını okuyabilir.
update_settings	Pano işlemi aracılığıyla izin verilen bir grubu değiştirin. Kişisel bir belirteç gereklidir.
list_files	Dosyaları listeleyin. İlk sayfa klasörleri ve görünürlük filtrelenmiş sayıları içerir.
get_brand_kit	Marka renklerini, tipografiyi ve logoları okuyun.

Şirket profili için get_settings(keys=["company_profile"]) kullanın. Ayarlar araçları, Patricia'nın sohbette kullandığı kataloğu ve işlemleri paylaşır. Sohbet ayarları değişiklikleri, istekte bulunan kişiden bir tıklama gerektirir. Bir onay politikası değişikliği konsol çalıştırmalarını etkiler; kritik ve sağlayıcı gerektiren eylemler onay tabanlarını korur ve hedef kitle ve tıklama yalnızca tabanları, Patricia'nın zaten sorduğu herhangi bir eylemde kendi tabanlarını korur.

Entegrasyon okumaları, aynı kişi için başka bir görev çalışırken bekler. Bu görevi get_task_status ile yoklayın veya bitmesini bekleyin. Doğrudan bir entegrasyon onayından sonra, decide_approval tarafından döndürülen next cümlesini izleyin. Aynı tool_ref ve bağımsız değişkenlerle tekrar çağrılacak aracı adlandırır.