AGENT SKILL

continuous-learning-v2

Hook'lar aracılığıyla oturumları gözlemleyen, güven skorlaması ile atomik instinct'ler oluşturan ve bunları skill/command/agent'lara evriltiren instinct tabanlı öğrenme sistemi. v2.1 çapraz proje kontaminasyonunu önlemek için proje kapsamlı instinct'ler ekler.

License 许可
MIT
最近更新
2026-11-10
Stars
★ 1
Forks
0

01 前言 Front Matter

name
continuous-learning-v2
origin
ECC
version
2.1.0
description
Hook'lar aracılığıyla oturumları gözlemleyen, güven skorlaması ile atomik instinct'ler oluşturan ve bunları skill/command/agent'lara evriltiren instinct tabanlı öğrenme sistemi. v2.1 çapraz proje kontaminasyonunu önlemek için proje kapsamlı instinct'ler ekler.

03 SKILL.md 正文

Sürekli Öğrenme v2.1 - Instinct Tabanlı Mimari

Claude Code oturumlarınızı güven skorlaması ile atomik "instinct'ler" - küçük öğrenilmiş davranışlar - aracılığıyla yeniden kullanılabilir bilgiye dönüştüren gelişmiş bir öğrenme sistemi.

v2.1 proje kapsamlı instinct'ler ekler — React kalıpları React projenizde kalır, Python kuralları Python projenizde kalır ve evrensel kalıplar (örneğin "her zaman input'u doğrula") global olarak paylaşılır.

Ne Zaman Aktifleştirmelisiniz

  • Claude Code oturumlarından otomatik öğrenme ayarlarken
  • Hook'lar aracılığıyla instinct tabanlı davranış çıkarmayı yapılandırırken
  • Öğrenilmiş davranışlar için güven eşiklerini ayarlarken
  • Instinct kütüphanelerini incelerken, dışa veya içe aktarırken
  • Instinct'leri tam skill'lere, command'lara veya agent'lara evriltirken
  • Proje kapsamlı vs global instinct'leri yönetirken
  • Instinct'leri projeden global kapsamına yükseltirken

v2.1'deki Yenilikler

Özellik v2.0 v2.1
Depolama Global (~/.claude/homunculus/) Proje kapsamlı (projects/<hash>/)
Kapsam Tüm instinct'ler her yerde geçerli Proje kapsamlı + global
Tespit Yok git remote URL / repo path
Yükseltme Yok Proje → 2+ projede görülünce global
Komutlar 4 (status/evolve/export/import) 6 (+promote/projects)
Çapraz proje Kontaminasyon riski Varsayılan olarak izole

v2'deki Yenilikler (vs v1)

Özellik v1 v2
Gözlem Stop hook (oturum sonu) PreToolUse/PostToolUse (%100 güvenilir)
Analiz Ana bağlam Arka plan agent'ı (Haiku)
Granülerlik Tam skill'ler Atomik "instinct'ler"
Güven Yok 0.3-0.9 ağırlıklı
Evrim Doğrudan skill'e Instinct'ler -> kümeleme -> skill/command/agent
Paylaşım Yok Instinct'leri dışa/içe aktar

Instinct Modeli

Instinct küçük öğrenilmiş bir davranıştır:

---
id: prefer-functional-style
trigger: "yeni fonksiyonlar yazarken"
confidence: 0.7
domain: "code-style"
source: "session-observation"
scope: project
project_id: "a1b2c3d4e5f6"
project_name: "my-react-app"
---

# Fonksiyonel Stili Tercih Et

## Aksiyon
Uygun olduğunda sınıflar yerine fonksiyonel kalıpları kullan.

## Kanıt
- 5 fonksiyonel kalıp tercihinin gözlemlenmesi
- Kullanıcı 2025-01-15'te sınıf tabanlı yaklaşımı fonksiyonele düzeltti

Özellikler:

  • Atomik -- bir tetikleyici, bir aksiyon
  • Güven ağırlıklı -- 0.3 = geçici, 0.9 = neredeyse kesin
  • Alan etiketli -- code-style, testing, git, debugging, workflow, vb.
  • Kanıt destekli -- hangi gözlemlerin oluşturduğunu takip eder
  • Kapsam farkında -- project (varsayılan) veya global

