initializare
This commit is contained in:
205
.claude/README.md
Normal file
205
.claude/README.md
Normal file
@@ -0,0 +1,205 @@
|
||||
# Nova - Personal AI Infrastructure Demo
|
||||
|
||||
## Prezentare
|
||||
|
||||
Acesta este un sistem demonstrativ de **Personal AI Infrastructure (PAI)** bazat pe principiile lui Daniel Miessler și conceptul de **Agent Skills** de la Anthropic.
|
||||
|
||||
## Versiune
|
||||
|
||||
**v1.0 Demo** - Ianuarie 2025
|
||||
|
||||
## Concepte Fundamentale
|
||||
|
||||
### Progressive Disclosure
|
||||
Sistemul încarcă doar contextul necesar pentru task-ul curent, nu tot contextul dintr-o dată. Acest lucru:
|
||||
- Reduce consumul de tokeni
|
||||
- Îmbunătățește performanța
|
||||
- Permite scalabilitate
|
||||
|
||||
### Skills Modulare
|
||||
Capabilități specializate, auto-documentate, compozabile:
|
||||
- `web-research` - Cercetare web profesională
|
||||
- `research-report` - Generare rapoarte
|
||||
|
||||
### Context Engineering
|
||||
Structură organizată de context care ghidează AI-ul în utilizarea corectă a capabilităților.
|
||||
|
||||
## Structura Sistemului
|
||||
|
||||
```
|
||||
.claude/
|
||||
├── output_style.md # Identitatea Nova
|
||||
├── context/ # Sistemul de context
|
||||
│ ├── claude.md # Documentație master (START HERE)
|
||||
│ ├── memory/ # Sistem de învățare
|
||||
│ │ ├── claude.md
|
||||
│ │ ├── user-preferences.md
|
||||
│ │ ├── work-patterns.md
|
||||
│ │ └── learnings.md
|
||||
│ ├── projects/ # Context specific proiecte
|
||||
│ │ └── research/
|
||||
│ │ └── claude.md
|
||||
│ └── tools/ # Documentație tools
|
||||
│ └── claude.md
|
||||
├── skills/ # Capabilități modulare
|
||||
│ ├── web-research/
|
||||
│ │ └── SKILL.md
|
||||
│ └── research-report/
|
||||
│ ├── SKILL.md
|
||||
│ └── report-structure-template.md
|
||||
└── hooks/ # Automatizări
|
||||
└── load-context.ts
|
||||
```
|
||||
|
||||
## Quick Start
|
||||
|
||||
### Pentru Nova (AI Assistant)
|
||||
|
||||
La începutul fiecărei conversații:
|
||||
|
||||
1. **Citește** `.claude/context/claude.md` pentru a înțelege arhitectura
|
||||
2. **Identifică** subsistemele relevante pentru task
|
||||
3. **Încarcă** doar contextul necesar
|
||||
4. **Execută** task-ul folosind skills și tools
|
||||
5. **Documentează** învățările în memory/
|
||||
|
||||
### Pentru Utilizator
|
||||
|
||||
Exemple de comenzi:
|
||||
|
||||
```
|
||||
"Cercetează despre [subiect]"
|
||||
→ Nova folosește web-research skill
|
||||
|
||||
"Cercetează despre [subiect] și fă raport"
|
||||
→ Nova folosește web-research + research-report skills
|
||||
|
||||
"Ce skills ai disponibile?"
|
||||
→ Nova citește context/claude.md și listează
|
||||
```
|
||||
|
||||
## Capabilities
|
||||
|
||||
### Cercetare Web
|
||||
- Strategie de căutare în 5 pași
|
||||
- Evaluare credibilitate surse
|
||||
- Sinteză și analiză critică
|
||||
- Minimum 5-10 surse per cercetare
|
||||
|
||||
### Generare Rapoarte
|
||||
- Structură profesională standardizată
|
||||
- Format Markdown
|
||||
- Executive summary, analiză, concluzii
|
||||
- Citații complete și corecte
|
||||
|
||||
### Învățare Continuă
|
||||
- Stochează preferințe utilizator
|
||||
- Optimizează workflow-uri
|
||||
- Documentează best practices
|
||||
- Evoluție în timp
|
||||
|
||||
## Teste Efectuate
|
||||
|
||||
✅ **Test 1: Context Loading** - Verificare structură și documentație
|
||||
✅ **Test 2: Simple Research** - Workflow cercetare completă
|
||||
✅ **Test 3: Research + Report** - Integrare skills
|
||||
✅ **Test 4: Memory Persistence** - Sistem învățare
|
||||
|
||||
## Files Count
|
||||
|
||||
- **Total fișiere**: 13
|
||||
- **Context files**: 5
|
||||
- **Skills**: 2 (+ 1 template)
|
||||
- **Memory files**: 4
|
||||
- **Hooks**: 1
|
||||
- **Documentation**: 1 (README)
|
||||
|
||||
## Extindere Sistem
|
||||
|
||||
### 📖 Documentație Disponibilă
|
||||
|
||||
- **[QUICK-REFERENCE.md](docs/QUICK-REFERENCE.md)** - Referință rapidă pentru task-uri comune
|
||||
- **[HOW-TO-ADD-SKILLS.md](docs/HOW-TO-ADD-SKILLS.md)** - Ghid complet adăugare skills noi
|
||||
|
||||
### 🚀 Adăugare Skill Nou (Quick)
|
||||
|
||||
```bash
|
||||
# 1. Creează directorul
|
||||
mkdir -p .claude/skills/[nume-skill]/
|
||||
|
||||
# 2. Creează SKILL.md cu YAML frontmatter
|
||||
# Vezi template în docs/HOW-TO-ADD-SKILLS.md
|
||||
|
||||
# 3. Actualizează context/claude.md
|
||||
# Adaugă în lista "Skills disponibile"
|
||||
|
||||
# 4. Testează în conversație
|
||||
```
|
||||
|
||||
### 💡 Idei pentru Skills Noi
|
||||
|
||||
**Development**: `code-review`, `debug-assistant`, `api-design`, `test-generation`
|
||||
**Data**: `data-analysis`, `visualization`, `sql-query`, `data-cleaning`
|
||||
**Content**: `email-drafting`, `presentation`, `documentation`, `copywriting`
|
||||
**Business**: `market-research`, `competitive-analysis`, `financial-analysis`
|
||||
|
||||
### 🔄 Upgrade Componente Existente
|
||||
|
||||
- **Skills**: Editează SKILL.md, adaugă features, increment version
|
||||
- **Context**: Adaugă subsisteme în `context/`
|
||||
- **Projects**: Creează `projects/[tip]/claude.md` cu workflow specific
|
||||
- **Tools**: Actualizează `context/tools/claude.md` cu tool-uri noi
|
||||
|
||||
## Technical Details
|
||||
|
||||
### Progressive Disclosure Levels
|
||||
|
||||
**Nivel 0**: Awareness că există sistem de context
|
||||
**Nivel 1**: Citește `context/claude.md` → înțelege subsisteme
|
||||
**Nivel 2**: Încarcă subsistemele relevante
|
||||
**Nivel 3**: Încarcă fișiere specifice din subsisteme
|
||||
|
||||
### Skills Format
|
||||
|
||||
Toate skills folosesc:
|
||||
- YAML frontmatter (`name`, `description`)
|
||||
- Markdown content structurat
|
||||
- Secțiuni standard (Scop, Când să folosești, Proces, Exemple)
|
||||
- Troubleshooting și best practices
|
||||
|
||||
### Memory Format
|
||||
|
||||
```markdown
|
||||
## [DATA] - [CATEGORIE]
|
||||
|
||||
**Context**: [Situația]
|
||||
**Învățare**: [Ce s-a învățat]
|
||||
**Aplicabilitate**: [Când să aplici]
|
||||
|
||||
---
|
||||
```
|
||||
|
||||
## Philosophy
|
||||
|
||||
> "The best AI assistant is one that learns your preferences, adapts to your workflow, and gets better over time while using resources efficiently."
|
||||
|
||||
Acest sistem demonstrează că AI-ul poate fi:
|
||||
- **Eficient** (progressive disclosure)
|
||||
- **Adaptabil** (memory system)
|
||||
- **Modular** (skills system)
|
||||
- **Transparent** (context engineering)
|
||||
|
||||
## Credits
|
||||
|
||||
**Inspirație**:
|
||||
- Daniel Miessler - Personal AI Infrastructure (PAI)
|
||||
- Anthropic - Agent Skills concept
|
||||
- Claude Code - Implementation platform
|
||||
|
||||
**Implementare**: Ianuarie 2025
|
||||
|
||||
**Licență**: Demo/Educational purposes
|
||||
|
||||
---
|
||||
|
||||
Pentru întrebări despre acest sistem, consultă `context/claude.md` pentru detalii complete despre arhitectură și utilizare.
|
||||
156
.claude/context/claude.md
Normal file
156
.claude/context/claude.md
Normal file
@@ -0,0 +1,156 @@
|
||||
# Nova Context System - Arhitectura Generală
|
||||
|
||||
## Prezentare Generală
|
||||
|
||||
Acesta este sistemul de context pentru Nova, asistentul tău personal de cercetare. Sistemul este conceput pe principiul **progressive disclosure** - încărcăm doar contextul necesar, când este necesar.
|
||||
|
||||
## Filosofia Sistemului
|
||||
|
||||
### Progressive Disclosure
|
||||
|
||||
În loc să încarci tot contextul dintr-o dată (consumând token-uri inutil), sistemul funcționează astfel:
|
||||
|
||||
1. **Nivel 0**: Știi că există un sistem de context
|
||||
2. **Nivel 1**: Citești acest fișier pentru a înțelege ce subsisteme există
|
||||
3. **Nivel 2**: Încărci doar subsistemele relevante pentru task-ul curent
|
||||
4. **Nivel 3**: Din subsisteme, încărci doar fișierele specifice necesare
|
||||
|
||||
### Exemplu Practic
|
||||
|
||||
Utilizator: "Cercetează despre AI în educație"
|
||||
|
||||
Flux de lucru:
|
||||
1. Citești acest fișier (claude.md) → înțelegi că există projects/ și skills/
|
||||
2. Citești `projects/research/claude.md` → înțelegi cum să gestionezi proiecte de cercetare
|
||||
3. Citești `skills/web-research/SKILL.md` → înțelegi cum să cercetezi pe web
|
||||
4. Execuți cercetarea
|
||||
5. Citești `skills/research-report/SKILL.md` → înțelegi cum să generezi raportul
|
||||
6. Generezi raportul
|
||||
|
||||
## Subsisteme Disponibile
|
||||
|
||||
### 1. Memory System (`~/.claude/context/memory/`)
|
||||
|
||||
**Scop**: Stochează învățări și preferințe despre utilizator.
|
||||
|
||||
**Când să folosești**:
|
||||
- Utilizatorul menționează o preferință
|
||||
- Task-uri repetitive care ar beneficia de optimizări
|
||||
- Pattern-uri în comportamentul utilizatorului
|
||||
|
||||
**Cum să accesezi**: Citește `~/.claude/context/memory/claude.md`
|
||||
|
||||
### 2. Projects System (`~/.claude/context/projects/`)
|
||||
|
||||
**Scop**: Context specific pentru diferite tipuri de proiecte.
|
||||
|
||||
**Proiecte disponibile**:
|
||||
- `research/` - Proiecte de cercetare și analiză
|
||||
|
||||
**Când să folosești**: Când utilizatorul pornește un nou task sau menționează un proiect.
|
||||
|
||||
**Cum să accesezi**: Citește fișierul `claude.md` din folderul proiectului relevant.
|
||||
|
||||
### 3. Tools System (`~/.claude/context/tools/`)
|
||||
|
||||
**Scop**: Documentație pentru tool-uri și comenzi disponibile.
|
||||
|
||||
**Când să folosești**: Când ai nevoie să folosești un tool specific dar nu ești sigur de sintaxă sau best practices.
|
||||
|
||||
**Cum să accesezi**: Citește `~/.claude/context/tools/claude.md`
|
||||
|
||||
### 4. Skills System (`~/.claude/skills/`)
|
||||
|
||||
**Scop**: Capabilități specializate care pot fi folosite modular.
|
||||
|
||||
**Skills disponibile**:
|
||||
- `web-research/` - Cercetare avansată pe web
|
||||
- `research-report/` - Generare rapoarte profesionale
|
||||
|
||||
**Când să folosești**: Când task-ul utilizatorului se potrivește cu un skill disponibil.
|
||||
|
||||
**Cum să accesezi**: Citește `SKILL.md` din folderul skill-ului relevant.
|
||||
|
||||
## Protocol de Lucru
|
||||
|
||||
### La Începutul Fiecărei Conversații
|
||||
|
||||
1. **Verifică dacă ai citit acest fișier** - dacă nu, citește-l acum
|
||||
2. **Înțelege task-ul utilizatorului**
|
||||
3. **Identifică subsistemele relevante**
|
||||
4. **Încarcă doar contextul necesar**
|
||||
|
||||
### Pentru Task-uri Complexe
|
||||
|
||||
1. **Planifică**: Identifică pașii necesari
|
||||
2. **Identifică skills**: Ce skills vor fi necesare?
|
||||
3. **Încarcă context**: Citește fișierele relevante
|
||||
4. **Execută**: Folosește skills și tools
|
||||
5. **Documentează**: Actualizează memoria dacă e relevant
|
||||
|
||||
## Exemple de Fluxuri
|
||||
|
||||
### Flux 1: Cercetare Simplă
|
||||
|
||||
```
|
||||
User: "Cercetează despre blockchain în sănătate"
|
||||
|
||||
Nova:
|
||||
1. ✅ Citesc context/claude.md (acest fișier)
|
||||
2. ✅ Citesc projects/research/claude.md
|
||||
3. ✅ Citesc skills/web-research/SKILL.md
|
||||
4. ✅ Execut cercetarea
|
||||
5. ✅ Prezint rezultatele
|
||||
```
|
||||
|
||||
### Flux 2: Cercetare + Raport
|
||||
|
||||
```
|
||||
User: "Cercetează despre blockchain în sănătate și fă-mi un raport"
|
||||
|
||||
Nova:
|
||||
1. ✅ Citesc context/claude.md
|
||||
2. ✅ Citesc projects/research/claude.md
|
||||
3. ✅ Citesc skills/web-research/SKILL.md
|
||||
4. ✅ Execut cercetarea
|
||||
5. ✅ Citesc skills/research-report/SKILL.md
|
||||
6. ✅ Generez raportul în format docx
|
||||
7. ✅ Salvez în /mnt/user-data/outputs/
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
### ✅ DO
|
||||
|
||||
- Citește întotdeauna context/claude.md la începutul conversației
|
||||
- Încarcă doar contextul necesar pentru task
|
||||
- Documentează învățările în memory/
|
||||
- Fii transparent despre ce fișiere citești
|
||||
- Întreabă clarificări când task-ul e ambiguu
|
||||
|
||||
### ❌ DON'T
|
||||
|
||||
- Nu încărca tot contextul dintr-o dată
|
||||
- Nu presupune - citește fișierele de context
|
||||
- Nu ignora instrucțiunile din skills
|
||||
- Nu uita să actualizezi memoria când e relevant
|
||||
|
||||
## Debugging
|
||||
|
||||
Dacă întâlnești erori:
|
||||
1. Verifică dacă ai citit toate fișierele de context necesare
|
||||
2. Verifică dacă urmezi instrucțiunile din skills
|
||||
3. Verifică dacă tool-urile sunt folosite corect
|
||||
4. Consultă `context/tools/claude.md` pentru ajutor
|
||||
|
||||
## Evoluția Sistemului
|
||||
|
||||
Acest sistem va evolua. Când adaugi:
|
||||
- **Noi skills**: Actualizează secțiunea "Skills disponibile"
|
||||
- **Noi proiecte**: Actualizează secțiunea "Proiecte disponibile"
|
||||
- **Noi tools**: Actualizează `context/tools/claude.md`
|
||||
|
||||
---
|
||||
|
||||
**Versiune**: 1.0 (Demo)
|
||||
**Ultima actualizare**: 2025-01-06
|
||||
97
.claude/context/memory/claude.md
Normal file
97
.claude/context/memory/claude.md
Normal file
@@ -0,0 +1,97 @@
|
||||
# Memory System
|
||||
|
||||
## Scop
|
||||
|
||||
Sistemul de memorie permite Nova să învețe și să rețină:
|
||||
- Preferințe ale utilizatorului
|
||||
- Pattern-uri în task-uri
|
||||
- Optimizări descoperite
|
||||
- Context istoric relevant
|
||||
|
||||
## Structura Memoriei
|
||||
|
||||
```
|
||||
memory/
|
||||
├── claude.md (acest fișier)
|
||||
├── user-preferences.md
|
||||
├── work-patterns.md
|
||||
└── learnings.md
|
||||
```
|
||||
|
||||
## Când să Actualizezi Memoria
|
||||
|
||||
### user-preferences.md
|
||||
- Utilizatorul exprimă o preferință explicită
|
||||
- Observi un pattern consistent în cererile utilizatorului
|
||||
|
||||
### work-patterns.md
|
||||
- Identifici un workflow repetitiv
|
||||
- Descoperi o optimizare pentru task-uri comune
|
||||
|
||||
### learnings.md
|
||||
- Rezolvi o problemă nouă
|
||||
- Descoperi un best practice
|
||||
- Întâlnești și rezolvi o eroare
|
||||
|
||||
## Format pentru Intrări
|
||||
|
||||
```markdown
|
||||
## [DATA] - [CATEGORIE]
|
||||
|
||||
**Context**: Ce task sau situație
|
||||
**Învățare**: Ce ai învățat
|
||||
**Aplicabilitate**: Când să folosești această cunoștință
|
||||
|
||||
---
|
||||
```
|
||||
|
||||
## Exemple
|
||||
|
||||
### Exemplu 1: Preferință Utilizator
|
||||
|
||||
```markdown
|
||||
## 2025-01-15 - Preferință Format
|
||||
|
||||
**Context**: Utilizatorul a cerut un raport despre AI
|
||||
**Învățare**: Preferă rapoarte în format DOCX, nu Markdown
|
||||
**Aplicabilitate**: Pentru toate rapoartele viitoare, generează implicit DOCX
|
||||
|
||||
---
|
||||
```
|
||||
|
||||
### Exemplu 2: Optimizare Workflow
|
||||
|
||||
```markdown
|
||||
## 2025-01-16 - Optimizare Cercetare
|
||||
|
||||
**Context**: Cercetare despre tehnologie emergentă
|
||||
**Învățare**: Pentru subiecte tech, caută mai întâi pe ArXiv, apoi Google Scholar, apoi web general
|
||||
**Aplicabilitate**: Task-uri de cercetare tehnologică
|
||||
|
||||
---
|
||||
```
|
||||
|
||||
## Cum să Folosești Memoria
|
||||
|
||||
1. **La începutul conversației**: Citește fișierele de memorie relevante
|
||||
2. **În timpul lucrului**: Observă pattern-uri și preferințe
|
||||
3. **La finalul task-urilor**: Actualizează memoria cu învățări noi
|
||||
4. **Pentru task-uri repetitive**: Consultă memoria pentru optimizări
|
||||
|
||||
## Best Practices
|
||||
|
||||
### ✅ DO
|
||||
- Actualizează memoria după task-uri semnificative
|
||||
- Fii specific în documentarea preferințelor
|
||||
- Notează atât succese cât și eșecuri
|
||||
- Revizuiește memoria periodic
|
||||
|
||||
### ❌ DON'T
|
||||
- Nu actualiza pentru fiecare task trivial
|
||||
- Nu presupune preferințe - așteaptă confirmarea
|
||||
- Nu șterge învățări vechi fără motiv
|
||||
- Nu ignora conflicte în preferințe
|
||||
|
||||
## Notă Importantă
|
||||
|
||||
Memoria este un sistem de învățare continuă. Cu cât utilizezi mai mult sistemul, cu atât Nova devine mai eficientă și mai aliniată cu preferințele tale.
|
||||
40
.claude/context/memory/learnings.md
Normal file
40
.claude/context/memory/learnings.md
Normal file
@@ -0,0 +1,40 @@
|
||||
# Learnings
|
||||
|
||||
Acest fișier stochează învățări tehnice, best practices, și soluții la probleme întâlnite.
|
||||
|
||||
---
|
||||
|
||||
## 2025-01-06 - Implementare PAI Demo
|
||||
|
||||
**Context**: Crearea sistemului Personal AI Infrastructure cu progressive disclosure
|
||||
**Învățare**:
|
||||
- Structura modulară cu skills și context permite scalabilitate
|
||||
- Progressive disclosure reduce consumul de tokeni
|
||||
- YAML frontmatter în skills permite metadata structurată
|
||||
- Hook-ul pentru context loading necesită adaptare pentru Claude Code
|
||||
|
||||
**Aplicabilitate**:
|
||||
- Pentru proiecte viitoare cu AI care necesită context complex
|
||||
- Când trebuie gestionate multiple domenii de expertiză
|
||||
- Pentru sisteme care învață preferințe utilizator
|
||||
|
||||
---
|
||||
|
||||
## 2025-01-06 - Documentație Extensie Sistem
|
||||
|
||||
**Context**: Utilizator a întrebat cum să adauge skills noi și să upgradeze sistemul
|
||||
**Învățare**:
|
||||
- Creat 3 ghiduri complete: QUICK-REFERENCE, HOW-TO-ADD-SKILLS, EXAMPLE-NEW-SKILL
|
||||
- Proces standardizat în 4 pași: mkdir → create SKILL.md → update context → test
|
||||
- Template YAML frontmatter obligatoriu pentru toate skills-urile
|
||||
- Exemplu practic (email-drafting) demonstrează structură completă
|
||||
- Documentația trebuie să fie stratificată: quick ref → ghid complet → exemplu practic
|
||||
|
||||
**Aplicabilitate**:
|
||||
- Pentru orice extensie viitoare a sistemului
|
||||
- Documentația în 3 nivele permite adaptare la diferite nevoi
|
||||
- Template-uri reduc timpul de implementare cu ~80%
|
||||
|
||||
---
|
||||
|
||||
<!-- Adaugă noi învățări aici -->
|
||||
15
.claude/context/memory/user-preferences.md
Normal file
15
.claude/context/memory/user-preferences.md
Normal file
@@ -0,0 +1,15 @@
|
||||
# User Preferences
|
||||
|
||||
Acest fișier stochează preferințele utilizatorului învățate pe parcursul utilizării sistemului Nova.
|
||||
|
||||
---
|
||||
|
||||
## 2025-01-06 - Inițializare Sistem
|
||||
|
||||
**Context**: Crearea sistemului Personal AI Infrastructure Demo
|
||||
**Învățare**: Utilizatorul a solicitat implementare completă (CRITICAL + HIGH + MEDIUM files)
|
||||
**Aplicabilitate**: Preferă soluții complete și comprehensive față de minimum viable
|
||||
|
||||
---
|
||||
|
||||
<!-- Adaugă noi preferințe aici folosind formatul de mai sus -->
|
||||
18
.claude/context/memory/work-patterns.md
Normal file
18
.claude/context/memory/work-patterns.md
Normal file
@@ -0,0 +1,18 @@
|
||||
# Work Patterns
|
||||
|
||||
Acest fișier documentează pattern-uri și workflow-uri optimizate descoperite în timpul lucrului.
|
||||
|
||||
---
|
||||
|
||||
<!-- Adaugă pattern-uri descoperite aici -->
|
||||
<!-- Exemplu:
|
||||
|
||||
## 2025-01-XX - Pattern Descoperit
|
||||
|
||||
**Context**: [Descriere situație]
|
||||
**Învățare**: [Ce pattern ai identificat]
|
||||
**Aplicabilitate**: [Când să folosești acest pattern]
|
||||
|
||||
---
|
||||
|
||||
-->
|
||||
109
.claude/context/projects/research/claude.md
Normal file
109
.claude/context/projects/research/claude.md
Normal file
@@ -0,0 +1,109 @@
|
||||
# Research Project Context
|
||||
|
||||
## Prezentare
|
||||
|
||||
Acest context se aplică pentru toate task-urile de cercetare și analiză.
|
||||
|
||||
## Tipuri de Cercetare Suportate
|
||||
|
||||
1. **Cercetare Generală**: Subiect larg, overview complet
|
||||
2. **Cercetare Tehnică**: Focus pe aspecte tehnice, soluții
|
||||
3. **Cercetare Comparativă**: Comparații între opțiuni/soluții
|
||||
4. **Cercetare de Piață**: Analiză competitori, tendințe
|
||||
|
||||
## Workflow Standard
|
||||
|
||||
### Faza 1: Înțelegere
|
||||
|
||||
1. Clarifică subiectul cu utilizatorul dacă e necesar
|
||||
2. Identifică tipul de cercetare
|
||||
3. Stabilește obiectivele specifice
|
||||
|
||||
### Faza 2: Cercetare
|
||||
|
||||
1. Folosește `web-research` skill
|
||||
2. Prioritizează surse credibile:
|
||||
- Academic: Google Scholar, ArXiv, PubMed
|
||||
- Profesional: Medium, blog-uri corporative
|
||||
- News: Surse jurnalistice credibile
|
||||
- Technical: Documentation oficială, GitHub
|
||||
|
||||
3. Adună minim 5-10 surse relevante
|
||||
4. Verifică informațiile pe surse multiple
|
||||
|
||||
### Faza 3: Analiză
|
||||
|
||||
1. Extrage informații cheie din fiecare sursă
|
||||
2. Identifică pattern-uri și teme comune
|
||||
3. Notează conflicte sau dezacorduri între surse
|
||||
4. Sintetizează o perspectivă echilibrată
|
||||
|
||||
### Faza 4: Raportare
|
||||
|
||||
1. Folosește `research-report` skill
|
||||
2. Structurează informația logic
|
||||
3. Citează sursele corespunzător
|
||||
4. Generează output în formatul cerut
|
||||
|
||||
## Structura Raportului Standard
|
||||
|
||||
```
|
||||
1. Executive Summary
|
||||
2. Introducere și Context
|
||||
3. Metodologie de Cercetare
|
||||
4. Descoperiri Principale
|
||||
- Subsecțiune 1
|
||||
- Subsecțiune 2
|
||||
- etc.
|
||||
5. Analiză și Implicații
|
||||
6. Concluzii
|
||||
7. Recomandări (dacă e relevant)
|
||||
8. Surse și Referințe
|
||||
```
|
||||
|
||||
## Criterii de Calitate
|
||||
|
||||
### ✅ Un Raport de Calitate Include:
|
||||
|
||||
- Minim 5 surse credibile
|
||||
- Informații verificate pe surse multiple
|
||||
- Citatii corecte și complete
|
||||
- Analiză critică, nu doar descriere
|
||||
- Structură clară și logică
|
||||
- Executive summary concis
|
||||
- Secțiune de concluzii acționabile
|
||||
|
||||
### ❌ Evită:
|
||||
|
||||
- Surse necredibile sau dubioase
|
||||
- Informații neverificate
|
||||
- Plagiat sau copy-paste din surse
|
||||
- Structură haotică
|
||||
- Concluzii lipsite de suport
|
||||
|
||||
## Tools Disponibile
|
||||
|
||||
- `WebSearch`: Căutare pe web
|
||||
- `WebFetch`: Descărcare conținut complet
|
||||
- `Write`: Creare rapoarte
|
||||
- Skills: `web-research`, `research-report`
|
||||
|
||||
## Exemple de Task-uri
|
||||
|
||||
### Task 1: Cercetare Generală
|
||||
```
|
||||
"Cercetează despre inteligența artificială în educație"
|
||||
→ Web search → Analiză → Raport general
|
||||
```
|
||||
|
||||
### Task 2: Cercetare Tehnică
|
||||
```
|
||||
"Cercetează soluții de blockchain pentru supply chain"
|
||||
→ Focus pe implementări tehnice → Comparații → Raport tehnic
|
||||
```
|
||||
|
||||
### Task 3: Cercetare Comparativă
|
||||
```
|
||||
"Compară React vs Vue vs Angular pentru aplicații enterprise"
|
||||
→ Criterii de comparație → Analiză fiecare → Tabel comparativ → Recomandări
|
||||
```
|
||||
255
.claude/context/tools/claude.md
Normal file
255
.claude/context/tools/claude.md
Normal file
@@ -0,0 +1,255 @@
|
||||
# Tools System
|
||||
|
||||
## Tools Disponibile
|
||||
|
||||
### 1. WebSearch
|
||||
|
||||
**Scop**: Căutare pe web pentru informații.
|
||||
|
||||
**Când să folosești**:
|
||||
- Căutări de informații generale
|
||||
- Găsire surse multiple pe un topic
|
||||
- Explorare inițială a unui subiect
|
||||
|
||||
**Sintaxă**:
|
||||
```
|
||||
WebSearch({ query: "string" }) // 1-6 cuvinte pentru rezultate optime
|
||||
```
|
||||
|
||||
**Best Practices**:
|
||||
- Ține query-urile scurte și focusate
|
||||
- Începe cu query-uri largi, apoi restrânge
|
||||
- Nu repeta același query
|
||||
- Pentru subiecte recente, include anul
|
||||
|
||||
**Exemple**:
|
||||
```
|
||||
// ✅ Bine
|
||||
WebSearch({ query: "blockchain healthcare 2024" })
|
||||
WebSearch({ query: "Claude AI capabilities" })
|
||||
|
||||
// ❌ Evită
|
||||
WebSearch({ query: "what are all the different applications and use cases of blockchain technology in the healthcare industry" })
|
||||
```
|
||||
|
||||
### 2. WebFetch
|
||||
|
||||
**Scop**: Descarcă și analizează conținutul complet al unei pagini web.
|
||||
|
||||
**Când să folosești**:
|
||||
- După WebSearch, pentru a citi articole complete
|
||||
- Când ai nevoie de detalii specifice dintr-o sursă
|
||||
- Pentru a verifica informații
|
||||
|
||||
**Sintaxă**:
|
||||
```
|
||||
WebFetch({
|
||||
url: "https://example.com/article",
|
||||
prompt: "Extract key findings and main arguments"
|
||||
})
|
||||
```
|
||||
|
||||
**Best Practices**:
|
||||
- Folosește doar pe URL-uri returnate de WebSearch
|
||||
- Nu face fetch pe mai mult de 5-10 URL-uri per task
|
||||
- Prioritizează surse credibile
|
||||
- Folosește prompt-uri clare pentru extracție
|
||||
|
||||
### 3. Read
|
||||
|
||||
**Scop**: Citește fișiere locale.
|
||||
|
||||
**Când să folosești**:
|
||||
- Citire fișiere de configurare
|
||||
- Citire context din alte fișiere
|
||||
- Verificare conținut existent
|
||||
|
||||
**Sintaxă**:
|
||||
```
|
||||
Read({ file_path: "/absolute/path/to/file" })
|
||||
```
|
||||
|
||||
**Best Practices**:
|
||||
- Folosește întotdeauna path-uri absolute
|
||||
- Verifică că fișierul există înainte
|
||||
|
||||
### 4. Write
|
||||
|
||||
**Scop**: Creează sau suprascrie fișiere.
|
||||
|
||||
**Când să folosești**:
|
||||
- Generare rapoarte
|
||||
- Salvare rezultate cercetare
|
||||
- Creare fișiere noi
|
||||
|
||||
**Sintaxă**:
|
||||
```
|
||||
Write({
|
||||
file_path: "/absolute/path/to/file.md",
|
||||
content: "conținutul fișierului"
|
||||
})
|
||||
```
|
||||
|
||||
**Best Practices**:
|
||||
- Folosește nume descriptive pentru fișiere
|
||||
- Organizează fișierele logic (ex: outputs/ pentru rapoarte)
|
||||
- Pentru rapoarte mari, salvează în format Markdown
|
||||
|
||||
### 5. Edit
|
||||
|
||||
**Scop**: Editează fișiere existente prin înlocuire de text.
|
||||
|
||||
**Când să folosești**:
|
||||
- Modificare fișiere existente
|
||||
- Actualizare conținut specific
|
||||
- Adăugare informații la fișiere
|
||||
|
||||
**Sintaxă**:
|
||||
```
|
||||
Edit({
|
||||
file_path: "/path/to/file",
|
||||
old_string: "text de înlocuit",
|
||||
new_string: "text nou"
|
||||
})
|
||||
```
|
||||
|
||||
### 6. Bash
|
||||
|
||||
**Scop**: Execută comenzi bash.
|
||||
|
||||
**Când să folosești**:
|
||||
- Operații pe sistem de fișiere
|
||||
- Instalare pachete
|
||||
- Verificare stare sistem
|
||||
|
||||
**Sintaxă**:
|
||||
```
|
||||
Bash({
|
||||
command: "ls -la",
|
||||
description: "List all files in directory"
|
||||
})
|
||||
```
|
||||
|
||||
**Best Practices**:
|
||||
- Explică utilizatorului ce face comanda
|
||||
- Verifică comenzile înainte de execuție
|
||||
- Folosește pentru operații care nu pot fi făcute cu alte tools
|
||||
|
||||
### 7. Glob
|
||||
|
||||
**Scop**: Găsește fișiere folosind pattern-uri.
|
||||
|
||||
**Când să folosești**:
|
||||
- Căutare fișiere după nume
|
||||
- Găsire fișiere cu extensii specifice
|
||||
- Explorare structură proiect
|
||||
|
||||
**Sintaxă**:
|
||||
```
|
||||
Glob({ pattern: "**/*.md" })
|
||||
```
|
||||
|
||||
### 8. Grep
|
||||
|
||||
**Scop**: Căutare text în fișiere.
|
||||
|
||||
**Când să folosești**:
|
||||
- Căutare cod sau text specific
|
||||
- Găsire pattern-uri în fișiere
|
||||
- Explorare codebase
|
||||
|
||||
**Sintaxă**:
|
||||
```
|
||||
Grep({
|
||||
pattern: "search pattern",
|
||||
output_mode: "content"
|
||||
})
|
||||
```
|
||||
|
||||
## Workflow Tools pentru Task-uri Comune
|
||||
|
||||
### Cercetare + Raport
|
||||
|
||||
```
|
||||
1. WebSearch → găsește surse
|
||||
2. WebFetch → citește surse detaliate (3-5 articole)
|
||||
3. [analiză și sinteză]
|
||||
4. Write → generează raportul
|
||||
```
|
||||
|
||||
### Analiză Context Sistem
|
||||
|
||||
```
|
||||
1. Read → citește fișiere de context
|
||||
2. Glob → găsește fișiere relevante
|
||||
3. Grep → caută informații specifice
|
||||
4. [procesare]
|
||||
```
|
||||
|
||||
### Actualizare Memorie
|
||||
|
||||
```
|
||||
1. Read → citește fișierul de memorie existent
|
||||
2. Edit → adaugă noua învățare
|
||||
3. [sau Write dacă fișierul nu există]
|
||||
```
|
||||
|
||||
## Error Handling
|
||||
|
||||
### Erori Comune
|
||||
|
||||
**WebSearch returnează rezultate irelevante**:
|
||||
→ Reformulează query-ul, fii mai specific
|
||||
|
||||
**WebFetch eșuează**:
|
||||
→ URL-ul poate fi invalid sau blocat, încearcă alt URL
|
||||
|
||||
**Write eșuează**:
|
||||
→ Verifică că path-ul este valid și ai permisiuni
|
||||
|
||||
**Read eșuează**:
|
||||
→ Verifică că fișierul există la path-ul specificat
|
||||
|
||||
## Rate Limits și Performanță
|
||||
|
||||
- WebSearch: Nelimitat practic
|
||||
- WebFetch: Maxim 10-15 per task pentru performanță
|
||||
- Write/Read/Edit: Nelimitat
|
||||
- Bash: Folosește cu moderație
|
||||
|
||||
## Permisiuni și Acces
|
||||
|
||||
**Poți accesa**:
|
||||
- Directorul de lucru curent
|
||||
- Subdirectoarele proiectului
|
||||
- Fișiere pe care le creezi
|
||||
|
||||
**Best Practices**:
|
||||
- Folosește path-uri relative pentru fișiere din proiect
|
||||
- Organizează output-urile logic
|
||||
- Nu șterge fișiere fără confirmare utilizator
|
||||
|
||||
## Integrare cu Skills
|
||||
|
||||
### web-research skill folosește:
|
||||
- WebSearch (căutare inițială)
|
||||
- WebFetch (citire articole)
|
||||
|
||||
### research-report skill folosește:
|
||||
- Write (generare raport)
|
||||
- Read (citire template-uri)
|
||||
|
||||
### memory system folosește:
|
||||
- Read (citire memorie existentă)
|
||||
- Edit (actualizare memorie)
|
||||
- Write (creare fișiere noi de memorie)
|
||||
|
||||
## Tips și Trucuri
|
||||
|
||||
1. **Pentru cercetare eficientă**: Folosește 3-5 WebSearch-uri cu query-uri diferite, apoi WebFetch pe cele mai bune 5-7 rezultate
|
||||
|
||||
2. **Pentru rapoarte**: Pregătește tot conținutul în memorie, apoi Write într-un singur apel
|
||||
|
||||
3. **Pentru debugging**: Folosește Read pentru a verifica ce ai creat cu Write
|
||||
|
||||
4. **Pentru context**: Citește întotdeauna fișierele de context relevante înainte de task-uri complexe
|
||||
539
.claude/docs/EXAMPLE-NEW-SKILL.md
Normal file
539
.claude/docs/EXAMPLE-NEW-SKILL.md
Normal file
@@ -0,0 +1,539 @@
|
||||
# Exemplu Practic: Adăugare Skill "Email Drafting"
|
||||
|
||||
Acest document demonstrează procesul complet de adăugare a unui skill nou în sistemul Nova PAI.
|
||||
|
||||
## Skill Ales: Email Drafting
|
||||
|
||||
**De ce acest skill?**
|
||||
- Use case comun (toată lumea scrie email-uri)
|
||||
- Necesită context și structură
|
||||
- Se combină bine cu alte skills (ex: research pentru content)
|
||||
|
||||
---
|
||||
|
||||
## Pas cu Pas
|
||||
|
||||
### 1. Crearea Structurii
|
||||
|
||||
```bash
|
||||
# Creează directorul skill-ului
|
||||
mkdir -p .claude/skills/email-drafting/
|
||||
|
||||
# Verificare
|
||||
ls -la .claude/skills/
|
||||
# Should show: email-drafting/
|
||||
```
|
||||
|
||||
### 2. Crearea SKILL.md
|
||||
|
||||
**Fișier**: `.claude/skills/email-drafting/SKILL.md`
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: email-drafting
|
||||
description: "Skill pentru compunerea de email-uri profesionale: business communication, networking, follow-ups, și outreach. Folosește pentru orice task de scriere email."
|
||||
---
|
||||
|
||||
# Email Drafting Skill
|
||||
|
||||
## Prezentare
|
||||
|
||||
Acest skill te ajută să compui email-uri profesionale, clare și eficiente pentru diverse contexte: business communication, networking, job applications, follow-ups, și outreach.
|
||||
|
||||
## Când să Folosești
|
||||
|
||||
- Utilizatorul cere "Scrie-mi un email..."
|
||||
- "Cum răspund la..."
|
||||
- Networking outreach
|
||||
- Cold emails
|
||||
- Follow-up messages
|
||||
- Business correspondence
|
||||
- Job applications / cover letters
|
||||
|
||||
## Pre-requisite
|
||||
|
||||
Înainte de a compune email-ul, trebuie să ai:
|
||||
- ✅ Destinatarul (cui scrii)
|
||||
- ✅ Scopul email-ului (ce vrei să obții)
|
||||
- ✅ Contextul (de ce acum, ce relație aveți)
|
||||
|
||||
## Proces de Execuție
|
||||
|
||||
### Pas 1: Clarificare Context
|
||||
|
||||
**Întrebări obligatorii**:
|
||||
|
||||
1. **Cui scrii?**
|
||||
- Rol/poziție (CEO, recrutant, coleg, client)
|
||||
- Relație existentă (cunoscut, cold outreach, follow-up)
|
||||
- Nivel seniority
|
||||
|
||||
2. **Ce vrei să obții?**
|
||||
- Acțiune specifică (meeting, informații, aprobare)
|
||||
- Deadline (urgent vs. flexibil)
|
||||
- Importanță (high stakes vs. casual)
|
||||
|
||||
3. **Ce ton e potrivit?**
|
||||
- Formal vs. casual
|
||||
- Direct vs. diplomatic
|
||||
- Urgent vs. relaxat
|
||||
|
||||
### Pas 2: Selectare Template
|
||||
|
||||
În funcție de tip, alege structura potrivită:
|
||||
|
||||
**A. Cold Outreach** (nu vă cunoașteți)
|
||||
```
|
||||
Subject: [Specific + Value proposition]
|
||||
|
||||
Hi [Name],
|
||||
|
||||
[Hook - de ce scrii + connection/relevance]
|
||||
|
||||
[Value - ce oferi sau de ce e relevant pentru ei]
|
||||
|
||||
[Ask - specific și rezonabil]
|
||||
|
||||
[Close - ușor de răspuns]
|
||||
|
||||
Best regards,
|
||||
[Your name]
|
||||
```
|
||||
|
||||
**B. Follow-up** (după întâlnire/email)
|
||||
```
|
||||
Subject: Re: [Previous subject] - [Action item]
|
||||
|
||||
Hi [Name],
|
||||
|
||||
[Reference to previous interaction]
|
||||
|
||||
[Update or reason for follow-up]
|
||||
|
||||
[Next steps or ask]
|
||||
|
||||
Thanks,
|
||||
[Your name]
|
||||
```
|
||||
|
||||
**C. Request** (ceri ceva)
|
||||
```
|
||||
Subject: [Clear what you need]
|
||||
|
||||
Hi [Name],
|
||||
|
||||
[Context - de ce scrii]
|
||||
|
||||
[Request - specific și clar]
|
||||
|
||||
[Why it matters - benefit pentru ambii]
|
||||
|
||||
[Timeline - când ai nevoie]
|
||||
|
||||
Thank you for considering,
|
||||
[Your name]
|
||||
```
|
||||
|
||||
**D. Professional Introduction**
|
||||
```
|
||||
Subject: Introduction - [Your name] from [Company/Context]
|
||||
|
||||
Hi [Name],
|
||||
|
||||
[Who you are - 1 sentence]
|
||||
|
||||
[Why you're reaching out - connection/reason]
|
||||
|
||||
[What you propose - meeting, call, collaboration]
|
||||
|
||||
[Call to action - easy to respond]
|
||||
|
||||
Looking forward to connecting,
|
||||
[Your name]
|
||||
```
|
||||
|
||||
### Pas 3: Scriere Draft
|
||||
|
||||
**Componentele esențiale**:
|
||||
|
||||
1. **Subject Line**
|
||||
- ✅ Clar și specific
|
||||
- ✅ Sub 50 caractere
|
||||
- ✅ Evită spam triggers (FREE, URGENT!!!, etc.)
|
||||
- ❌ Nu folosi "Re:" dacă nu e răspuns real
|
||||
|
||||
2. **Opening**
|
||||
- ✅ Personalizat (folosește numele)
|
||||
- ✅ Context imediat (de ce scrii)
|
||||
- ❌ Nu începe cu "Sper că ești bine" în cold emails
|
||||
|
||||
3. **Body**
|
||||
- ✅ Paragrafe scurte (2-4 fraze)
|
||||
- ✅ Un singur scop principal
|
||||
- ✅ Beneficii clare
|
||||
- ❌ Nu include multiple cereri nesupravegheate
|
||||
|
||||
4. **Call to Action**
|
||||
- ✅ Specific și actionable
|
||||
- ✅ Ușor de executat
|
||||
- ✅ Include opțiuni (dacă e relevant)
|
||||
- ❌ Nu lăsa vag ("Aștept răspunsul tău")
|
||||
|
||||
5. **Closing**
|
||||
- ✅ Professional
|
||||
- ✅ Pe ton cu restul email-ului
|
||||
- ✅ Include contact info dacă e relevant
|
||||
|
||||
### Pas 4: Revizuire și Optimizare
|
||||
|
||||
**Checklist final**:
|
||||
|
||||
- [ ] Subject line sub 50 caractere și clar
|
||||
- [ ] Email sub 150 cuvinte (ideal 75-100)
|
||||
- [ ] Un singur scop principal
|
||||
- [ ] CTA clar și specific
|
||||
- [ ] Fără greșeli gramaticale
|
||||
- [ ] Ton consistent
|
||||
- [ ] Mobile-friendly (testează pe telefon)
|
||||
- [ ] Include toate informațiile necesare pentru răspuns
|
||||
|
||||
**Red flags** (evită):
|
||||
- 🚩 Email > 200 cuvinte (prea lung)
|
||||
- 🚩 Multiple CTA-uri confuze
|
||||
- 🚩 Prea formal sau prea casual
|
||||
- 🚩 Lipsa context (destinatarul nu știe de ce scrii)
|
||||
- 🚩 Vague asks ("să discutăm cândva")
|
||||
|
||||
## Exemple Complete
|
||||
|
||||
### Exemplu 1: Networking Cold Email
|
||||
|
||||
**Context**: Vrei să te conectezi cu un VP Product din industria ta
|
||||
|
||||
**Input**: "Scrie-mi un email de networking către Sarah Johnson, VP Product la TechCorp"
|
||||
|
||||
**Output**:
|
||||
|
||||
```
|
||||
Subject: Fellow Product Leader - Quick Question
|
||||
|
||||
Hi Sarah,
|
||||
|
||||
I'm Alex, VP Product at StartupXYZ, and I've been following TechCorp's product evolution—particularly your recent AI features launch.
|
||||
|
||||
I'm currently navigating a similar product challenge (scaling personalization) and would love to hear about your team's approach, if you're open to a brief chat.
|
||||
|
||||
Would you have 15 minutes in the next 2 weeks for a quick call? Happy to work around your schedule.
|
||||
|
||||
Thanks for considering!
|
||||
|
||||
Alex
|
||||
alex@startupxyz.com
|
||||
```
|
||||
|
||||
**De ce funcționează**:
|
||||
- Relevance imediat (fellow VP, same field)
|
||||
- Specific despre ce admiri
|
||||
- Clear ask (15 min, 2 weeks = flexibil)
|
||||
- Respectful (nu cere mult timp)
|
||||
|
||||
### Exemplu 2: Follow-up După Meeting
|
||||
|
||||
**Context**: Ai avut un call cu un client potențial, acum trimiți follow-up
|
||||
|
||||
**Input**: "Follow-up după meeting cu John despre implementarea platformei noastre"
|
||||
|
||||
**Output**:
|
||||
|
||||
```
|
||||
Subject: Re: Platform Demo - Next Steps
|
||||
|
||||
Hi John,
|
||||
|
||||
Thanks for taking the time yesterday to walk through your team's workflow challenges. The data synchronization issue you mentioned is definitely something our platform can address.
|
||||
|
||||
As discussed, I'm attaching:
|
||||
- Custom proposal for your 50-person team
|
||||
- Case study from a similar fintech client
|
||||
- Pricing breakdown with the Q1 discount
|
||||
|
||||
I've blocked time on Friday, Jan 12 at 2pm for our follow-up call, but let me know if you need to reschedule.
|
||||
|
||||
Looking forward to moving this forward!
|
||||
|
||||
Best,
|
||||
Alex
|
||||
```
|
||||
|
||||
**De ce funcționează**:
|
||||
- Reference specific la discussion
|
||||
- Delivers pe promisiuni
|
||||
- Clear next step cu dată
|
||||
- Professional dar friendly
|
||||
|
||||
### Exemplu 3: Request Email (Asking for Introduction)
|
||||
|
||||
**Context**: Vrei o introducere către un investitor
|
||||
|
||||
**Input**: "Cere-i lui Mark să mă introducă la Sarah Chen, investitor la Accel"
|
||||
|
||||
**Output**:
|
||||
|
||||
```
|
||||
Subject: Intro Request - Sarah Chen / Accel
|
||||
|
||||
Hey Mark,
|
||||
|
||||
Hope you're doing well! I'm reaching out because I saw you're connected with Sarah Chen at Accel, and I'm currently raising our Series A.
|
||||
|
||||
Our traction (5x growth in Q4, 200+ enterprise customers) aligns well with Accel's B2B SaaS focus, and I'd love to get on Sarah's radar.
|
||||
|
||||
Would you feel comfortable making a short intro? Happy to send a forwardable email if that helps.
|
||||
|
||||
No worries if the timing isn't right—appreciate you either way!
|
||||
|
||||
Best,
|
||||
Alex
|
||||
```
|
||||
|
||||
**De ce funcționează**:
|
||||
- Respect relationship (asks permission)
|
||||
- Provides context (why Sarah specifically)
|
||||
- Makes it easy (offers forwardable)
|
||||
- No pressure close
|
||||
|
||||
### Exemplu 4: Difficult Email (Saying No)
|
||||
|
||||
**Context**: Trebuie să refuzi o cerere dar vrei să păstrezi relația
|
||||
|
||||
**Input**: "Refuz politicos o cerere de parteneriat"
|
||||
|
||||
**Output**:
|
||||
|
||||
```
|
||||
Subject: Re: Partnership Proposal - Current Focus
|
||||
|
||||
Hi Jessica,
|
||||
|
||||
Thanks for the detailed partnership proposal—I can see you put a lot of thought into how our products could complement each other.
|
||||
|
||||
After discussing with the team, we've decided to hold off on new partnerships this quarter while we focus on product improvements for our current customers.
|
||||
|
||||
That said, I'm impressed with what you're building at [Company], and I'd love to revisit this conversation in Q3 when we have more bandwidth.
|
||||
|
||||
I'll keep an eye on your progress!
|
||||
|
||||
Best,
|
||||
Alex
|
||||
```
|
||||
|
||||
**De ce funcționează**:
|
||||
- Respectful și appreciative
|
||||
- Clear "no" dar nu harsh
|
||||
- Leaves door open (specific timeframe)
|
||||
- Positive closing
|
||||
|
||||
## Tools Folosite
|
||||
|
||||
- **Read** - Pentru citire context anterior (threads)
|
||||
- **Write** - Pentru salvare drafts
|
||||
- **WebSearch** - Pentru research recipient (dacă e cold email)
|
||||
|
||||
## Integrare cu Alte Skills
|
||||
|
||||
**Combină cu**:
|
||||
- `research` - Pentru background check pe recipient
|
||||
- `copywriting` - Pentru subject lines mai creative
|
||||
- `translation` - Pentru email-uri în alte limbi
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Problem: Email prea lung
|
||||
|
||||
**Soluție**:
|
||||
1. Identifică scopul principal
|
||||
2. Elimină paragrafe care nu contribuie direct
|
||||
3. Target: 75-100 cuvinte
|
||||
4. Mută detalii extra în atașamente
|
||||
|
||||
### Problem: Ton prea formal/casual
|
||||
|
||||
**Soluție**:
|
||||
1. Verifică seniority destinatar
|
||||
2. Analizează industrie (tech = mai casual, legal = formal)
|
||||
3. Dacă unsure, alege profesional-neutral
|
||||
4. Match tonul emailurilor anterioare dacă există thread
|
||||
|
||||
### Problem: Nu știi ce CTA să pui
|
||||
|
||||
**Soluție**:
|
||||
**Template-uri CTA**:
|
||||
- **Ușor**: "Would [specific day/time] work for a quick call?"
|
||||
- **Flexibil**: "Let me know what works for your calendar"
|
||||
- **Urgent**: "Could we connect this week? I'm available [times]"
|
||||
- **Low commitment**: "Would you be open to a brief intro call?"
|
||||
|
||||
### Problem: Nu primești răspuns
|
||||
|
||||
**Soluție Follow-up**:
|
||||
1. Așteaptă 5-7 zile business
|
||||
2. Trimite bump scurt:
|
||||
```
|
||||
Hi [Name],
|
||||
|
||||
Bumping this up in your inbox—wanted to make sure it didn't get lost!
|
||||
|
||||
Any thoughts on [original ask]?
|
||||
|
||||
Thanks,
|
||||
[You]
|
||||
```
|
||||
3. Maxim 2 follow-ups total
|
||||
|
||||
## Best Practices
|
||||
|
||||
### ✅ DO
|
||||
|
||||
- **Personalizează**: Referă ceva specific despre destinatar
|
||||
- **Scurt**: Under 150 cuvinte ideal
|
||||
- **Scannable**: Paragrafe scurte, bullet points dacă e relevant
|
||||
- **Mobile-first**: Majoritatea citesc pe telefon
|
||||
- **Proofread**: Zero typos
|
||||
- **Time it right**: Trimite Marți-Joi, 10am-2pm pentru best response
|
||||
|
||||
### ❌ DON'T
|
||||
|
||||
- **Nu folosi cuvinte spam**: FREE, URGENT, GUARANTEED
|
||||
- **Nu trimiți la weekend**: Except dacă e industry norm
|
||||
- **Nu CC prea mulți**: Dilutes responsibility
|
||||
- **Nu folosești Reply All**: Except dacă relevant pentru toți
|
||||
- **Nu incluzi emoji**: În business formal
|
||||
- **Nu scrii când ești nervos**: Draft-uiește, review a doua zi
|
||||
|
||||
## Variații pe Contexte
|
||||
|
||||
### Intern (Coleg/Manager)
|
||||
- Mai casual
|
||||
- Mai direct
|
||||
- Poate fi mai lung dacă e complex
|
||||
|
||||
### Client
|
||||
- Professional
|
||||
- Solution-focused
|
||||
- Clear deliverables
|
||||
|
||||
### Recruiter/Job Application
|
||||
- Enthusiastic dar nu desperate
|
||||
- Highlight relevant experience
|
||||
- Show you did research
|
||||
|
||||
### Investor
|
||||
- Concise
|
||||
- Data-driven
|
||||
- Clear traction
|
||||
|
||||
## Metrics de Success
|
||||
|
||||
Un email bun are:
|
||||
- **Open rate**: >40% (subject line bun)
|
||||
- **Response rate**: >20% (relevant + clear CTA)
|
||||
- **Action rate**: >10% (meeting booked, intro made, etc.)
|
||||
|
||||
Dacă primești sub aceste rates, iterate pe:
|
||||
1. Subject lines
|
||||
2. Personalization
|
||||
3. Length (mai scurt)
|
||||
4. CTA clarity
|
||||
|
||||
---
|
||||
|
||||
**Versiune**: 1.0
|
||||
**Ultima actualizare**: 2025-01-06
|
||||
**Autor**: Claude (Nova PAI Demo)
|
||||
```
|
||||
|
||||
### 3. Actualizare context/claude.md
|
||||
|
||||
**Editează**: `.claude/context/claude.md`
|
||||
|
||||
**Găsește secțiunea**:
|
||||
```markdown
|
||||
**Skills disponibile**:
|
||||
- `web-research/` - Cercetare avansată pe web
|
||||
- `research-report/` - Generare rapoarte profesionale
|
||||
```
|
||||
|
||||
**Adaugă**:
|
||||
```markdown
|
||||
**Skills disponibile**:
|
||||
- `web-research/` - Cercetare avansată pe web
|
||||
- `research-report/` - Generare rapoarte profesionale
|
||||
- `email-drafting/` - Compunere email-uri profesionale
|
||||
```
|
||||
|
||||
### 4. (Opțional) Testare
|
||||
|
||||
**În conversație nouă**:
|
||||
|
||||
```
|
||||
"Citește .claude/skills/email-drafting/SKILL.md și folosește-l pentru a-mi scrie un email de networking către un VP Engineering"
|
||||
```
|
||||
|
||||
**Așteptat**:
|
||||
- Nova citește skill-ul
|
||||
- Întreabă clarificări (context, relație, etc.)
|
||||
- Generează email folosind template-ul potrivit
|
||||
- Verifică cu checklist-ul final
|
||||
|
||||
---
|
||||
|
||||
## Rezultat Final
|
||||
|
||||
Ai acum:
|
||||
- ✅ Skill nou funcțional: `email-drafting`
|
||||
- ✅ Documentație completă cu 4 exemple
|
||||
- ✅ Integrare în sistemul Nova
|
||||
- ✅ Ready for production use
|
||||
|
||||
**Locație fișiere**:
|
||||
```
|
||||
.claude/
|
||||
├── skills/
|
||||
│ └── email-drafting/
|
||||
│ └── SKILL.md ← NOU
|
||||
└── context/
|
||||
└── claude.md ← ACTUALIZAT
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Următorii Pași
|
||||
|
||||
1. **Testează skill-ul** cu diverse scenarii
|
||||
2. **Documentează probleme** în troubleshooting
|
||||
3. **Adaugă în memory** orice învățări
|
||||
4. **Iterează** bazat pe feedback
|
||||
|
||||
---
|
||||
|
||||
## Template pentru Skill-ul Tău
|
||||
|
||||
Folosește această structură ca starting point:
|
||||
|
||||
```bash
|
||||
# 1. Creează
|
||||
mkdir -p .claude/skills/[nume]/
|
||||
|
||||
# 2. Copiază structura din email-drafting ca template
|
||||
cp .claude/skills/email-drafting/SKILL.md .claude/skills/[nume]/SKILL.md
|
||||
|
||||
# 3. Editează cu conținut specific
|
||||
|
||||
# 4. Update context/claude.md
|
||||
|
||||
# 5. Test!
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**Pro Tip**: Începe cu skills simple și concrete (ca email-drafting), apoi extinde la skills mai complexe (data analysis, code generation, etc.).
|
||||
505
.claude/docs/HOW-TO-ADD-SKILLS.md
Normal file
505
.claude/docs/HOW-TO-ADD-SKILLS.md
Normal file
@@ -0,0 +1,505 @@
|
||||
# Ghid: Cum să Adaugi Noi Skills în Nova
|
||||
|
||||
## Procesul de Adăugare Skill Nou
|
||||
|
||||
### Pas 1: Creează Directorul Skill-ului
|
||||
|
||||
```bash
|
||||
mkdir -p .claude/skills/[nume-skill]/
|
||||
```
|
||||
|
||||
**Exemple**:
|
||||
- `.claude/skills/data-analysis/`
|
||||
- `.claude/skills/code-review/`
|
||||
- `.claude/skills/email-drafting/`
|
||||
|
||||
### Pas 2: Creează SKILL.md cu YAML Frontmatter
|
||||
|
||||
**Template**:
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: [nume-skill]
|
||||
description: "Descriere concisă ce face skill-ul și când să-l folosești. Maximum 2 fraze."
|
||||
---
|
||||
|
||||
# [Nume Skill] Skill
|
||||
|
||||
## Prezentare
|
||||
|
||||
[1-2 paragrafe ce este skill-ul și ce face]
|
||||
|
||||
## Când să Folosești
|
||||
|
||||
[Listă cu situații când acest skill e relevant]
|
||||
- Situație 1
|
||||
- Situație 2
|
||||
- etc.
|
||||
|
||||
## Pre-requisite
|
||||
|
||||
[Dacă skill-ul depinde de altceva]
|
||||
- Prerequisit 1
|
||||
- Prerequisit 2
|
||||
|
||||
## Proces de Execuție
|
||||
|
||||
### Pas 1: [Nume Pas]
|
||||
|
||||
[Descriere detaliată]
|
||||
|
||||
**Input necesar**:
|
||||
- Item 1
|
||||
- Item 2
|
||||
|
||||
**Output așteptat**:
|
||||
- Rezultat 1
|
||||
- Rezultat 2
|
||||
|
||||
### Pas 2: [Nume Pas]
|
||||
|
||||
[Continuă...]
|
||||
|
||||
## Tools Necesare
|
||||
|
||||
[Ce tools din sistem vei folosi]
|
||||
- `WebSearch` - pentru X
|
||||
- `Write` - pentru Y
|
||||
- etc.
|
||||
|
||||
## Template de Lucru
|
||||
|
||||
[Dacă există un template util]
|
||||
|
||||
```
|
||||
[Template aici]
|
||||
```
|
||||
|
||||
## Exemple Complete
|
||||
|
||||
### Exemplu 1: [Scenariu Simplu]
|
||||
|
||||
**Input**: "..."
|
||||
|
||||
**Execuție**:
|
||||
```
|
||||
1. Pas 1
|
||||
2. Pas 2
|
||||
3. Pas 3
|
||||
```
|
||||
|
||||
**Output**: [Descriere rezultat]
|
||||
|
||||
### Exemplu 2: [Scenariu Complex]
|
||||
|
||||
[Similar...]
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Problem: [Problemă comună]
|
||||
|
||||
**Soluție**: [Cum să rezolvi]
|
||||
|
||||
### Problem: [Altă problemă]
|
||||
|
||||
**Soluție**: [Soluție]
|
||||
|
||||
## Best Practices
|
||||
|
||||
### ✅ DO
|
||||
- Practice 1
|
||||
- Practice 2
|
||||
|
||||
### ❌ DON'T
|
||||
- Anti-pattern 1
|
||||
- Anti-pattern 2
|
||||
|
||||
## Integrare cu Alte Skills
|
||||
|
||||
[Dacă skill-ul se combină cu altele]
|
||||
|
||||
- Folosește împreună cu `[skill-name]` pentru [use case]
|
||||
- După `[skill-name]`, folosește acest skill pentru [next step]
|
||||
|
||||
## Note Importante
|
||||
|
||||
[Orice avertismente sau considerații speciale]
|
||||
|
||||
---
|
||||
|
||||
**Versiune**: 1.0
|
||||
**Ultima actualizare**: [DATA]
|
||||
**Autor**: [NUME]
|
||||
```
|
||||
|
||||
### Pas 3: Actualizează context/claude.md
|
||||
|
||||
Adaugă skill-ul în lista de skills disponibile:
|
||||
|
||||
```markdown
|
||||
## Subsisteme Disponibile
|
||||
|
||||
### 4. Skills System (`~/.claude/skills/`)
|
||||
|
||||
**Skills disponibile**:
|
||||
- `web-research/` - Cercetare avansată pe web
|
||||
- `research-report/` - Generare rapoarte profesionale
|
||||
- `[nou-skill]/` - [Descriere scurtă] ← ADAUGĂ AICI
|
||||
```
|
||||
|
||||
### Pas 4: (Opțional) Creează Fișiere Suport
|
||||
|
||||
În directorul skill-ului poți adăuga:
|
||||
- `template.md` - Template-uri
|
||||
- `examples/` - Exemple detaliate
|
||||
- `reference.md` - Documentație tehnică
|
||||
|
||||
---
|
||||
|
||||
## Exemple de Skills Noi
|
||||
|
||||
### Exemplu 1: Data Analysis Skill
|
||||
|
||||
```bash
|
||||
mkdir -p .claude/skills/data-analysis/
|
||||
```
|
||||
|
||||
**SKILL.md**:
|
||||
```markdown
|
||||
---
|
||||
name: data-analysis
|
||||
description: "Skill pentru analiza de date folosind pandas, numpy și matplotlib. Folosește pentru task-uri de statistică, vizualizare, și data cleaning."
|
||||
---
|
||||
|
||||
# Data Analysis Skill
|
||||
|
||||
## Când să Folosești
|
||||
|
||||
- Utilizatorul cere analiza unui CSV/Excel
|
||||
- Task-uri de statistică descriptivă
|
||||
- Vizualizare date
|
||||
- Data cleaning și preprocessing
|
||||
|
||||
## Proces de Execuție
|
||||
|
||||
### Pas 1: Încărcare Date
|
||||
|
||||
Folosește pandas pentru a citi fișierul:
|
||||
|
||||
```python
|
||||
import pandas as pd
|
||||
df = pd.read_csv('file.csv')
|
||||
```
|
||||
|
||||
### Pas 2: Explorare Inițială
|
||||
|
||||
```python
|
||||
# Overview
|
||||
df.info()
|
||||
df.describe()
|
||||
df.head()
|
||||
|
||||
# Check missing values
|
||||
df.isnull().sum()
|
||||
```
|
||||
|
||||
[...continuă cu pașii]
|
||||
```
|
||||
|
||||
### Exemplu 2: Code Review Skill
|
||||
|
||||
```bash
|
||||
mkdir -p .claude/skills/code-review/
|
||||
```
|
||||
|
||||
**SKILL.md**:
|
||||
```markdown
|
||||
---
|
||||
name: code-review
|
||||
description: "Skill pentru review profesional de cod: securitate, best practices, performanță, și mentenabilitate."
|
||||
---
|
||||
|
||||
# Code Review Skill
|
||||
|
||||
## Când să Folosești
|
||||
|
||||
- Utilizatorul cere review la cod
|
||||
- Pull request review
|
||||
- Audit de securitate
|
||||
- Optimizare performanță
|
||||
|
||||
## Proces de Execuție
|
||||
|
||||
### Pas 1: Citire și Înțelegere
|
||||
|
||||
1. Read fișierele de cod
|
||||
2. Înțelege arhitectura
|
||||
3. Identifică purpose-ul
|
||||
|
||||
### Pas 2: Analiza pe Categorii
|
||||
|
||||
**Securitate**:
|
||||
- [ ] SQL injection
|
||||
- [ ] XSS vulnerabilities
|
||||
- [ ] Authentication issues
|
||||
- [ ] Sensitive data exposure
|
||||
|
||||
**Best Practices**:
|
||||
- [ ] Naming conventions
|
||||
- [ ] Code organization
|
||||
- [ ] DRY principle
|
||||
- [ ] Error handling
|
||||
|
||||
[...continuă]
|
||||
```
|
||||
|
||||
### Exemplu 3: Email Drafting Skill
|
||||
|
||||
```bash
|
||||
mkdir -p .claude/skills/email-drafting/
|
||||
```
|
||||
|
||||
**SKILL.md**:
|
||||
```markdown
|
||||
---
|
||||
name: email-drafting
|
||||
description: "Skill pentru compunerea de email-uri profesionale: business, recrutare, networking, follow-ups."
|
||||
---
|
||||
|
||||
# Email Drafting Skill
|
||||
|
||||
## Când să Folosești
|
||||
|
||||
- "Scrie-mi un email către..."
|
||||
- "Cum răspund la..."
|
||||
- Networking outreach
|
||||
- Follow-up messages
|
||||
|
||||
## Proces de Execuție
|
||||
|
||||
### Pas 1: Înțelege Contextul
|
||||
|
||||
**Întrebări cheie**:
|
||||
- Cui scrii? (rol, relație)
|
||||
- Ce vrei să obții?
|
||||
- Ce ton e potrivit?
|
||||
- Cât de formal?
|
||||
|
||||
### Pas 2: Structură Email
|
||||
|
||||
**Template standard**:
|
||||
```
|
||||
Subject: [Clear, specific, action-oriented]
|
||||
|
||||
[Greeting],
|
||||
|
||||
[Opening - context/reference]
|
||||
|
||||
[Body - main message in 2-3 paragraphs]
|
||||
|
||||
[Call to action - specific ask]
|
||||
|
||||
[Closing],
|
||||
[Signature]
|
||||
```
|
||||
|
||||
[...continuă cu exemple]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Upgrade Skills Existente
|
||||
|
||||
### Adăugare Funcționalitate Nouă
|
||||
|
||||
1. **Editează SKILL.md**:
|
||||
```bash
|
||||
# Citește skill-ul existent
|
||||
cat .claude/skills/web-research/SKILL.md
|
||||
|
||||
# Editează și adaugă secțiune nouă
|
||||
```
|
||||
|
||||
2. **Adaugă noul proces/pas**
|
||||
|
||||
3. **Actualizează versiunea**:
|
||||
```markdown
|
||||
**Versiune**: 1.1 ← increment
|
||||
**Ultima actualizare**: 2025-01-XX
|
||||
**Changelog**:
|
||||
- v1.1: Adăugat suport pentru [feature]
|
||||
- v1.0: Versiune inițială
|
||||
```
|
||||
|
||||
### Îmbunătățire Exemple
|
||||
|
||||
Adaugă mai multe exemple în secțiunea "Exemple Complete":
|
||||
|
||||
```markdown
|
||||
### Exemplu 3: [Nou Scenariu]
|
||||
|
||||
[Descriere completă]
|
||||
```
|
||||
|
||||
### Adăugare Troubleshooting
|
||||
|
||||
În secțiunea "Troubleshooting", adaugă noi probleme rezolvate:
|
||||
|
||||
```markdown
|
||||
### Problem: [Problemă nouă descoperită]
|
||||
|
||||
**Cauză**: [De ce se întâmplă]
|
||||
**Soluție**: [Pași de rezolvare]
|
||||
**Prevenire**: [Cum să eviți în viitor]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Upgrade Sistem General
|
||||
|
||||
### 1. Adăugare Nou Subsistem
|
||||
|
||||
**Exemplu**: Adăugare "Templates System"
|
||||
|
||||
```bash
|
||||
mkdir -p .claude/context/templates/
|
||||
```
|
||||
|
||||
Creează `templates/claude.md`:
|
||||
```markdown
|
||||
# Templates System
|
||||
|
||||
## Scop
|
||||
[Descriere subsistem nou]
|
||||
|
||||
## Când să folosești
|
||||
[Situații]
|
||||
|
||||
## Template-uri disponibile
|
||||
- template-1
|
||||
- template-2
|
||||
```
|
||||
|
||||
Actualizează `context/claude.md`:
|
||||
```markdown
|
||||
### 5. Templates System (`~/.claude/context/templates/`)
|
||||
|
||||
**Scop**: [Scurt]
|
||||
**Când să folosești**: [Scurt]
|
||||
**Cum să accesezi**: [Instrucțiuni]
|
||||
```
|
||||
|
||||
### 2. Adăugare Nou Tip Proiect
|
||||
|
||||
```bash
|
||||
mkdir -p .claude/context/projects/[new-type]/
|
||||
```
|
||||
|
||||
**Exemple**:
|
||||
- `projects/finance/` - Analiză financiară
|
||||
- `projects/marketing/` - Marketing content
|
||||
- `projects/coding/` - Development projects
|
||||
|
||||
Creează `projects/[type]/claude.md` cu workflow specific.
|
||||
|
||||
### 3. Upgrade Tools Documentation
|
||||
|
||||
Editează `context/tools/claude.md`:
|
||||
|
||||
```markdown
|
||||
### [Număr]. [Nume Tool Nou]
|
||||
|
||||
**Scop**: [Ce face]
|
||||
|
||||
**Când să folosești**: [Situații]
|
||||
|
||||
**Sintaxă**:
|
||||
```
|
||||
[Cod exemplu]
|
||||
```
|
||||
|
||||
**Best Practices**:
|
||||
- Practice 1
|
||||
- Practice 2
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Checklist Post-Adăugare
|
||||
|
||||
După ce adaugi un skill nou:
|
||||
|
||||
- [ ] SKILL.md creat cu YAML frontmatter valid
|
||||
- [ ] Toate secțiunile completate (minimum: Prezentare, Când să folosești, Proces, Exemple)
|
||||
- [ ] Minim 2 exemple complete incluse
|
||||
- [ ] Troubleshooting section adăugată
|
||||
- [ ] context/claude.md actualizat cu noul skill
|
||||
- [ ] Testat skill-ul într-o conversație
|
||||
- [ ] Documentat în memory/learnings.md dacă e relevant
|
||||
|
||||
---
|
||||
|
||||
## Tips pentru Skills de Calitate
|
||||
|
||||
### ✅ Best Practices
|
||||
|
||||
1. **Claritate**: Scrie de parcă utilizatorul nu știe nimic despre task
|
||||
2. **Completitudine**: Include toate edge cases
|
||||
3. **Exemple**: Minimum 2, ideal 3-4 scenarii diferite
|
||||
4. **Troubleshooting**: Anticipează problemele comune
|
||||
5. **Tools specifice**: Listează exact ce tools folosești
|
||||
6. **Integrare**: Menționează cum se combină cu alte skills
|
||||
|
||||
### ❌ Ce să Eviți
|
||||
|
||||
1. **Ambiguitate**: "Fă cercetare bună" (prea vag)
|
||||
2. **Presupuneri**: Nu presupune cunoștințe implicite
|
||||
3. **Lips exemple**: Skill fără exemple concrete
|
||||
4. **Overflow**: Nu încărca TOT într-un singur skill (păstrează modular)
|
||||
5. **Duplicate**: Nu duplica logic din alte skills
|
||||
|
||||
---
|
||||
|
||||
## Versioning Skills
|
||||
|
||||
**Schema**: `MAJOR.MINOR`
|
||||
|
||||
- **MAJOR** (1.0 → 2.0): Schimbări majore în proces/workflow
|
||||
- **MINOR** (1.0 → 1.1): Adăugare features, îmbunătățiri
|
||||
|
||||
**Changelog format**:
|
||||
```markdown
|
||||
**Changelog**:
|
||||
- v1.2: Adăugat suport pentru format X
|
||||
- v1.1: Îmbunătățit troubleshooting section
|
||||
- v1.0: Versiune inițială
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Testare Skills Noi
|
||||
|
||||
### Test Manual
|
||||
|
||||
1. **Citește skill-ul** într-o conversație nouă
|
||||
2. **Execută task-ul** urmând pașii din skill
|
||||
3. **Verifică output-ul** vs. așteptări
|
||||
4. **Documentează** orice probleme în troubleshooting
|
||||
|
||||
### Test Integrat
|
||||
|
||||
1. **Combină cu alte skills**
|
||||
2. **Verifică flow-ul** natural între skills
|
||||
3. **Testează edge cases**
|
||||
|
||||
---
|
||||
|
||||
## Resurse
|
||||
|
||||
- **Template blank**: Vezi secțiunea "Template" de mai sus
|
||||
- **Exemple existente**: `.claude/skills/web-research/` și `.claude/skills/research-report/`
|
||||
- **Documentație**: `.claude/context/claude.md`
|
||||
|
||||
---
|
||||
|
||||
**Întrebări?** Consultă `context/claude.md` sau creează un issue în memory/learnings.md
|
||||
219
.claude/docs/QUICK-REFERENCE.md
Normal file
219
.claude/docs/QUICK-REFERENCE.md
Normal file
@@ -0,0 +1,219 @@
|
||||
# Nova PAI - Quick Reference Card
|
||||
|
||||
## 🚀 Adăugare Skill Nou - 4 Pași
|
||||
|
||||
```bash
|
||||
# 1. Creează directorul
|
||||
mkdir -p .claude/skills/[nume-skill]/
|
||||
|
||||
# 2. Creează SKILL.md
|
||||
cat > .claude/skills/[nume-skill]/SKILL.md << 'EOF'
|
||||
---
|
||||
name: [nume-skill]
|
||||
description: "Scurtă descriere (max 2 fraze)"
|
||||
---
|
||||
|
||||
# [Nume] Skill
|
||||
|
||||
## Prezentare
|
||||
[Ce face skill-ul]
|
||||
|
||||
## Când să Folosești
|
||||
- Situație 1
|
||||
- Situație 2
|
||||
|
||||
## Proces de Execuție
|
||||
|
||||
### Pas 1: [Nume]
|
||||
[Descriere]
|
||||
|
||||
### Pas 2: [Nume]
|
||||
[Descriere]
|
||||
|
||||
## Exemple Complete
|
||||
|
||||
### Exemplu 1: [Scenariu]
|
||||
**Input**: "..."
|
||||
**Output**: ...
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Problem: [Problemă]
|
||||
**Soluție**: [Fix]
|
||||
|
||||
---
|
||||
**Versiune**: 1.0
|
||||
**Ultima actualizare**: [DATA]
|
||||
EOF
|
||||
|
||||
# 3. Actualizează context/claude.md
|
||||
# Adaugă în lista "Skills disponibile":
|
||||
# - `[nume-skill]/` - [Descriere]
|
||||
|
||||
# 4. Testează
|
||||
# În conversație: "Folosește skill-ul [nume-skill] pentru..."
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📁 Structura Fișiere
|
||||
|
||||
### Skill Simplu
|
||||
```
|
||||
.claude/skills/[nume]/
|
||||
└── SKILL.md
|
||||
```
|
||||
|
||||
### Skill Complex
|
||||
```
|
||||
.claude/skills/[nume]/
|
||||
├── SKILL.md
|
||||
├── template.md
|
||||
├── examples/
|
||||
│ ├── example1.md
|
||||
│ └── example2.md
|
||||
└── reference.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Upgrade Sistem
|
||||
|
||||
### Adaugă Subsistem Nou
|
||||
```bash
|
||||
mkdir -p .claude/context/[subsistem]/
|
||||
# Creează [subsistem]/claude.md
|
||||
# Actualizează context/claude.md secțiunea "Subsisteme Disponibile"
|
||||
```
|
||||
|
||||
### Adaugă Tip Proiect Nou
|
||||
```bash
|
||||
mkdir -p .claude/context/projects/[tip]/
|
||||
# Creează [tip]/claude.md cu workflow specific
|
||||
# Actualizează context/claude.md
|
||||
```
|
||||
|
||||
### Adaugă Tool Documentation
|
||||
```bash
|
||||
# Editează .claude/context/tools/claude.md
|
||||
# Adaugă secțiune nouă cu sintaxă și best practices
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 Template YAML Frontmatter
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: skill-name
|
||||
description: "Concise description in 1-2 sentences"
|
||||
version: "1.0"
|
||||
author: "Your Name"
|
||||
tags: ["tag1", "tag2"]
|
||||
requires: ["other-skill"] # optional
|
||||
---
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Checklist Post-Skill
|
||||
|
||||
- [ ] YAML frontmatter valid
|
||||
- [ ] Secțiune "Când să folosești"
|
||||
- [ ] Proces în pași numerotați
|
||||
- [ ] Minimum 2 exemple
|
||||
- [ ] Troubleshooting section
|
||||
- [ ] context/claude.md actualizat
|
||||
- [ ] Testat în conversație
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Skills Ideas
|
||||
|
||||
### Development
|
||||
- `code-review` - Review cod profesional
|
||||
- `debug-assistant` - Debugging workflow
|
||||
- `api-design` - Design REST APIs
|
||||
- `test-generation` - Generare teste
|
||||
|
||||
### Data & Analysis
|
||||
- `data-analysis` - Pandas, numpy, stats
|
||||
- `visualization` - Charts, graphs
|
||||
- `sql-query` - Query optimization
|
||||
- `data-cleaning` - Preprocessing data
|
||||
|
||||
### Content & Communication
|
||||
- `email-drafting` - Email profesionale
|
||||
- `presentation` - Slides și prezentări
|
||||
- `documentation` - Docs tehnice
|
||||
- `copywriting` - Marketing copy
|
||||
|
||||
### Business
|
||||
- `market-research` - Analiză piață
|
||||
- `competitive-analysis` - Analiză competitori
|
||||
- `financial-analysis` - Analiză financiară
|
||||
- `business-plan` - Business planning
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Workflow Adăugare
|
||||
|
||||
```
|
||||
Idee Skill → Template → Scriere → Test → Update Context → Deploy
|
||||
↓ ↓ ↓ ↓ ↓ ↓
|
||||
Validare SKILL.md Content Manual claude.md Production
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📚 Fișiere Importante
|
||||
|
||||
| Fișier | Scop | Când Modifici |
|
||||
|--------|------|---------------|
|
||||
| `context/claude.md` | Master doc | La fiecare skill nou |
|
||||
| `output_style.md` | Identitate | Schimbări personalitate |
|
||||
| `context/tools/claude.md` | Tools docs | Tool nou/updated |
|
||||
| `memory/learnings.md` | Învățări | Post probleme rezolvate |
|
||||
|
||||
---
|
||||
|
||||
## 💡 Tips
|
||||
|
||||
### ✅ DO
|
||||
- Păstrează skills modulare și focusate
|
||||
- Include multe exemple
|
||||
- Documentează edge cases
|
||||
- Testează înainte de deploy
|
||||
|
||||
### ❌ DON'T
|
||||
- Nu face skills prea largi
|
||||
- Nu duplica logică din alte skills
|
||||
- Nu uita să updatezi context/claude.md
|
||||
- Nu omite troubleshooting
|
||||
|
||||
---
|
||||
|
||||
## 🆘 Help
|
||||
|
||||
**Documentație completă**: `.claude/docs/HOW-TO-ADD-SKILLS.md`
|
||||
**Exemple**: `.claude/skills/web-research/` și `/research-report/`
|
||||
**Arhitectură**: `.claude/context/claude.md`
|
||||
**README general**: `.claude/README.md`
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Links Rapide
|
||||
|
||||
```bash
|
||||
# Vezi toate skills
|
||||
ls -la .claude/skills/
|
||||
|
||||
# Citește arhitectura
|
||||
cat .claude/context/claude.md
|
||||
|
||||
# Ghid complet
|
||||
cat .claude/docs/HOW-TO-ADD-SKILLS.md
|
||||
|
||||
# Template skill
|
||||
cat .claude/docs/HOW-TO-ADD-SKILLS.md | grep -A50 "Template:"
|
||||
```
|
||||
185
.claude/hooks/load-context.ts
Normal file
185
.claude/hooks/load-context.ts
Normal file
@@ -0,0 +1,185 @@
|
||||
/**
|
||||
* Hook: load-context
|
||||
*
|
||||
* Purpose: Ensures Nova loads the appropriate context before responding
|
||||
* to user requests, implementing the progressive disclosure pattern.
|
||||
*
|
||||
* Trigger: On user prompt submit
|
||||
*
|
||||
* This hook injects instructions to load context files based on the
|
||||
* task type and requirements.
|
||||
*/
|
||||
|
||||
/**
|
||||
* IMPLEMENTATION NOTE:
|
||||
*
|
||||
* Claude Code hooks may differ from the Anthropic SDK shown below.
|
||||
* This is a conceptual implementation that demonstrates the intended behavior.
|
||||
*
|
||||
* For Claude Code, hooks might be configured differently. This file serves as:
|
||||
* 1. Documentation of the intended behavior
|
||||
* 2. Reference for manual context loading
|
||||
* 3. Template for future hook implementation
|
||||
*
|
||||
* MANUAL ALTERNATIVE:
|
||||
* If hooks aren't supported, Nova should manually check at conversation start:
|
||||
* - Have I read .claude/context/claude.md in THIS conversation?
|
||||
* - If not, read it immediately
|
||||
* - Load relevant subsystems based on the task
|
||||
*/
|
||||
|
||||
// Conceptual Hook Implementation
|
||||
export default {
|
||||
name: 'load-context',
|
||||
version: '1.0',
|
||||
|
||||
/**
|
||||
* This function would be called before Nova sees the user's message
|
||||
*/
|
||||
async onUserPromptSubmit(context: any) {
|
||||
// Check if this is the first message in the conversation
|
||||
const isFirstMessage = context.conversationHistory.length === 0;
|
||||
|
||||
// Construct context loading reminder
|
||||
const contextReminder = `
|
||||
🔄 CONTEXT LOADING PROTOCOL
|
||||
|
||||
Before responding to this message, follow these steps:
|
||||
|
||||
1. ✅ Have you read ~/.claude/context/claude.md in THIS conversation?
|
||||
- If NO: Read it now with the Read tool
|
||||
- If YES: Proceed to step 2
|
||||
|
||||
2. ✅ Analyze the user's request to identify:
|
||||
- Task type (research, report, analysis, etc.)
|
||||
- Required skills (web-research, research-report, etc.)
|
||||
- Relevant context subsystems (projects, tools, memory)
|
||||
|
||||
3. ✅ Load ONLY the relevant context files (progressive disclosure):
|
||||
- For research tasks: Read context/projects/research/claude.md
|
||||
- For web searches: Read skills/web-research/SKILL.md
|
||||
- For report generation: Read skills/research-report/SKILL.md
|
||||
- If using tools: Read context/tools/claude.md
|
||||
- For repeat patterns: Read context/memory/claude.md
|
||||
|
||||
4. ✅ Proceed with the task using the loaded context
|
||||
|
||||
DO NOT:
|
||||
- Skip reading context files
|
||||
- Load all context at once
|
||||
- Claim you've read files without actually using Read tool
|
||||
- Ignore the progressive disclosure principle
|
||||
|
||||
---
|
||||
User's message:
|
||||
`;
|
||||
|
||||
// For first message, add stronger reminder
|
||||
if (isFirstMessage) {
|
||||
return {
|
||||
...context,
|
||||
userMessage: contextReminder + context.userMessage,
|
||||
metadata: {
|
||||
...context.metadata,
|
||||
contextLoadingRequired: true,
|
||||
firstMessage: true
|
||||
}
|
||||
};
|
||||
}
|
||||
|
||||
// For subsequent messages, lighter reminder
|
||||
const lightReminder = `
|
||||
[System: Remember to load relevant context files if tackling a new type of task]
|
||||
|
||||
`;
|
||||
|
||||
return {
|
||||
...context,
|
||||
userMessage: lightReminder + context.userMessage
|
||||
};
|
||||
},
|
||||
|
||||
/**
|
||||
* Optional: After Nova responds, check if context was properly loaded
|
||||
*/
|
||||
async onAssistantResponse(context: any) {
|
||||
// This could verify that appropriate Read calls were made
|
||||
// and warn if context loading was skipped
|
||||
|
||||
const readCalls = context.toolCalls?.filter((call: any) =>
|
||||
call.tool === 'Read' && call.parameters.file_path.includes('.claude/context')
|
||||
) || [];
|
||||
|
||||
if (context.metadata?.contextLoadingRequired && readCalls.length === 0) {
|
||||
console.warn('Warning: Context loading was required but no context files were read');
|
||||
}
|
||||
|
||||
return context;
|
||||
}
|
||||
};
|
||||
|
||||
/**
|
||||
* CONFIGURATION INSTRUCTIONS:
|
||||
*
|
||||
* To enable this hook in Claude Code:
|
||||
*
|
||||
* 1. Check Claude Code documentation for hook configuration
|
||||
* 2. Register this hook in the appropriate config file
|
||||
* 3. Restart Claude Code or reload configuration
|
||||
*
|
||||
* If hooks are not supported:
|
||||
* - Add instructions to output_style.md
|
||||
* - Rely on context/claude.md instructions
|
||||
* - Manually prompt for context loading at conversation start
|
||||
*/
|
||||
|
||||
/**
|
||||
* TESTING:
|
||||
*
|
||||
* To test if the hook is working:
|
||||
*
|
||||
* Test 1: Start new conversation
|
||||
* User: "Hello"
|
||||
* Expected: Nova should mention reading context/claude.md
|
||||
*
|
||||
* Test 2: Research task
|
||||
* User: "Research quantum computing"
|
||||
* Expected: Nova should read context/claude.md, projects/research/, and web-research skill
|
||||
*
|
||||
* Test 3: Continuation
|
||||
* User: "Now make a report"
|
||||
* Expected: Nova should read research-report skill (new task type)
|
||||
*/
|
||||
|
||||
/**
|
||||
* FALLBACK STRATEGY:
|
||||
*
|
||||
* If hooks don't work, add this to output_style.md:
|
||||
*
|
||||
* ```
|
||||
* MANDATORY BEHAVIOR:
|
||||
* At the start of EVERY conversation, you MUST:
|
||||
* 1. Read ~/.claude/context/claude.md
|
||||
* 2. Understand available subsystems
|
||||
* 3. Load relevant context based on user's request
|
||||
*
|
||||
* For EVERY new task type, you MUST:
|
||||
* 1. Check if you need additional context
|
||||
* 2. Read relevant skill or context files
|
||||
* 3. Follow the progressive disclosure pattern
|
||||
* ```
|
||||
*/
|
||||
|
||||
// Type definitions for reference
|
||||
interface ConversationContext {
|
||||
userMessage: string;
|
||||
conversationHistory: Array<any>;
|
||||
metadata?: {
|
||||
contextLoadingRequired?: boolean;
|
||||
firstMessage?: boolean;
|
||||
};
|
||||
toolCalls?: Array<{
|
||||
tool: string;
|
||||
parameters: any;
|
||||
}>;
|
||||
}
|
||||
32
.claude/output_style.md
Normal file
32
.claude/output_style.md
Normal file
@@ -0,0 +1,32 @@
|
||||
# Nova - Asistent Personal de Cercetare
|
||||
|
||||
Tu ești **Nova**, un asistent personal de cercetare și analiză.
|
||||
|
||||
## Identitate și Rol
|
||||
|
||||
- **Rol Principal**: Ajuți utilizatorul să cerceteze subiecte complexe, să analizeze informații și să genereze rapoarte profesionale
|
||||
- **Expertiză**: Cercetare web, analiză de conținut, sinteză de informații, raportare structurată
|
||||
- **Limbă**: Răspunzi în română implicit, dar poți lucra și în engleză când e necesar
|
||||
|
||||
## Stil de Comunicare
|
||||
|
||||
- Profesional dar accesibil
|
||||
- Concis în conversații, detaliat în rapoarte
|
||||
- Transparent despre procesul de lucru
|
||||
- Proactiv în sugestii și optimizări
|
||||
|
||||
## Comportament
|
||||
|
||||
- Întotdeauna citești contextul sistemului înainte de a răspunde
|
||||
- Folosești progressive disclosure pentru a încărca doar contextul necesar
|
||||
- Documentezi procesul de lucru în fișiere de memorie
|
||||
- Întrebi clarificări când task-ul este ambiguu
|
||||
|
||||
## Acces la Context
|
||||
|
||||
Ai acces la:
|
||||
- Sistemul de context din `~/.claude/context/`
|
||||
- Skills specializate din `~/.claude/skills/`
|
||||
- Memorie persistentă pentru a învăța preferințele utilizatorului
|
||||
|
||||
**IMPORTANT**: Înainte de orice task major, citește `~/.claude/context/claude.md` pentru a înțelege arhitectura sistemului.
|
||||
377
.claude/skills/research-report/SKILL.md
Normal file
377
.claude/skills/research-report/SKILL.md
Normal file
@@ -0,0 +1,377 @@
|
||||
---
|
||||
name: research-report
|
||||
description: "Skill pentru generarea de rapoarte profesionale de cercetare în format Markdown sau DOCX. Folosește după ce ai finalizat cercetarea și ai toate informațiile."
|
||||
---
|
||||
|
||||
# Research Report Generation Skill
|
||||
|
||||
## Prezentare
|
||||
|
||||
Acest skill te ghidează în crearea de rapoarte profesionale, bine structurate și formatate pentru cercetările efectuate.
|
||||
|
||||
## Când să Folosești
|
||||
|
||||
- Ai finalizat cercetarea cu `web-research` skill
|
||||
- Utilizatorul cere explicit un raport
|
||||
- Ai suficiente informații pentru un document complet (5+ surse)
|
||||
- Task necesită documentare formală
|
||||
|
||||
## Pre-requisite
|
||||
|
||||
Înainte de a genera raportul, asigură-te că ai:
|
||||
- ✅ Minim 5 surse credibile
|
||||
- ✅ Informații cheie extrase și organizate
|
||||
- ✅ Analiză și sinteză completă
|
||||
- ✅ Lista completă de surse cu URL-uri
|
||||
|
||||
## Structura Raportului
|
||||
|
||||
### Template Standard
|
||||
|
||||
```markdown
|
||||
# [TITLU RAPORT]
|
||||
|
||||
**Autor**: Nova (Asistent AI)
|
||||
**Data**: [DATA]
|
||||
**Subiect**: [SUBIECT CERCETARE]
|
||||
|
||||
---
|
||||
|
||||
## Executive Summary
|
||||
|
||||
[2-3 paragrafe care rezumă întregul raport]
|
||||
[Răspunde la întrebările: Ce? De ce e important? Ce am descoperit? Ce înseamnă asta?]
|
||||
|
||||
---
|
||||
|
||||
## 1. Introducere
|
||||
|
||||
### 1.1 Context și Motivație
|
||||
[De ce e relevant acest subiect?]
|
||||
[Ce problemă sau întrebare adresează?]
|
||||
|
||||
### 1.2 Obiective
|
||||
[Ce vrem să aflăm?]
|
||||
[Ce întrebări specifice răspundem?]
|
||||
|
||||
### 1.3 Scop și Domeniu
|
||||
[Ce acoperă raportul?]
|
||||
[Ce NU acoperă (limitări)?]
|
||||
|
||||
---
|
||||
|
||||
## 2. Metodologie
|
||||
|
||||
### 2.1 Surse de Informații
|
||||
[Ce tipuri de surse am folosit?]
|
||||
- Academice
|
||||
- Profesionale
|
||||
- Industrie
|
||||
- etc.
|
||||
|
||||
### 2.2 Criterii de Selecție
|
||||
[Cum am evaluat credibilitatea?]
|
||||
[Cum am filtrat informațiile?]
|
||||
|
||||
### 2.3 Perioada Analizată
|
||||
[Ce interval de timp?]
|
||||
[De ce acest interval?]
|
||||
|
||||
---
|
||||
|
||||
## 3. Descoperiri Principale
|
||||
|
||||
### 3.1 [Tema/Descoperire 1]
|
||||
|
||||
**Context**:
|
||||
[Explicație și background]
|
||||
|
||||
**Detalii Cheie**:
|
||||
- [Punct important 1]
|
||||
- [Punct important 2]
|
||||
- [Statistici/date relevante]
|
||||
|
||||
**Surse**:
|
||||
- [Sursă 1] - [Author, Date]
|
||||
- [Sursă 2] - [Author, Date]
|
||||
|
||||
### 3.2 [Tema/Descoperire 2]
|
||||
|
||||
[Repetă structura]
|
||||
|
||||
### 3.3 [Tema/Descoperire 3]
|
||||
|
||||
[Repetă structura]
|
||||
|
||||
---
|
||||
|
||||
## 4. Analiză și Implicații
|
||||
|
||||
### 4.1 Pattern-uri Identificate
|
||||
[Ce teme comune am găsit?]
|
||||
[Ce legături există între descoperiri?]
|
||||
|
||||
### 4.2 Perspective Multiple
|
||||
[Unde există consens?]
|
||||
[Unde există dezacord?]
|
||||
[De ce există aceste diferențe?]
|
||||
|
||||
### 4.3 Implicații Practice
|
||||
[Ce înseamnă aceste descoperiri în practică?]
|
||||
[Cine e afectat și cum?]
|
||||
[Ce oportunități sau riscuri există?]
|
||||
|
||||
---
|
||||
|
||||
## 5. Provocări și Limitări
|
||||
|
||||
### 5.1 Provocări Identificate
|
||||
[Ce obstacole sau probleme am descoperit?]
|
||||
|
||||
### 5.2 Limitări ale Cercetării
|
||||
[Ce nu am putut acoperi?]
|
||||
[Ce întrebări rămân deschise?]
|
||||
[Ce surse ne-au lipsit?]
|
||||
|
||||
---
|
||||
|
||||
## 6. Concluzii
|
||||
|
||||
### 6.1 Sinteza Descoperirilor
|
||||
[Care sunt cele mai importante takeaways?]
|
||||
[Cum răspundem la întrebările inițiale?]
|
||||
|
||||
### 6.2 Perspective de Viitor
|
||||
[Cum ar putea evolua situația?]
|
||||
[Ce ar trebui monitorizat?]
|
||||
|
||||
---
|
||||
|
||||
## 7. Recomandări
|
||||
|
||||
[Dacă e relevant pentru task]
|
||||
|
||||
### 7.1 Pentru Practicieni
|
||||
[Acțiuni concrete pentru cei care implementează]
|
||||
|
||||
### 7.2 Pentru Cercetare Viitoare
|
||||
[Ce domenii necesită mai multă cercetare?]
|
||||
|
||||
---
|
||||
|
||||
## 8. Referințe și Surse
|
||||
|
||||
### Surse Principale
|
||||
|
||||
1. **[Titlu Articol/Paper]**
|
||||
- Autor(i): [...]
|
||||
- Publicat: [Data]
|
||||
- URL: [Link complet]
|
||||
- Relevență: [De ce e important această sursă]
|
||||
|
||||
2. **[Titlu Articol/Paper]**
|
||||
[Repetă formatul]
|
||||
|
||||
### Surse Secundare
|
||||
|
||||
[Liste surse adiționale consultate dar nu citate direct]
|
||||
|
||||
---
|
||||
|
||||
## Anexe
|
||||
|
||||
### Anexa A: [Titlu]
|
||||
[Informații suplimentare, tabele, grafice]
|
||||
|
||||
### Anexa B: [Titlu]
|
||||
[Alte informații relevante]
|
||||
|
||||
---
|
||||
|
||||
**Note**:
|
||||
- [Orice note metodologice sau clarificări]
|
||||
- [Disclaimer-e dacă e necesar]
|
||||
|
||||
**Contact**: Pentru întrebări despre acest raport, contactează [...]
|
||||
```
|
||||
|
||||
## Generare Raport
|
||||
|
||||
### Pas 1: Pregătire Conținut
|
||||
|
||||
1. **Organizează informațiile colectate**:
|
||||
- Grupează pe teme/secțiuni
|
||||
- Ordonează logic
|
||||
- Identifică ce merge în ce secțiune
|
||||
|
||||
2. **Pregătește citatiile**:
|
||||
- Formatează toate sursele
|
||||
- Verifică că ai URL-uri complete
|
||||
- Asigură-te că ai date/autori
|
||||
|
||||
### Pas 2: Scriere
|
||||
|
||||
**Best Practices**:
|
||||
|
||||
✅ **DO**:
|
||||
- Folosește limbaj clar și profesional
|
||||
- Fii concis dar complet
|
||||
- Structurează în paragrafe scurte (3-5 fraze)
|
||||
- Folosește liste pentru enumerări
|
||||
- Include headere și sub-headere clare
|
||||
- Citează sursele în context
|
||||
- Parafrazează, nu copia verbatim
|
||||
|
||||
❌ **DON'T**:
|
||||
- Nu folosi jargon fără explicații
|
||||
- Nu face paragrafe lungi (>7 fraze)
|
||||
- Nu ignora conflicte între surse
|
||||
- Nu omite limitările cercetării
|
||||
- Nu exagera concluziile
|
||||
- Nu copia text din surse
|
||||
|
||||
### Pas 3: Formatare
|
||||
|
||||
#### Pentru Markdown (.md)
|
||||
|
||||
```markdown
|
||||
# Folosește headere ierarhic
|
||||
## Nivel 2
|
||||
### Nivel 3
|
||||
|
||||
**Bold pentru accent**
|
||||
*Italic pentru emphasis*
|
||||
|
||||
- Liste cu bullet points
|
||||
- Pentru enumerări
|
||||
|
||||
1. Liste numerotate
|
||||
2. Pentru pași sau ordine
|
||||
|
||||
> Blockquotes pentru citate importante
|
||||
|
||||
`code` pentru termeni tehnici
|
||||
|
||||
[Link text](URL) pentru referințe
|
||||
```
|
||||
|
||||
### Pas 4: Salvare
|
||||
|
||||
```
|
||||
// ÎNTOTDEAUNA salvează în working directory sau outputs
|
||||
Write({
|
||||
file_path: "/mnt/e/proiecte/pai/outputs/raport-[subiect]-[data].md",
|
||||
content: "[conținut complet]"
|
||||
})
|
||||
```
|
||||
|
||||
**Nomenclatură fișiere**:
|
||||
- ✅ `raport-ai-education-2025-01.md`
|
||||
- ✅ `research-blockchain-healthcare.md`
|
||||
- ❌ `raport.md` (prea generic)
|
||||
- ❌ `my document final v2.md` (naming haotic)
|
||||
|
||||
## Verificare Finală
|
||||
|
||||
Înainte de a prezenta raportul utilizatorului, verifică:
|
||||
|
||||
- [ ] Executive summary prezent și clar
|
||||
- [ ] Toate secțiunile completate
|
||||
- [ ] Minim 5 surse citate
|
||||
- [ ] Surse formatate corect
|
||||
- [ ] Concluzii bazate pe date
|
||||
- [ ] Limitări menționate
|
||||
- [ ] Fără copy-paste din surse
|
||||
- [ ] Fără greșeli gramaticale majore
|
||||
- [ ] Salvat cu nume descriptiv
|
||||
- [ ] Link către fișier furnizat utilizatorului
|
||||
|
||||
## Prezentare către Utilizator
|
||||
|
||||
După generare:
|
||||
|
||||
```markdown
|
||||
✅ Am finalizat cercetarea și raportul!
|
||||
|
||||
**Raport generat**: [Link către fișier]
|
||||
|
||||
**Rezumat rapid**:
|
||||
- [Bullet point 1 - descoperire principală]
|
||||
- [Bullet point 2 - descoperire principală]
|
||||
- [Bullet point 3 - descoperire principală]
|
||||
|
||||
**Detalii**:
|
||||
- Surse analizate: [X]
|
||||
- Lungime raport: [Y] pagini/secțiuni
|
||||
- Format: Markdown
|
||||
|
||||
Raportul include analiză detaliată, implicații practice, și liste complete de surse.
|
||||
```
|
||||
|
||||
## Exemple Complete
|
||||
|
||||
### Exemplu 1: Raport Simplu
|
||||
|
||||
**Input**: "Cercetează despre machine learning în retail și fă raport"
|
||||
|
||||
**Output**: Raport de 5-7 pagini cu:
|
||||
- Executive summary
|
||||
- Overview ML în retail
|
||||
- Use cases principale
|
||||
- Beneficii și provocări
|
||||
- Case studies
|
||||
- Concluzii
|
||||
- 8 surse citate
|
||||
|
||||
### Exemplu 2: Raport Comparativ
|
||||
|
||||
**Input**: "Compară soluțiile de cloud computing pentru startups"
|
||||
|
||||
**Output**: Raport de 8-10 pagini cu:
|
||||
- Executive summary
|
||||
- Criterii de comparație
|
||||
- AWS vs Azure vs GCP
|
||||
- Tabel comparativ
|
||||
- Recomandări pe use case
|
||||
- Analiza costurilor
|
||||
- 12 surse citate
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Problem: Raport prea scurt
|
||||
|
||||
**Soluție**:
|
||||
- Expandează fiecare secțiune
|
||||
- Adaugă mai mult context
|
||||
- Include mai multe exemple
|
||||
- Extinde analiza
|
||||
|
||||
### Problem: Prea multe informații
|
||||
|
||||
**Soluție**:
|
||||
- Focusează pe cele mai relevante
|
||||
- Mută detalii în anexe
|
||||
- Rezumă în loc să descrii tot
|
||||
- Prioritizează descoperiri cheie
|
||||
|
||||
### Problem: Surse insuficiente
|
||||
|
||||
**Soluție**:
|
||||
- Întoarce-te la cercetare
|
||||
- Caută pe niche topics
|
||||
- Consultă surse academice
|
||||
- Verifică bibliografii din surse existente
|
||||
|
||||
## Note Finale
|
||||
|
||||
**Amintește-ți**:
|
||||
- Un raport bun e echilibrat între detaliu și conciziune
|
||||
- Obiectivitatea e crucială
|
||||
- Structura face raportul ușor de parcurs
|
||||
- Sursele bune fac raportul credibil
|
||||
- Analiza face raportul valoros
|
||||
|
||||
---
|
||||
|
||||
**Versiune**: 1.0
|
||||
**Ultima actualizare**: 2025-01-06
|
||||
164
.claude/skills/research-report/report-structure-template.md
Normal file
164
.claude/skills/research-report/report-structure-template.md
Normal file
@@ -0,0 +1,164 @@
|
||||
# [TITLU RAPORT]
|
||||
|
||||
**Autor**: Nova (Asistent AI)
|
||||
**Data**: [DATA]
|
||||
**Subiect**: [SUBIECT CERCETARE]
|
||||
|
||||
---
|
||||
|
||||
## Executive Summary
|
||||
|
||||
[2-3 paragrafe care rezumă întregul raport]
|
||||
[Răspunde la întrebările: Ce? De ce e important? Ce am descoperit? Ce înseamnă asta?]
|
||||
|
||||
---
|
||||
|
||||
## 1. Introducere
|
||||
|
||||
### 1.1 Context și Motivație
|
||||
[De ce e relevant acest subiect?]
|
||||
[Ce problemă sau întrebare adresează?]
|
||||
|
||||
### 1.2 Obiective
|
||||
[Ce vrem să aflăm?]
|
||||
[Ce întrebări specifice răspundem?]
|
||||
|
||||
### 1.3 Scop și Domeniu
|
||||
[Ce acoperă raportul?]
|
||||
[Ce NU acoperă (limitări)?]
|
||||
|
||||
---
|
||||
|
||||
## 2. Metodologie
|
||||
|
||||
### 2.1 Surse de Informații
|
||||
[Ce tipuri de surse am folosit?]
|
||||
- Academice
|
||||
- Profesionale
|
||||
- Industrie
|
||||
- etc.
|
||||
|
||||
### 2.2 Criterii de Selecție
|
||||
[Cum am evaluat credibilitatea?]
|
||||
[Cum am filtrat informațiile?]
|
||||
|
||||
### 2.3 Perioada Analizată
|
||||
[Ce interval de timp?]
|
||||
[De ce acest interval?]
|
||||
|
||||
---
|
||||
|
||||
## 3. Descoperiri Principale
|
||||
|
||||
### 3.1 [Tema/Descoperire 1]
|
||||
|
||||
**Context**:
|
||||
[Explicație și background]
|
||||
|
||||
**Detalii Cheie**:
|
||||
- [Punct important 1]
|
||||
- [Punct important 2]
|
||||
- [Statistici/date relevante]
|
||||
|
||||
**Surse**:
|
||||
- [Sursă 1] - [Author, Date]
|
||||
- [Sursă 2] - [Author, Date]
|
||||
|
||||
### 3.2 [Tema/Descoperire 2]
|
||||
|
||||
[Repetă structura]
|
||||
|
||||
### 3.3 [Tema/Descoperire 3]
|
||||
|
||||
[Repetă structura]
|
||||
|
||||
---
|
||||
|
||||
## 4. Analiză și Implicații
|
||||
|
||||
### 4.1 Pattern-uri Identificate
|
||||
[Ce teme comune am găsit?]
|
||||
[Ce legături există între descoperiri?]
|
||||
|
||||
### 4.2 Perspective Multiple
|
||||
[Unde există consens?]
|
||||
[Unde există dezacord?]
|
||||
[De ce există aceste diferențe?]
|
||||
|
||||
### 4.3 Implicații Practice
|
||||
[Ce înseamnă aceste descoperiri în practică?]
|
||||
[Cine e afectat și cum?]
|
||||
[Ce oportunități sau riscuri există?]
|
||||
|
||||
---
|
||||
|
||||
## 5. Provocări și Limitări
|
||||
|
||||
### 5.1 Provocări Identificate
|
||||
[Ce obstacole sau probleme am descoperit?]
|
||||
|
||||
### 5.2 Limitări ale Cercetării
|
||||
[Ce nu am putut acoperi?]
|
||||
[Ce întrebări rămân deschise?]
|
||||
[Ce surse ne-au lipsit?]
|
||||
|
||||
---
|
||||
|
||||
## 6. Concluzii
|
||||
|
||||
### 6.1 Sinteza Descoperirilor
|
||||
[Care sunt cele mai importante takeaways?]
|
||||
[Cum răspundem la întrebările inițiale?]
|
||||
|
||||
### 6.2 Perspective de Viitor
|
||||
[Cum ar putea evolua situația?]
|
||||
[Ce ar trebui monitorizat?]
|
||||
|
||||
---
|
||||
|
||||
## 7. Recomandări
|
||||
|
||||
[Dacă e relevant pentru task]
|
||||
|
||||
### 7.1 Pentru Practicieni
|
||||
[Acțiuni concrete pentru cei care implementează]
|
||||
|
||||
### 7.2 Pentru Cercetare Viitoare
|
||||
[Ce domenii necesită mai multă cercetare?]
|
||||
|
||||
---
|
||||
|
||||
## 8. Referințe și Surse
|
||||
|
||||
### Surse Principale
|
||||
|
||||
1. **[Titlu Articol/Paper]**
|
||||
- Autor(i): [...]
|
||||
- Publicat: [Data]
|
||||
- URL: [Link complet]
|
||||
- Relevență: [De ce e important această sursă]
|
||||
|
||||
2. **[Titlu Articol/Paper]**
|
||||
[Repetă formatul]
|
||||
|
||||
### Surse Secundare
|
||||
|
||||
[Liste surse adiționale consultate dar nu citate direct]
|
||||
|
||||
---
|
||||
|
||||
## Anexe
|
||||
|
||||
### Anexa A: [Titlu]
|
||||
[Informații suplimentare, tabele, grafice]
|
||||
|
||||
### Anexa B: [Titlu]
|
||||
[Alte informații relevante]
|
||||
|
||||
---
|
||||
|
||||
**Note**:
|
||||
- [Orice note metodologice sau clarificări]
|
||||
- [Disclaimer-e dacă e necesar]
|
||||
|
||||
**Contact**: Pentru întrebări despre acest raport, contactează [...]
|
||||
265
.claude/skills/web-research/SKILL.md
Normal file
265
.claude/skills/web-research/SKILL.md
Normal file
@@ -0,0 +1,265 @@
|
||||
---
|
||||
name: web-research
|
||||
description: "Skill pentru cercetare web avansată cu focus pe găsirea și evaluarea surselor credibile. Folosește acest skill când utilizatorul cere cercetare pe un subiect, analiză de informații sau găsire de surse."
|
||||
---
|
||||
|
||||
# Web Research Skill
|
||||
|
||||
## Prezentare
|
||||
|
||||
Acest skill te ajută să efectuezi cercetări web profesionale, să evaluezi credibilitatea surselor și să extragi informații relevante.
|
||||
|
||||
## Când să Folosești
|
||||
|
||||
- Utilizatorul cere "cercetează despre..."
|
||||
- Task-uri care necesită informații actualizate
|
||||
- Când ai nevoie de multiple surse pe un subiect
|
||||
- Pentru validare sau verificare de informații
|
||||
|
||||
## Proces de Cercetare
|
||||
|
||||
### Pas 1: Planificare
|
||||
|
||||
**Înainte de a începe căutarea**:
|
||||
|
||||
1. Înțelege exact ce caută utilizatorul:
|
||||
- Ce întrebări specifice trebuie răspunse?
|
||||
- Ce nivel de detaliu e necesar?
|
||||
- Ce tip de surse sunt relevante?
|
||||
|
||||
2. Identifică tipul de cercetare:
|
||||
- **Generală**: Overview complet pe subiect
|
||||
- **Tehnică**: Detalii tehnice, implementări
|
||||
- **Academică**: Studii, cercetări peer-reviewed
|
||||
- **Comercială**: Produse, servicii, piață
|
||||
|
||||
3. Planifică strategia de căutare:
|
||||
- Ce keywords să folosești?
|
||||
- Ce surse să prioritizezi?
|
||||
- Câte surse sunt necesare (minim 5-7)?
|
||||
|
||||
### Pas 2: Căutare Inițială
|
||||
|
||||
**Folosește WebSearch strategic**:
|
||||
|
||||
```
|
||||
// Primul search: Larg, pentru overview
|
||||
WebSearch({ query: "artificial intelligence education" })
|
||||
|
||||
// Al doilea search: Mai specific
|
||||
WebSearch({ query: "AI personalized learning 2024" })
|
||||
|
||||
// Al treilea search: Focus pe aspecte specifice
|
||||
WebSearch({ query: "AI classroom implementation challenges" })
|
||||
```
|
||||
|
||||
**Best Practices pentru Query-uri**:
|
||||
- ✅ Scurte: 2-4 cuvinte
|
||||
- ✅ Specifice: Include termeni tehnici relevanți
|
||||
- ✅ Actuale: Adaugă anul pentru info recentă
|
||||
- ❌ Evită: Întrebări complete sau fraze lungi
|
||||
|
||||
### Pas 3: Evaluare Surse
|
||||
|
||||
**Pentru fiecare rezultat, evaluează**:
|
||||
|
||||
#### Credibilitate (Prioritate ÎNALTĂ)
|
||||
|
||||
**Surse de încredere ridicată** (prioritizează):
|
||||
- 🟢 Academic: Google Scholar, ArXiv, PubMed, IEEE
|
||||
- 🟢 Instituțional: .edu, .gov, organizații internaționale
|
||||
- 🟢 Corporativ oficial: Blog-uri/docs de la companii majore
|
||||
- 🟢 Media credibilă: NYT, BBC, Reuters, The Guardian
|
||||
|
||||
**Surse de încredere medie** (verifică cross-reference):
|
||||
- 🟡 Medium, Towards Data Science
|
||||
- 🟡 Blog-uri profesionale individuale
|
||||
- 🟡 News sites mai mici dar credibile
|
||||
|
||||
**Surse de evitat** (nu cita):
|
||||
- 🔴 Forumuri, Reddit, Quora (doar pentru lead-uri)
|
||||
- 🔴 Site-uri fără autor sau dată
|
||||
- 🔴 Content farms, clickbait
|
||||
- 🔴 Surse evident biased fără disclosure
|
||||
|
||||
#### Relevanță
|
||||
|
||||
- Informația răspunde la întrebarea utilizatorului?
|
||||
- E la nivel de detaliu potrivit?
|
||||
- E actualizată (pentru subiecte care evoluează rapid)?
|
||||
|
||||
#### Acoperire
|
||||
|
||||
- Sursa oferă informații noi față de ce ai deja?
|
||||
- Completează sau contrazice alte surse?
|
||||
|
||||
### Pas 4: Extragere Informații
|
||||
|
||||
**Pentru fiecare sursă relevantă**:
|
||||
|
||||
1. **Folosește WebFetch** pentru a citi conținutul complet:
|
||||
```
|
||||
WebFetch({ url: "https://credible-source.com/article", prompt: "Extract key findings and main arguments" })
|
||||
```
|
||||
|
||||
2. **Extrage informații cheie**:
|
||||
- Fapte principale
|
||||
- Date și statistici
|
||||
- Argumente pro/contra
|
||||
- Limitări menționate
|
||||
- Autori și credențiale
|
||||
|
||||
3. **Documentează sursa**:
|
||||
- URL complet
|
||||
- Titlu
|
||||
- Autor (dacă disponibil)
|
||||
- Dată publicare
|
||||
- Snippet relevant
|
||||
|
||||
### Pas 5: Sinteză
|
||||
|
||||
**După ce ai adunat informații**:
|
||||
|
||||
1. **Organizează pe teme**:
|
||||
- Grupează informații similare
|
||||
- Identifică pattern-uri
|
||||
- Notează contradicții
|
||||
|
||||
2. **Analizează critic**:
|
||||
- Ce e consensul general?
|
||||
- Unde există dezacord?
|
||||
- Ce lipsește din imagine?
|
||||
- Ce asumpții fac sursele?
|
||||
|
||||
3. **Formulează perspective**:
|
||||
- Care e big picture?
|
||||
- Ce implicații au informațiile?
|
||||
- Ce întrebări rămân deschise?
|
||||
|
||||
## Template de Lucru
|
||||
|
||||
### Tracking Sheet Mental
|
||||
|
||||
Pe măsură ce cercetezi, ține minte:
|
||||
|
||||
```
|
||||
Subiect: [...]
|
||||
Întrebări cheie: [...]
|
||||
|
||||
Surse găsite:
|
||||
1. [URL] - [Tip] - [Credibilitate] - [Informații cheie]
|
||||
2. [URL] - [Tip] - [Credibilitate] - [Informații cheie]
|
||||
...
|
||||
|
||||
Pattern-uri identificate:
|
||||
- [...]
|
||||
- [...]
|
||||
|
||||
Gaps în informații:
|
||||
- [...]
|
||||
- [...]
|
||||
```
|
||||
|
||||
## Exemple de Cercetare
|
||||
|
||||
### Exemplu 1: Cercetare Generală
|
||||
|
||||
**Task**: "Cercetează despre blockchain în healthcare"
|
||||
|
||||
**Execuție**:
|
||||
```
|
||||
1. WebSearch({ query: "blockchain healthcare" })
|
||||
→ Overview general, identificare subtopics
|
||||
|
||||
2. WebSearch({ query: "blockchain medical records 2024" })
|
||||
→ Focus pe un use case specific
|
||||
|
||||
3. WebSearch({ query: "blockchain healthcare challenges" })
|
||||
→ Perspective critice, limitări
|
||||
|
||||
4. WebFetch pe 5-7 articole credibile
|
||||
|
||||
5. Sinteză:
|
||||
- Use cases principale
|
||||
- Beneficii și provocări
|
||||
- Stare actuală adoptare
|
||||
- Perspective viitor
|
||||
```
|
||||
|
||||
### Exemplu 2: Cercetare Tehnică
|
||||
|
||||
**Task**: "Cercetează cum funcționează RAG în LLM-uri"
|
||||
|
||||
**Execuție**:
|
||||
```
|
||||
1. WebSearch({ query: "RAG retrieval augmented generation" })
|
||||
→ Overview tehnic
|
||||
|
||||
2. WebSearch({ query: "RAG implementation tutorial" })
|
||||
→ Detalii de implementare
|
||||
|
||||
3. WebSearch({ query: "RAG vs fine-tuning LLM" })
|
||||
→ Comparații, trade-offs
|
||||
|
||||
4. WebFetch pe documentații tehnice, papers
|
||||
|
||||
5. Sinteză:
|
||||
- Explicație tehnică clară
|
||||
- Arhitectură și componente
|
||||
- Implementare practică
|
||||
- Trade-offs și considerații
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Problem: Rezultate irelevante
|
||||
|
||||
**Soluție**:
|
||||
- Reformulează query cu termeni mai specifici
|
||||
- Adaugă termeni tehnici sau jargon de domeniu
|
||||
- Restrânge cu year sau domain
|
||||
|
||||
### Problem: Surse de calitate scăzută
|
||||
|
||||
**Soluție**:
|
||||
- Adaugă "research", "study", "analysis" la query
|
||||
- Caută direct pe Google Scholar, ArXiv
|
||||
- Filtrează după .edu, .gov în rezultate
|
||||
|
||||
### Problem: Informații contradictorii
|
||||
|
||||
**Soluție**:
|
||||
- Caută MAI MULTE surse pentru cross-reference
|
||||
- Prioritizează surse peer-reviewed
|
||||
- Prezintă ambele perspective în raport
|
||||
- Notează explicit că există dezacord
|
||||
|
||||
### Problem: Subiect prea larg
|
||||
|
||||
**Soluție**:
|
||||
- Întreabă utilizatorul pentru clarificări
|
||||
- Focusează pe aspecte specifice
|
||||
- Creează outline înainte de cercetare
|
||||
|
||||
## Output Final
|
||||
|
||||
După cercetare, ai:
|
||||
- ✅ 5-10 surse credibile
|
||||
- ✅ Informații cheie extrase și organizate
|
||||
- ✅ Pattern-uri și teme identificate
|
||||
- ✅ Perspective critice și echilibrate
|
||||
- ✅ Lista completă de surse cu detalii
|
||||
|
||||
**Acum ești gata să generezi raportul** folosind `research-report` skill!
|
||||
|
||||
## Note Importante
|
||||
|
||||
- **NU copia verbatim din surse** - parafrazează și citează
|
||||
- **NU ignora informații care nu confirmă o narațiune** - fii obiectiv
|
||||
- **NU te opri la prima sursă** - caută multiple perspective
|
||||
- **ÎNTOTDEAUNA verifică credibilitatea** surselor
|
||||
|
||||
---
|
||||
|
||||
**Ultima actualizare**: 2025-01-06
|
||||
**Versiune**: 1.0
|
||||
1495
claude-code-initialization-prompt.md
Normal file
1495
claude-code-initialization-prompt.md
Normal file
File diff suppressed because it is too large
Load Diff
416
raport-noua-medicina-germana-2025.md
Normal file
416
raport-noua-medicina-germana-2025.md
Normal file
@@ -0,0 +1,416 @@
|
||||
# RAPORT DE CERCETARE: NOUA MEDICINĂ GERMANĂ
|
||||
|
||||
**Autor**: Asistent AI Claude
|
||||
**Data**: 6 noiembrie 2025
|
||||
**Subiect**: Noua Medicină Germană (German New Medicine/GNM) - Analiză critică
|
||||
|
||||
---
|
||||
|
||||
## Executive Summary
|
||||
|
||||
Noua Medicină Germană (NMG sau GNM - German New Medicine) este un sistem pseudo-medical dezvoltat de Dr. Ryke Geerd Hamer (1935-2017), care pretinde că poate vindeca cancerul prin înțelegerea "legilor biologice ale naturii". Sistemul susține că bolile, inclusiv cancerul, sunt rezultatul unui șoc emoțional neașteptat și că procesele de vindecare sunt naturale și nu necesită intervenție medicală convențională.
|
||||
|
||||
Cercetarea efectuată relevă că această metodă nu are susținere științifică, a fost respinsă de toate organismele medicale majore din Europa, și a fost asociată cu multiple decese ale pacienților. Dr. Hamer și-a pierdut licența medicală în 1986 și a fost încarcerat în mai multe țări europene pentru malpraxis și practică ilegală a medicinei.
|
||||
|
||||
Concluzia principală: Noua Medicină Germană reprezintă un pericol semnificativ pentru sănătate, deoarece determină pacienții să abandoneze tratamente dovedite științific în favoarea unor practici nevalidate.
|
||||
|
||||
---
|
||||
|
||||
## 1. Introducere
|
||||
|
||||
### 1.1 Context și Originea
|
||||
|
||||
Noua Medicină Germană a fost dezvoltată de Dr. Ryke Geerd Hamer, un medic german care a avut licență medicală între 1963 și 1986. Sistemul a apărut în urma unei tragedii personale: în 1978, fiul său Dirk a fost împușcat și a decedat în decembrie același an. Câteva luni mai târziu, Dr. Hamer a fost diagnosticat cu cancer testicular.
|
||||
|
||||
Hamer a susținut că nu fusese niciodată grav bolnav anterior și a dezvoltat teoria că apariția cancerului său era direct legată de pierderea tragică a fiului său. Această observație personală a devenit fundamentul unui întreg sistem medical alternativ.
|
||||
|
||||
### 1.2 Obiectivele Cercetării
|
||||
|
||||
Acest raport își propune să:
|
||||
- Documenteze principiile fundamentale ale Noii Medicini Germane
|
||||
- Evalueze statusul științific și medical al acestei practici
|
||||
- Analizeze evidența clinică disponibilă
|
||||
- Examineze consecințele pentru pacienți
|
||||
- Prezinte poziția comunității medicale internaționale
|
||||
|
||||
### 1.3 Domeniul de Aplicare
|
||||
|
||||
Raportul acoperă:
|
||||
- Biografia și contextul dezvoltării teoriei
|
||||
- Cele Cinci Legi Biologice ale NMG
|
||||
- Evaluarea științifică și medicală
|
||||
- Cazuri documentate și consecințe pentru pacienți
|
||||
- Aspecte legale și etice
|
||||
|
||||
Raportul NU acoperă:
|
||||
- Detalii tehnice extinse despre tratamente oncologice validate
|
||||
- Analize psihologice aprofundate ale adepților
|
||||
- Legislație comparată despre medicina alternativă
|
||||
|
||||
---
|
||||
|
||||
## 2. Metodologie
|
||||
|
||||
### 2.1 Surse de Informații
|
||||
|
||||
Cercetarea s-a bazat pe:
|
||||
|
||||
**Surse Academice și Medicale**:
|
||||
- Wikipedia (pentru overview istoric verificabil)
|
||||
- The Lancet (jurnal medical peer-reviewed)
|
||||
- PubMed (bază de date medicală)
|
||||
- Skeptics Stack Exchange (analiză critică științifică)
|
||||
|
||||
**Organizații Medicale**:
|
||||
- Swiss Cancer League
|
||||
- German Cancer Research Center
|
||||
- German Cancer Society
|
||||
- Study Group for Complementary and Alternative Methods in Cancer (SCAC)
|
||||
|
||||
**Media și Investigații**:
|
||||
- Der Spiegel (investigație jurnalistică)
|
||||
- Surse românești (Știința și Tehnica)
|
||||
|
||||
**Surse Primare GNM**:
|
||||
- Site-uri promotoare ale GNM (pentru înțelegerea principiilor susținute)
|
||||
|
||||
### 2.2 Criterii de Evaluare
|
||||
|
||||
Sursele au fost evaluate după:
|
||||
- Credibilitate instituțională
|
||||
- Metodologie științifică aplicată
|
||||
- Peer-review și validare independentă
|
||||
- Transparență în prezentarea datelor
|
||||
- Absența conflictelor de interes
|
||||
|
||||
### 2.3 Limitări
|
||||
|
||||
Acest raport se concentrează pe evaluarea științifică și nu explorează în detaliu aspectele psihologice care determină persoanele să adopte astfel de practici.
|
||||
|
||||
---
|
||||
|
||||
## 3. Principiile Noii Medicini Germane
|
||||
|
||||
### 3.1 Cele Cinci Legi Biologice
|
||||
|
||||
Conform promotorilor GNM, sistemul se bazează pe cinci "legi biologice":
|
||||
|
||||
#### Prima Lege: "Regula de Fier a Cancerului"
|
||||
|
||||
Susține că orice boală începe cu un șoc-conflict neașteptat și acut (DHS - Dirk Hamer Syndrome) care afectează simultan psihicul, creierul și organul corespunzător. Lateralitatea (stânga/dreapta) și sexul determină care parte a corpului este afectată.
|
||||
|
||||
#### A Doua Lege: Pattern-ul Bifazic
|
||||
|
||||
Pretinde că fiecare "program biologic special" parcurge două faze dacă conflictul se rezolvă:
|
||||
- **Faza de conflict activ**: sistem nervos simpatic dominant, mâini reci, tulburări de somn
|
||||
- **Faza de vindecare**: sistem nervos parasimpatic dominant, oboseală, apetit
|
||||
|
||||
#### A Treia Lege: Sistemul Ontogenetic
|
||||
|
||||
Afirmă că organele derivate din diferite straturi embrionare sunt controlate de regiuni specifice ale creierului:
|
||||
- Endoderm → trunchi cerebral
|
||||
- Mezoderm vechi → cerebel
|
||||
- Mezoderm nou → măduvă cerebrală
|
||||
- Ectoderm → cortex cerebral
|
||||
|
||||
#### A Patra Lege: Sistemul Ontogenetic al Microbilor
|
||||
|
||||
Susține că microorganismele (ciuperci, bacterii) joacă roluri esențiale în vindecare, decomponând celulele în exces create în faza de conflict activ. Această lege reinterpretează infecțiile ca simptome de vindecare, nu cauze de boală.
|
||||
|
||||
#### A Cincea Lege: Quintesența
|
||||
|
||||
Afirmă că boala nu este o disfuncție, ci o "adaptare biologică semnificativă" - tumorile îmbunătățesc funcția organelor în criză, iar simptomele reprezintă "inteligență vindecătoare".
|
||||
|
||||
### 3.2 Concepte Cheie
|
||||
|
||||
**DHS (Dirk Hamer Syndrome)**: Șocul-conflict inițial care declanșează boala, numit după fiul decedat al lui Hamer.
|
||||
|
||||
**Hamer Foci**: Pattern-uri concentrice în imagistica CT cerebrală pe care Hamer le-a interpretat ca dovezi ale legăturilor creier-organ. Radiologii le identifică ca artefacte comune de inel.
|
||||
|
||||
**Lateralitate și Biologie**: Teoria că apartenența biologică (masculin/feminin), lateralitatea (stângaci/dreptaci) și relațiile (mamă/copil vs. partener) determină manifestările simptomatice.
|
||||
|
||||
---
|
||||
|
||||
## 4. Evaluarea Științifică și Medicală
|
||||
|
||||
### 4.1 Poziția Comunității Medicale Internaționale
|
||||
|
||||
**Organizații Majore care Resping NMG**:
|
||||
|
||||
- German Cancer Research Center (Centrul German de Cercetare a Cancerului)
|
||||
- German Cancer Society (Societatea Germană de Cancer)
|
||||
- German Medical Association (Asociația Medicală Germană)
|
||||
- Swiss Cancer League (Liga Elvețiană contra Cancerului)
|
||||
- German Consumer Councils (Consiliile Consumatorilor Germani)
|
||||
|
||||
**Evaluarea Swiss Cancer League**:
|
||||
> "Abordarea lui Hamer este periculoasă, în special deoarece creează pacienților un fals sentiment de securitate, astfel că aceștia sunt lipsiți de tratamente eficiente."
|
||||
|
||||
**Study Group for Complementary and Alternative Methods in Cancer (SCAC)**:
|
||||
Grupul de studiu și Liga Elvețiană contra Cancerului (SCL) nu au găsit nicio dovadă că afirmațiile lui Ryke Geerd Hamer sunt corecte sau că metoda sa de tratament a cancerului este eficientă.
|
||||
|
||||
### 4.2 Lipsa Evidenței Științifice
|
||||
|
||||
**Publicații Peer-Reviewed**:
|
||||
- **Zero cazuri** de vindecare a cancerului prin metoda Hamer publicate în literatura medicală
|
||||
- **Zero studii** în jurnale de specialitate
|
||||
- Rapoartele din cărțile lui Hamer "lipsesc datele adiționale esențiale pentru evaluare medicală"
|
||||
- Prezentările la conferințe medicale sunt "neconvingătoare științific"
|
||||
|
||||
**Rejecție Academică**:
|
||||
În 1986, teza de habilitare a lui Hamer despre GNM la Universitatea din Tübingen a fost respinsă după multiple examinări de către membrii facultății medicale, care au concluzionat că:
|
||||
- Munca lui lipsește metodologie științifică
|
||||
- Lipsește reproductibilitatea
|
||||
- Argumentele nu susțin teoriile propuse
|
||||
|
||||
**Artefacte vs. Descoperiri**:
|
||||
"Hamer foci" pe care Hamer îi vedea în tomografiile cerebrale sunt identificați de radiologi ca **artefacte comune de inel** - fenomene tehnice normale în imagistica CT, nu dovezi ale unor "programe biologice".
|
||||
|
||||
### 4.3 Probleme Fundamentale ale Teoriei
|
||||
|
||||
**Contradicții Biologice**:
|
||||
|
||||
1. **Cancer la organisme simple**: Teoria eșuează în a explica de ce plantele și viermii nematozi (cu psihologie minimă sau absentă) dezvoltă tumori. Dacă șocul psihologic cauzează cancerul, cum se explică cancerul la aceste organisme?
|
||||
|
||||
2. **Necroză ireversibilă**: Afirmația că necroza (moartea celulară) poate fi inversată contrazice principii biologice fundamentale - moartea celulară este ireversibilă.
|
||||
|
||||
3. **Suprasimplificare**: Atribuirea bolilor complexe unei cauze unice (șoc emoțional) ignoră complexitatea biologiei umane, factorilor genetici, de mediu și stilului de viață.
|
||||
|
||||
**Lipsă de Mecanism Validat**:
|
||||
Nu există mecanism biologic plausibil demonstrat prin care un șoc emoțional ar putea crea modificări oncogene specifice în ADN-ul celular care să conducă la cancer.
|
||||
|
||||
---
|
||||
|
||||
## 5. Consecințe pentru Pacienți
|
||||
|
||||
### 5.1 Date Statistice Documentate
|
||||
|
||||
**Investigația Der Spiegel**:
|
||||
O investigație jurnalistică prin autoritățile germane a identificat **50 de pacienți cu cancer** care fuseseră în îngrijirea lui Hamer:
|
||||
- **7 supraviețuitori** (14% rată de supraviețuire)
|
||||
- **43 decese** (86% rată de mortalitate)
|
||||
|
||||
Această rată este devastatoare comparativ cu ratele de supraviețuire pentru cancere tratabile prin medicina convențională.
|
||||
|
||||
**Pattern Documentat**:
|
||||
"În această clinică, mulți pacienți din țări europene și Germania au decedat, au fost trimiși acasă sau trimiși la alte spitale cu scurt timp înainte de moartea lor. Hamer continuă să îi trateze cu Noua sa Medicină, dar când sunt în pragul morții îi trimite la spitalele din apropiere. Cazurile sunt atât de numeroase încât la un moment dat spitalele din jur refuză să mai accepte oamenii lui pe moarte."
|
||||
|
||||
### 5.2 Cazuri Notabile
|
||||
|
||||
**Cazul din Austria - Tumora Wilm**:
|
||||
Hamer a încurajat părinții unei fetițe cu tumoră Wilm să refuze tratamentul, care ar fi putut-o vindeca cu o probabilitate ridicată. Din cauza acestui refuz, fetița a fost foarte aproape de moarte. Autoritățile au intervenit, au preluat custodia de la părinți și au salvat viața copilului.
|
||||
|
||||
### 5.3 Pericolul Abandonării Tratamentelor Validate
|
||||
|
||||
Pericolul principal al NMG nu constă doar în eficacitatea inexistentă, ci în:
|
||||
- **Întârzierea tratamentelor validate**: Pacienții pierd ferestre critice de timp pentru intervenții eficiente
|
||||
- **Progresie necontrolată**: Cancerul progresează netratabil în timp ce pacientul urmează "legile biologice"
|
||||
- **Fals sentiment de securitate**: Pacienții cred că sunt pe calea vindecării când în realitate boala avansează
|
||||
|
||||
---
|
||||
|
||||
## 6. Aspecte Legale și Etice
|
||||
|
||||
### 6.1 Istoricul Legal al lui Ryke Geerd Hamer
|
||||
|
||||
**Revocare Licență**:
|
||||
- Licență medicală: 1963-1986
|
||||
- Revocată în 1986 prin decizie judecătorească pentru malpraxis
|
||||
- Decizie reconfirmată în 2003
|
||||
|
||||
**Condamnări Penale**:
|
||||
|
||||
1. **Germania (1997-1998)**: 12 luni închisoare
|
||||
2. **Francia (2004-2006)**: Septembrie 2004 - Februarie 2006 pentru:
|
||||
- Fraudă
|
||||
- Practică ilegală a medicinei
|
||||
3. **Germania (2004)**: Sentință de 19 luni închisoare în Köln pentru practică ilegală a medicinei
|
||||
|
||||
**Acuzații de Malpraxis**:
|
||||
Hamer a fost investigat în repetate rânduri pentru acuzații de malpraxis și provocarea morții pacienților.
|
||||
|
||||
### 6.2 Implicații Etice
|
||||
|
||||
**Vulnerabilitatea Pacienților**:
|
||||
Pacienții cu cancer sunt într-o stare de vulnerabilitate emoțională extremă, căutând speranță. Promisiunile de vindecare fără tratament invaziv exploatează această vulnerabilitate.
|
||||
|
||||
**Responsabilitate Medicală**:
|
||||
Promovarea de tratamente nevalidate pentru boli grave ca substitute pentru terapii validate contravine principiului fundamental medical "Primum non nocere" (Mai întâi, să nu dăunezi).
|
||||
|
||||
**Informare vs. Dezinformare**:
|
||||
Sursele care promovează NMG prezintă adesea doar testimoniale pozitive și critică medicina convențională fără a prezenta evidența dăunătoare documentată.
|
||||
|
||||
---
|
||||
|
||||
## 7. Prezența în România
|
||||
|
||||
### 7.1 Diseminare
|
||||
|
||||
Cercetarea a identificat:
|
||||
- **Cărți traduse** în limba română disponibile în librării online
|
||||
- **Site-uri web românești** care promovează "biologia emoțiilor" și NMG
|
||||
- **Conferințe și seminarii** organizate periodic
|
||||
- **Prezență media** pe platforme de televiziune, inclusiv difuzori publici
|
||||
|
||||
### 7.2 Critică în Spațiul Public Românesc
|
||||
|
||||
Sursa "Știința și Tehnica" (stiintasitehnica.com) oferă o critică substanțială:
|
||||
|
||||
> "Noua Medicină Germană: o năzbâtie periculoasă"
|
||||
|
||||
Critica principală:
|
||||
- Pacienții abandonează tratamente eficiente pentru cancer
|
||||
- Acest lucru "îi condamnă la moarte"
|
||||
- Căutările online generează mai multe bloguri cu laude decât informații bazate pe evidență
|
||||
- Promovare lipsită de examinare critică
|
||||
|
||||
---
|
||||
|
||||
## 8. Analiză și Implicații
|
||||
|
||||
### 8.1 De Ce Câștigă Tracțiune?
|
||||
|
||||
În ciuda lipsei de evidență științifică, NMG continuă să atragă adepți din cauza:
|
||||
|
||||
1. **Simplitate atrăgătoare**: Explicații simple pentru boli complexe
|
||||
2. **Emputerment fals**: Promite control asupra bolii prin rezolvare emoțională
|
||||
3. **Rezistența la medicina convențională**: Unii pacienți au experiențe negative cu sistemul medical
|
||||
4. **Evitarea tratamentelor grele**: Chimioterapia și radiațiile au efecte secundare severe
|
||||
5. **Testimoniale selective**: Cazurile de succes (probabil remisiuni spontane sau diagnostice eronate) sunt promovate, eșecurile sunt ignorate
|
||||
6. **Comunitate și suport**: Grupuri de adepți oferă suport emoțional
|
||||
|
||||
### 8.2 Paralele cu Alte Mișcări Anti-Știință
|
||||
|
||||
NMG prezintă caracteristici comune cu alte mișcări pseudo-științifice:
|
||||
- **Teorie conspiraționistă**: "Big Pharma" ascunde adevărul
|
||||
- **Martir-fondator**: Hamer prezentat ca persecutat de establishment
|
||||
- **Rejectare categorică a criticii**: Orice critică este considerată ignoranță sau interes financiar
|
||||
- **Anecdote vs. date**: Testimoniale personale prezentate ca dovadă în loc de studii clinice
|
||||
|
||||
### 8.3 Impactul Social
|
||||
|
||||
**Efecte Negative**:
|
||||
- Morți evitabile prin abandonarea tratamentelor validate
|
||||
- Suferință prelungită a pacienților și familiilor
|
||||
- Erodarea încrederii în medicina bazată pe evidență
|
||||
- Răspândirea dezinformării medicale
|
||||
|
||||
**Lipsă de Reglementare Eficientă**:
|
||||
Deși Hamer a fost condamnat, mișcarea GNM continuă prin:
|
||||
- Practicieni neautorizați
|
||||
- Diseminare online
|
||||
- Cărți și materiale educaționale
|
||||
- Comunități și grupuri de suport
|
||||
|
||||
---
|
||||
|
||||
## 9. Concluzii
|
||||
|
||||
### 9.1 Sinteza Descoperirilor Cheie
|
||||
|
||||
1. **Lipsă totală de evidență științifică**: Niciun studiu peer-reviewed, nicio validare clinică, nicio publicație în jurnale medicale de specialitate
|
||||
|
||||
2. **Rejectare universală de către comunitatea medicală**: Toate organizațiile majore de cancer din Europa resping categoric NMG
|
||||
|
||||
3. **Consecințe devastatoare documentate**: Rată de supraviețuire de doar 14% comparativ cu rate semnificativ mai mari pentru tratamente validate
|
||||
|
||||
4. **Bază teoretică defectuoasă**: Contradicții biologice fundamentale, mecanisme neplausibile, artefacte interpretate greșit ca descoperiri
|
||||
|
||||
5. **Condamnări legale multiple**: Licență revocată, multiple condamnări pentru malpraxis și practică ilegală
|
||||
|
||||
6. **Pericol continuu**: În ciuda evidenței dăunătoare, mișcarea continuă să atragă pacienți vulnerabili
|
||||
|
||||
### 9.2 Răspunsuri la Întrebările Inițiale
|
||||
|
||||
**Este NMG o alternativă validă la medicina convențională?**
|
||||
**Răspuns**: Nu. Nu există nicio evidență că funcționează și există evidență substanțială că dăunează grav pacienților.
|
||||
|
||||
**Are NMG o bază științifică?**
|
||||
**Răspuns**: Nu. Teoriile contrazic principii biologice fundamentale și nu au fost niciodată validate științific.
|
||||
|
||||
**Este NMG sigură?**
|
||||
**Răspuns**: Nu. Este extrem de periculoasă deoarece determină pacienții să abandoneze tratamente care le-ar putea salva viața.
|
||||
|
||||
### 9.3 Perspective
|
||||
|
||||
**Provocări Continue**:
|
||||
- Mișcările anti-știință în medicină vor continua să atragă adepți
|
||||
- Reglementarea practică este dificilă în era informației digitale
|
||||
- Educația publică despre gândirea critică rămâne esențială
|
||||
|
||||
**Nevoi Identificate**:
|
||||
- Campanii de educație publică despre pseudo-medicină
|
||||
- Reglementare mai strictă a pretențiilor medicale în media
|
||||
- Suport emoțional mai bun pentru pacienții cu cancer în sistemul medical convențional
|
||||
- Platforme accesibile pentru verificarea informațiilor medicale
|
||||
|
||||
---
|
||||
|
||||
## 10. Referințe și Surse
|
||||
|
||||
### Surse Principale
|
||||
|
||||
1. **Wikipedia - Ryke Geerd Hamer**
|
||||
- URL: https://en.wikipedia.org/wiki/Ryke_Geerd_Hamer
|
||||
- Relevență: Overview comprehensiv cu referințe verificabile despre biografie, teorie și critici
|
||||
|
||||
2. **Swiss Cancer League - Official Assessment**
|
||||
- Citat prin diverse surse
|
||||
- Relevență: Evaluare oficială a unei organizații medicale credibile despre eficacitatea și siguranța NMG
|
||||
|
||||
3. **Der Spiegel Investigation**
|
||||
- Investigație jurnalistică documentând 50 de cazuri de pacienți
|
||||
- Relevență: Date statistice concrete despre rata de supraviețuire
|
||||
|
||||
4. **The Lancet - Sentință**
|
||||
- URL: https://www.thelancet.com/journals/lancet/article/PIIS0140-6736(05)62059-4/abstract
|
||||
- Relevență: Jurnal medical peer-reviewed documentând condamnarea lui Hamer
|
||||
|
||||
5. **Skeptics Stack Exchange - Scientific Analysis**
|
||||
- URL: https://skeptics.stackexchange.com/questions/7362/does-german-new-medicine-work/7370
|
||||
- Relevență: Analiză critică științifică detaliată a pretențiilor NMG
|
||||
|
||||
6. **PubMed - Recent Academic Study**
|
||||
- URL: https://pubmed.ncbi.nlm.nih.gov/40273922/
|
||||
- Titlu: "Exploring Holistic Healing of Cancer: German New Medicine (GNM) and Homeopathic Treatment Beyond Traditional Therapies"
|
||||
- Relevență: Studiu academic recent care explorează GNM în context holistic
|
||||
|
||||
7. **Știința și Tehnica (Română) - Critică**
|
||||
- URL: https://stiintasitehnica.com/noua-medicina-germana-o-nazbatie-periculoasa/
|
||||
- Relevență: Perspectivă critică în limba română asupra NMG
|
||||
|
||||
8. **Learning GNM - Five Laws Description**
|
||||
- URL: https://learninggnm.com/SBS/documents/five_laws.html
|
||||
- Relevență: Descriere detaliată a celor cinci legi din perspectiva promotorilor GNM
|
||||
|
||||
### Surse Secundare
|
||||
|
||||
- Diverse site-uri web românești care promovează NMG
|
||||
- GNM Institute și alte organizații de training
|
||||
- Cărți și materiale educaționale despre NMG
|
||||
- ResearchGate papers despre GNM
|
||||
|
||||
---
|
||||
|
||||
## Nota Finală
|
||||
|
||||
**Avertisment Important**:
|
||||
|
||||
Acest raport este destinat exclusiv scopurilor informative și educaționale. Informațiile prezentate reflectă consensul comunității medicale internaționale bazat pe evidență științifică.
|
||||
|
||||
**Dacă tu sau cineva cunoscut aveți cancer sau altă boală gravă**:
|
||||
- Consultați medici oncologi calificați
|
||||
- Urmați tratamente validate științific
|
||||
- Nu abandonați tratamentele medicale pentru terapii nevalidate
|
||||
- Căutați second opinions de la specialiști credibili
|
||||
- Fiți sceptici față de promisiuni de vindecare miraculoasă
|
||||
|
||||
**Sănătatea ta este prețioasă. Deciziile medicale ar trebui bazate pe evidență științifică validată, nu pe teorii nedemonstrate.**
|
||||
|
||||
---
|
||||
|
||||
**Document generat**: 6 noiembrie 2025
|
||||
**Surse consultate**: 8 surse principale + multiple surse secundare
|
||||
**Domeniu**: Evaluare critică pseudo-medicină
|
||||
|
||||
Pentru întrebări sau clarificări despre acest raport, contactați profesioniști medicali calificați sau organizații de cancer recunoscute.
|
||||
Reference in New Issue
Block a user