>_

Bonnes pratiques

Directives pour creer des Agent Skills efficaces et maintenables.

Apercu

Des competences bien concues font la difference entre un assistant IA utile et un assistant frustrant. Suivez ces bonnes pratiques pour creer des competences qui fonctionnent de maniere fiable.

Principes fondamentaux

1. Etre specifique, pas vague

Bien :

"Use sentence case for headings. Capitalize only the first word and proper nouns."

Mal :

"Use appropriate capitalization."

2. Fournir des exemples

Montrez, ne dites pas seulement. Incluez des exemples concrets du comportement attendu.

Bien :

When formatting dates: - Write: "January 15, 2024" - Don't write: "01/15/24" or "15 Jan 2024"

3. Definir clairement la portee

Indiquez explicitement ce que la competence couvre et ce qu'elle ne couvre pas.

Bien :

This skill covers: - React component design - State management - Performance optimization This skill does NOT cover: - Backend API design - Database schema - DevOps/deployment

4. Utiliser une structure coherente

Organisez le contenu de maniere previsible pour que l'IA puisse trouver rapidement les informations.

Sections recommandees :

  1. Context/Overview
  2. Guidelines
  3. Do's and Don'ts
  4. Examples
  5. References

5. Rester concentre

Une competence = un domaine. N'essayez pas de tout couvrir.

Bien : "React Component Guidelines" Mal : "Complete Web Development Guide"

Erreurs courantes

Sur-ingenierie

N'ajoutez pas de complexite qui n'apporte pas de valeur :

  • Trop de regles qui se contredisent
  • Cas limites qui se produisent rarement
  • Informations redondantes

Sous-specification

Ne laissez pas de details importants ambigus :

  • Exemples manquants pour les concepts cles
  • Langage vague comme "as appropriate"
  • Pas de guidance sur les cas limites

Instructions contradictoires

Assurez-vous que vos directives ne se contredisent pas :

Probleme :

"Keep responses concise" et "Provide detailed explanations"

Solution :

"Keep responses concise. For complex topics, provide detailed explanations in expandable sections."

Documentation

Connexe

Modifier cette page sur GitHub