Nasıl Çalışır

Oturum Aktivitesi (bir git repo'sunda)
      |
      | Hook'lar prompt'ları + tool kullanımını yakalar (%100 güvenilir)
      | + proje bağlamını tespit eder (git remote / repo path)
      v
+---------------------------------------------+
|  projects/<project-hash>/observations.jsonl  |
|   (prompt'lar, tool çağrıları, sonuçlar, proje)   |
+---------------------------------------------+
      |
      | Gözlemci agent okur (arka plan, Haiku)
      v
+---------------------------------------------+
|          KALIP TESPİTİ                      |
|   * Kullanıcı düzeltmeleri -> instinct      |
|   * Hata çözümleri -> instinct              |
|   * Tekrarlanan iş akışları -> instinct     |
|   * Kapsam kararı: project mi global mi?   |
+---------------------------------------------+
      |
      | Oluşturur/günceller
      v
+---------------------------------------------+
|  projects/<project-hash>/instincts/personal/ |
|   * prefer-functional.yaml (0.7) [project]   |
|   * use-react-hooks.yaml (0.9) [project]     |
+---------------------------------------------+
|  instincts/personal/  (GLOBAL)               |
|   * always-validate-input.yaml (0.85) [global]|
|   * grep-before-edit.yaml (0.6) [global]     |
+---------------------------------------------+
      |
      | /evolve kümeleme + /promote
      v
+---------------------------------------------+
|  projects/<hash>/evolved/ (proje kapsamlı)   |
|  evolved/ (global)                           |
|   * commands/new-feature.md                  |
|   * skills/testing-workflow.md               |
|   * agents/refactor-specialist.md            |
+---------------------------------------------+

Proje Tespiti

Sistem mevcut projenizi otomatik olarak tespit eder:

  1. CLAUDE_PROJECT_DIR env var (en yüksek öncelik)
  2. git remote get-url origin -- taşınabilir proje ID'si oluşturmak için hash'lenir (farklı makinelerde aynı repo aynı ID'yi alır)
  3. git rev-parse --show-toplevel -- repo path kullanan yedek (makineye özgü)
  4. Global yedek -- proje tespit edilemezse, instinct'ler global kapsamına gider

Her proje 12 karakterlik bir hash ID alır (örn. a1b2c3d4e5f6). ~/.claude/homunculus/projects.json dosyasındaki kayıt dosyası ID'leri insanların okuyabileceği isimlerle eşler.

Hızlı Başlangıç

1. Gözlem Hook'larını Aktifleştirin

~/.claude/settings.json dosyanıza ekleyin.

Plugin olarak kuruluysa (önerilen):

~/.claude/settings.json içine ek hook bloğu eklemeyin. Claude Code v2.1+ eklentinin hooks/hooks.json dosyasını otomatik yükler; observe.sh zaten orada kayıtlıdır.

Daha önce observe.sh satırlarını ~/.claude/settings.json içine kopyaladıysanız, yinelenen PreToolUse / PostToolUse bloğunu kaldırın. Yinelenen kayıt hem çift çalıştırmaya yol açar hem de ${CLAUDE_PLUGIN_ROOT} çözümleme hatası üretir; bu değişken yalnızca eklentiye ait hooks/hooks.json girdilerinde genişletilir.

~/.claude/skills dizinine manuel kuruluysa, aşağıdakini ~/.claude/settings.json içine ekleyin:

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/skills/continuous-learning-v2/hooks/observe.sh"
      }]
    }],
    "PostToolUse": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/skills/continuous-learning-v2/hooks/observe.sh"
      }]
    }]
  }
}

2. Dizin Yapısını Başlatın

Sistem ilk kullanımda dizinleri otomatik oluşturur, ancak manuel olarak da oluşturabilirsiniz:

# Global dizinler
mkdir -p ~/.claude/homunculus/{instincts/{personal,inherited},evolved/{agents,skills,commands},projects}

# Proje dizinleri hook bir git repo'sunda ilk çalıştığında otomatik oluşturulur

