• Kullanıcı Profili: Arka planınızı, uzmanlıklarınızı, ilgi alanlarınızı ve iletişim tercihlerinizi tanımlar
• AI Profili: AI’nın rol konumunu, iletişim tarzını ve etkileşim şeklini özelleştirir

📝 Akıllı Not Arama

• Markdown notlarınızı otomatik olarak indeksler
• Diyalog içeriğine göre ilgili geçmiş kayıtları akıllıca arar
• Sohbet sırasında önceki fikirlerinizi ve notlarınızı doğal olarak alıntılar

💬 Kişiselleştirilmiş Sohbet

• Profiliniz ve notlarınız temelinde kişiselleştirilmiş yanıtlar üretir
• Sohbetin bağlam bütünlüğünü korur
• Fikirlerinizi bir arkadaş gibi doğal bir şekilde alıntılar, mekanik “kayda göre” yaklaşımı yerine

Kullanım Senaryoları

Şu durumlarda ihtiyacınız olduğunda:

• Kişiselleştirilmiş iletişim, genel cevaplar yerine
• Bağlamı algılayan yanıtlar, AI arka planınızı hatırlayabilir
• AI önceki fikirlerinizi ve notlarınızı hatırlayıp alıntılayabilir
• Her seferinde sıfırdan başlamak yerine devamlı bir sohbet deneyimi

Kurulum ve Kullanım

Yetenek Kurulumu

Bu projeyi çalışma dizininizdeki .claude/skills/ klasörüne kopyalayın:

<你的项目根目录>/
└── .claude/
    └── skills/
        └── ai-partner-chat/    # 本技能包
            ├── assets/
            ├── scripts/
            ├── SKILL.md
            └── README.md

Beceri Kullanımı

Claude Code'da aşağıdaki komutu göndererek bu beceriyi etkinleştirebilirsiniz:

遵循 ai-partner-chat 对话

AI ajanı otomatik olarak şunları yapar:

• Yetenek yapılandırmasını ve yönergeleri okur
• Gerekli dizin yapısını oluşturur (notes/, config/, vector_db/ vb.)
• İhtiyacınıza göre başlatma işlemini gerçekleştirir

Başlatma Süreci

#### Yöntem 1: AI'nın otomatik oluşturup yapılandırmasına izin verin

İlk kullanımda doğrudan AI'ya şunu söyleyin:

我刚刚在 notes 里放入了对应的笔记，请根据笔记内容，进行向量化；并基于笔记内容，推测并更新 user-persona.md，以及最适合我的 ai-persona.md

AI ajanı şunları yapar:

• notes/ dizinindeki not içeriklerini analiz eder
• Not formatına göre akıllıca bölümlendirir ve vektör veritabanı oluşturur
• Notlara dayanarak senin geçmişini ve tercihlerini tahmin eder
• Otomatik olarak config/user-persona.md dosyasını oluşturur ve günceller
• Senin özelliklerine göre öneride bulunur ve config/ai-persona.md dosyasını oluşturur

Eğer profilini kendin tanımlamak istersen:

• AI ajanı şablondan otomatik olarak profil dosyalarını config/ dizinine oluşturur
• Bu dosyaları elle düzenleyerek profilini özelleştirebilirsin
• Sonrasında AI’ya vektörleştirme işlemi yapmasını söyleyebilirsin

Sohbete başlama

Yapılandırma tamamlandıktan sonra, her kullanımda sadece şunu göndermen yeterlidir:

遵循 ai-partner-chat 对话

• Profilini okuyarak geçmişini anlayacak
• İlgili geçmiş notları arayacak
• Kişiselleştirilmiş, bağlama duyarlı yanıtlar oluşturacak

Proje Yapısı

Yetenek Paketi Yapısı (.claude/skills/ai-partner-chat/ içinde yer alır)

