Files
nova-pai/.claude/skills/research-report/SKILL.md
2025-11-06 20:32:36 +02:00

7.6 KiB

name, description
name description
research-report 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

# [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)

# 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:

✅ 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