initializare
This commit is contained in:
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
|
||||
Reference in New Issue
Block a user