3. Instinct Komutlarını Kullanın

/instinct-status     # Öğrenilmiş instinct'leri göster (proje + global)
/evolve              # İlgili instinct'leri skill/command'lara kümele
/instinct-export     # Instinct'leri dosyaya aktar
/instinct-import     # Başkalarından instinct'leri içe aktar
/promote             # Proje instinct'lerini global kapsamına yükselt
/projects            # Tüm bilinen projeleri ve instinct sayılarını listele

Komutlar

Komut Açıklama
/instinct-status Tüm instinct'leri göster (proje kapsamlı + global) güvenle
/evolve İlgili instinct'leri skill/command'lara kümele, yükseltme öner
/instinct-export Instinct'leri dışa aktar (kapsam/alana göre filtrelenebilir)
/instinct-import <file> Kapsam kontrolü ile instinct'leri içe aktar
/promote [id] Proje instinct'lerini global kapsamına yükselt
/projects Tüm bilinen projeleri ve instinct sayılarını listele

Konfigürasyon

Arka plan gözlemcisini kontrol etmek için config.json dosyasını düzenleyin:

{
  "version": "2.1",
  "observer": {
    "enabled": false,
    "run_interval_minutes": 5,
    "min_observations_to_analyze": 20
  }
}
Anahtar Varsayılan Açıklama
observer.enabled false Arka plan gözlemci agent'ını aktifleştir
observer.run_interval_minutes 5 Gözlemcinin gözlemleri ne sıklıkla analiz ettiği
observer.min_observations_to_analyze 20 Analiz çalışmadan önce minimum gözlem

Diğer davranışlar (gözlem yakalama, instinct eşikleri, proje kapsamı, yükseltme kriterleri) instinct-cli.py ve observe.sh içindeki kod varsayılanları aracılığıyla yapılandırılır.

Dosya Yapısı

~/.claude/homunculus/
+-- identity.json           # Profiliniz, teknik seviye
+-- projects.json           # Kayıt: proje hash -> isim/path/remote
+-- observations.jsonl      # Global gözlemler (yedek)
+-- instincts/
|   +-- personal/           # Global otomatik öğrenilmiş instinct'ler
|   +-- inherited/          # Global içe aktarılan instinct'ler
+-- evolved/
|   +-- agents/             # Global oluşturulan agent'lar
|   +-- skills/             # Global oluşturulan skill'ler
|   +-- commands/           # Global oluşturulan komutlar
+-- projects/
    +-- a1b2c3d4e5f6/       # Proje hash (git remote URL'den)
    |   +-- project.json    # Proje başına metadata yansıması (id/name/root/remote)
    |   +-- observations.jsonl
    |   +-- observations.archive/
    |   +-- instincts/
    |   |   +-- personal/   # Projeye özgü otomatik öğrenilmiş
    |   |   +-- inherited/  # Projeye özgü içe aktarılan
    |   +-- evolved/
    |       +-- skills/
    |       +-- commands/
    |       +-- agents/
    +-- f6e5d4c3b2a1/       # Başka bir proje
        +-- ...

Kapsam Karar Kılavuzu

Kalıp Tipi Kapsam Örnekler
Dil/framework kuralları project "React hook'ları kullan", "Django REST kalıplarını takip et"
Dosya yapısı tercihleri project "Testler __tests__/ içinde", "Bileşenler src/components/ içinde"
Kod stili project "Fonksiyonel stil kullan", "Dataclass'ları tercih et"
Hata işleme stratejileri project "Hatalar için Result tipi kullan"
Güvenlik uygulamaları global "Kullanıcı input'unu doğrula", "SQL'i sanitize et"
Genel en iyi uygulamalar global "Önce testleri yaz", "Her zaman hataları işle"
Tool iş akışı tercihleri global "Edit'ten önce Grep", "Write'tan önce Read"
Git uygulamaları global "Conventional commit'ler", "Küçük odaklı commit'ler"

Instinct Yükseltme (Project -> Global)

Aynı instinct birden fazla projede yüksek güvenle göründüğünde, global kapsamına yükseltme adayıdır.

