Cascade Skills

Cele mai dificile sarcini de inginerie necesită adesea mai mult decât simple prompturi bune. Acestea pot necesita scripturi de referință, șabloane, liste de verificare și alte fișiere de suport. Skill-urile vă permit să grupați toate acestea în foldere pe care Cascade le poate invoca (citi și folosi). Skill-urile sunt o modalitate excelentă de a învăța Cascade cum să execute consecvent fluxuri de lucru cu mai mulți pași. Cascade folosește dezvăluire progresivă: în mod implicit, modelului îi sunt afișate doar name și description ale skill-ului. Conținutul complet al SKILL.md și fișierele de suport sunt încărcate doar atunci când Cascade decide să invoce skill-ul (sau când îi faceți @mention). Acest lucru menține fereastra de context suplă chiar și atunci când sunt definite multe skill-uri. Pentru mai multe detalii despre specificația Skills, vizitați agentskills.io.

Cum să creați un Skill

Utilizarea interfeței (cea mai simplă)

Deschideți panoul Cascade
Faceți clic pe cele trei puncte din colțul din dreapta sus al panoului pentru a deschide meniul Personalizări
Faceți clic pe secțiunea Skills
Faceți clic pe + Workspace pentru a crea un skill specific workspace-ului (proiectului) sau pe + Global pentru a crea un skill global
Denumiți skill-ul (numai litere mici, cifre și cratime)

Creare manuală

Skill de workspace (specific proiectului):

Creați un director: .windsurf/skills/<skill-name>/
Adăugați un fișier SKILL.md cu frontmatter YAML

Skill global (disponibil în toate workspace-urile):

Creați un director: ~/.codeium/windsurf/skills/<skill-name>/
Adăugați un fișier SKILL.md cu frontmatter YAML

Formatul fișierului SKILL.md

Fiecare skill are nevoie de un fișier SKILL.md cu frontmatter YAML care conține metadatele skillului:

Exemplu de „skill”

---
name: deploy-to-production
description: Ghidează procesul de deployment în producție cu verificări de siguranță
---

## Lista de verificare înainte de deployment
1. Rulați toate testele
2. Verificați modificările necomise
3. Verificați variabilele de mediu

## Pașii pentru deployment
Urmați acești pași pentru a efectua deployment-ul în siguranță...

[Referențiați fișierele de suport din acest director după necesitate]

Câmpuri obligatorii în frontmatter

name: Identificator unic pentru skill (afișat în UI și folosit pentru mențiuni cu @)
description: Explicație scurtă prezentată modelului AI, pentru a-l ajuta să decidă când să activeze skill-ul

Exemple de nume valide: deploy-to-staging, code-review, setup-dev-environment

Adăugarea resurselor de suport

Plasați toate fișierele de suport în folderul skill-ului, alături de SKILL.md. Aceste fișiere devin disponibile pentru Cascade atunci când skill-ul este apelat:

.windsurf/skills/deploy-to-production/
├── SKILL.md
├── deployment-checklist.md
├── rollback-procedure.md
└── config-template.yaml

Invocarea skillurilor

Invocare automată

Când solicitarea dvs. se potrivește cu descrierea unui skill, Cascade invocă automat skill-ul și folosește instrucțiunile și resursele acestuia pentru a îndeplini sarcina. Aceasta este cea mai frecventă modalitate de utilizare a skill-urilor — pur și simplu descrieți ce doriți să faceți, iar Cascade determină care skill-uri sunt relevante. Câmpul description din frontmatter-ul skill-ului dvs. este esențial: acesta ajută Cascade să înțeleagă când să invoce skill-ul. Scrieți descrieri care să explice clar ce face skill-ul și când ar trebui folosit.

Invocare manuală

Puteți oricând activa explicit un skill tastând @skill-name în câmpul de introducere din Cascade. Acest lucru este util dacă doriți să vă asigurați că este folosit un anumit skill sau dacă doriți să invocați un skill care altfel este posibil să nu fie declanșat automat de cererea dumneavoastră.

Domenii de aplicare pentru skill-uri

Scope	Location	Availability
Workspace	`.windsurf/skills/`	Numai pentru workspace-ul curent. Este versionat împreună cu repo-ul dvs.
Global	`~/.codeium/windsurf/skills/`	Toate workspace-urile de pe mașina dvs. Nu este versionat.
System (Enterprise)	Specific sistemului de operare (vedeți mai jos)	Toate workspace-urile, distribuite de IT. Doar în citire.

Pentru compatibilitate între agenți, Windsurf detectează, de asemenea, skill-uri în .agents/skills/ și ~/.agents/skills/. Dacă ați activat citirea configurației Claude Code, sunt scanate și .claude/skills/ și ~/.claude/skills/.

Skill-uri la nivel de sistem (Enterprise)

Organizațiile Enterprise pot implementa skill-uri disponibile în toate workspace-urile și care nu pot fi modificate de utilizatorii finali:

