220 lines
4.2 KiB
Markdown
220 lines
4.2 KiB
Markdown
# 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:"
|
|
```
|