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.
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)
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
Fiecare skill are nevoie de un fișier SKILL.md cu frontmatter YAML care conține metadatele skillului:
---
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
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
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.
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)
| OS | Path |
|---|
| macOS | /Library/Application Support/Windsurf/skills/ |
| Linux/WSL | /etc/windsurf/skills/ |
| Windows | C:\ProgramData\Windsurf\skills\ |
SKILL.md, la fel ca skill-urile din workspace.
Exemple de scenarii de utilizare
.windsurf/skills/deploy-staging/
├── SKILL.md
├── pre-deploy-checks.sh
├── environment-template.env
└── rollback-steps.md
Ghiduri pentru code review
.windsurf/skills/code-review/
├── SKILL.md
├── style-guide.md
├── security-checklist.md
└── review-template.md
.windsurf/skills/run-tests/
├── SKILL.md
├── test-template.py
├── coverage-config.json
└── ci-workflow.yaml
-
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
| 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 |
- 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