Otomatik yükseltme kriterleri:

  • 2+ projede aynı instinct ID
  • Ortalama güven >= 0.8

Nasıl yükseltilir:

# Belirli bir instinct'i yükselt
python3 instinct-cli.py promote prefer-explicit-errors

# Tüm uygun instinct'leri otomatik yükselt
python3 instinct-cli.py promote

# Değişiklik yapmadan önizle
python3 instinct-cli.py promote --dry-run

/evolve komutu ayrıca yükseltme adaylarını önerir.

Güven Skorlaması

Güven zamanla evrimleşir:

Skor Anlamı Davranış
0.3 Geçici Önerilir ama zorunlu değil
0.5 Orta İlgili olduğunda uygulanır
0.7 Güçlü Uygulama için otomatik onaylanır
0.9 Neredeyse kesin Temel davranış

Güven artar şu durumlarda:

  • Kalıp tekrar tekrar gözlemlenir
  • Kullanıcı önerilen davranışı düzeltmez
  • Diğer kaynaklardan benzer instinct'ler hemfikirdir

Güven azalır şu durumlarda:

  • Kullanıcı davranışı açıkça düzeltir
  • Kalıp uzun süre gözlemlenmez
  • Çelişkili kanıt ortaya çıkar

Neden Gözlem için Skill'ler Yerine Hook'lar?

"v1 gözlem için skill'lere güveniyordu. Skill'ler olasılıksaldır -- Claude'un yargısına göre zamanın ~%50-80'inde tetiklenirler."

Hook'lar %100 deterministik olarak tetiklenir. Bu şu anlama gelir:

  • Her tool çağrısı gözlemlenir
  • Hiçbir kalıp kaçırılmaz
  • Öğrenme kapsamlıdır

Geriye Dönük Uyumluluk

v2.1, v2.0 ve v1 ile tamamen uyumludur:

  • ~/.claude/homunculus/instincts/ içindeki mevcut global instinct'ler hala global instinct olarak çalışır
  • v1'den ~/.claude/skills/learned/ skill'leri hala çalışır
  • Stop hook hala çalışır (ama şimdi v2'ye de beslenir)
  • Kademeli geçiş: her ikisini de paralel çalıştırın

Gizlilik

  • Gözlemler makinenizde yerel kalır
  • Proje kapsamlı instinct'ler proje başına izoledir
  • Sadece instinct'ler (kalıplar) dışa aktarılabilir — ham gözlemler değil
  • Gerçek kod veya konuşma içeriği paylaşılmaz
  • Neyin dışa aktarılacağını ve yükseltileceğini siz kontrol edersiniz

İlgili

  • ECC-Tools GitHub App - Repo geçmişinden instinct'ler oluştur
  • Homunculus - v2 instinct tabanlı mimariye ilham veren topluluk projesi (atomik gözlemler, güven skorlaması, instinct evrim hattı)
  • The Longform Guide - Sürekli öğrenme bölümü

Instinct tabanlı öğrenme: Claude'a kalıplarınızı öğretmek, her seferinde bir proje.

04 同仓库更多 Skills

YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

vercel-sandbox

Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include "Vercel Sandbox browser", "microVM Chrome", "agent-browser in sandbox", "browser automation on Vercel", or any task requiring Chrome in a Vercel Sandbox.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

slack

Interact with Slack workspaces using browser automation. Use when the user needs to check unread channels, navigate Slack, send messages, extract data, find information, search conversations, or automate any Slack task. Triggers include "check my Slack", "what channels have unreads", "send a message to", "search Slack for", "extract from Slack", "find who said", or any task requiring programmatic Slack interaction.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

electron

Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include "automate Slack app", "control VS Code", "interact with Discord app", "test this Electron app", "connect to desktop app", or any task requiring automation of a native Electron application.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

dogfood

Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to "dogfood", "QA", "exploratory test", "find issues", "bug hunt", "test this app/site/platform", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

shadcn

Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI, including chat interfaces. Provides project context, component docs, and usage examples. Applies when working with shadcn/ui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for "shadcn init", "create an app with --preset", "switch to --preset", and for building a design system or applying a DESIGN.md or brand spec to shadcn/ui.

★ 1