OS	Path
macOS	`/Library/Application Support/Windsurf/skills/`
Linux/WSL	`/etc/windsurf/skills/`
Windows	`C:\ProgramData\Windsurf\skills\`

Fiecare skill este un subdirector care conține un fișier SKILL.md, la fel ca skill-urile din workspace.

Exemple de scenarii de utilizare

Flux de implementare

Creati un skill cu scripturi de deployment, configurari de mediu si proceduri de rollback:

.windsurf/skills/deploy-staging/
├── SKILL.md
├── pre-deploy-checks.sh
├── environment-template.env
└── rollback-steps.md

Ghiduri pentru code review

Includeți ghiduri de stil, liste de verificare pentru securitate și șabloane pentru code review:

.windsurf/skills/code-review/
├── SKILL.md
├── style-guide.md
├── security-checklist.md
└── review-template.md

Proceduri de testare

Grupați șabloanele de test, cerințele de acoperire și configurațiile CI/CD:

.windsurf/skills/run-tests/
├── SKILL.md
├── test-template.py
├── coverage-config.json
└── ci-workflow.yaml

Cele mai bune practici

Scrieți descrieri clare: Descrierea ajută Cascade să decidă când să apeleze skill-ul. Fiți specific cu privire la ce face skill-ul și când ar trebui folosit.
Includeți resurse relevante: Șabloanele, listele de verificare și exemplele fac skill-urile mai utile. Gândiți-vă la ce fișiere ar ajuta pe cineva să finalizeze sarcina.
Folosiți nume descriptive: deploy-to-staging este mai bun decât deploy1. Numele ar trebui să indice clar ce face skill-ul.

Skills vs Rules vs Workflows

Toate trei personalizează Cascade, dar diferă prin structură, invocare și costul contextual:

	Skills	Rules	Workflows
Scop	Proceduri în mai mulți pași, cu fișiere de suport	Reguli de comportament („cum să se comporte”)	Șabloane de prompt pentru sarcini repetitive
Structură	Folder cu `SKILL.md` + orice fișiere de resurse	Un singur fișier `.md` cu frontmatter	Un singur fișier `.md`
Invocare	modelul AI decide (dezvăluire progresivă) sau `@mention`	`always_on` / `glob` / `model_decision` / `manual`	Doar manual prin `/slash-command`
În promptul de sistem?	Nu — doar numele + descrierea, până este invocat	Depinde de modul de activare	Nu — sunt listate ca comenzi disponibile
Cel mai potrivit pentru	Deploymenturi, code review-uri, proceduri de testare care necesită scripturi/șabloane	Stil de codare, convenții de proiect, constrângeri	Runbook-uri cu execuție unică, pe care le declanșați explicit

Regulă practică: dacă Cascade ar trebui să îl preia automat și are nevoie de fișiere de suport, folosiți un Skill. Dacă este o constrângere scurtă de comportament, folosiți un Rule. Dacă vreți să îl declanșați întotdeauna chiar dumneavoastră, folosiți un Workflow. Dacă Skills nu este ceea ce căutați, consultați și aceste alte funcționalități Cascade:

Workflows - Automatizați sarcinile repetitive cu workflow-uri Markdown reutilizabile, declanșate prin comenzi slash
AGENTS.md - Oferiți instrucțiuni la nivel de director care se aplică automat în funcție de locația fișierelor
Memories & Rules - Păstrați contextul de-a lungul conversațiilor cu memorii generate automat și reguli definite de utilizator

Editor

Cascade

Conturi

Conștientizare a contextului

Depanare

Securitate

Skills

Cum să creați un Skill

Utilizarea interfeței (cea mai simplă)

Creare manuală

Formatul fișierului SKILL.md

Exemplu de „skill”

Câmpuri obligatorii în frontmatter

Adăugarea resurselor de suport

Invocarea skillurilor

Invocare automată

Invocare manuală

Domenii de aplicare pentru skill-uri

Skill-uri la nivel de sistem (Enterprise)

Exemple de scenarii de utilizare

Flux de implementare

Ghiduri pentru code review

Proceduri de testare

Cele mai bune practici

Skills vs Rules vs Workflows

​Cum să creați un Skill

​Utilizarea interfeței (cea mai simplă)

​Creare manuală

​Formatul fișierului SKILL.md

​Exemplu de „skill”

​Câmpuri obligatorii în frontmatter

​Adăugarea resurselor de suport

​Invocarea skillurilor

​Invocare automată

​Invocare manuală

​Domenii de aplicare pentru skill-uri

​Skill-uri la nivel de sistem (Enterprise)

​Exemple de scenarii de utilizare

​Flux de implementare

​Ghiduri pentru code review

​Proceduri de testare

​Cele mai bune practici

​Skills vs Rules vs Workflows

​Documentație conexă

Cum să creați un Skill

Utilizarea interfeței (cea mai simplă)

Creare manuală

Formatul fișierului SKILL.md

Exemplu de „skill”

Câmpuri obligatorii în frontmatter

Adăugarea resurselor de suport

Invocarea skillurilor

Invocare automată

Invocare manuală

Domenii de aplicare pentru skill-uri

Skill-uri la nivel de sistem (Enterprise)

Exemple de scenarii de utilizare

Flux de implementare

Ghiduri pentru code review

Proceduri de testare

Cele mai bune practici

Skills vs Rules vs Workflows

Documentație conexă