ai-partner-chat/
├── assets/              # 画像模板
│   ├── user-persona-template.md
│   └── ai-persona-template.md
├── scripts/             # 核心脚本
│   ├── chunk_schema.py
│   ├── vector_indexer.py
│   ├── vector_utils.py
│   └── requirements.txt
├── SKILL.md            # 技能详细文档（AI agent 会读取此文件）
└── README.md           # 本文件

Kullanıcı veri dizini (proje kök dizininde bulunur)

AI agent, proje kök dizininde aşağıdaki yapıyı oluşturacaktır:

<项目根目录>/
├── notes/              # 你的笔记（由你或 AI agent 创建）
├── config/             # 画像配置（由 AI agent 创建）
│   ├── user-persona.md
│   └── ai-persona.md
├── vector_db/          # 向量数据库（由 AI agent 创建）
└── venv/               # Python 虚拟环境（由 AI agent 创建）

Önemli: Kullanıcı verileri ile yetenek paketleri ayrıdır, bu da yedekleme ve taşımayı kolaylaştırır.

İş Akışı

• Profil Yükleme: Kullanıcı ve AI profillerini okuyarak etkileşim arka planını anlama
• Notları Arama: Kullanıcı sorgusuna göre, vektör veritabanından en ilgili notları bulma
• Bağlam Oluşturma: Profil bilgileri, ilgili notlar ve diyalog geçmişini birleştirme
• Yanıt Oluşturma: Bağlam temelinde kişiselleştirilmiş ve doğal yanıtlar üretme

Öne Çıkan Özellikler

🤖 AI Agent Akıllı Parçalama

🎯 Doğal Alıntı

📦 Veri Bağımsızlığı

En İyi Uygulamalar

Profil Tasarımı

• Açık ve Net: Belirsiz profil genel yanıtlar alınmasına sebep olur
• Örnek İçerikli: AI profilinde beklenen etkileşim tarzını örneklerle gösterin
• Düzenli Güncelleme: Diyalog kalitesine göre profili sürekli iyileştirin

Not Yönetimi

• Serbest Format: Sistem her türlü not yapısına uyum sağlar
• Zengin İçerik: Derinlemesine notlar daha iyi arama sonuçları getirir
• Zamanında Güncelleme: Yeni notları indekse eklemeyi unutmayın

Diyalog Deneyimi

• Doğal Alıntı: Notları yalnızca gerçekten ilgili olduğunda alıntılayın
• Akıcı Kalın: Alıntılar diyalogun doğal akışını bozmasın
• Kaliteye Odaklanın: Bağlantı sayısından çok anlamlı bağlantıları tercih edin

Bakım ve Güncelleme

Yeni Not Ekleme

我刚刚在 notes 里添加了新笔记，请更新向量数据库

AI ajanı yeni notları otomatik olarak analiz eder ve dizini günceller.

Profil Güncelleme

请根据我最近的笔记内容，更新 user-persona.md 和 ai-persona.md

Dizinleri Yeniden Oluşturma

请重新初始化向量数据库

AI agent tüm notları yeniden analiz edecek ve dizini yeniden oluşturacaktır.

Dikkat Edilmesi Gerekenler

• İlk Çalıştırma: AI agent, vektör veritabanını ilk kez oluştururken gömme modelini (yaklaşık 4.3GB) otomatik olarak indirecek, lütfen sabırlı olun
• Python Ortamı: AI agent gerekli bağımlılıkları yükleyerek otomatik olarak sanal ortam oluşturacaktır
• Veri Depolama: Tüm veriler (notlar, profiller, vektör veritabanı) proje kök dizininde saklanır, yetenek paketi dizininde değil
• Yetenek Konumu: Yetenek paketinin .claude/skills/ai-partner-chat/ dizininde olduğundan emin olun

Daha Fazla Bilgi

Detaylı teknik dokümantasyon ve kullanım kılavuzu için SKILL.md dosyasına bakınız.

AI'nın sadece bir araç değil, sizi gerçekten anlayan bir sohbet ortağı olmasını sağlayın.