Passage et réception des paramètres des compétences
Les Skills ne reçoivent pas de paramètres explicites comme les fonctions traditionnelles ; à la place, ils perçoivent les informations d'entrée via le contexte de Claude.
Comprendre ce mécanisme de "passage implicite de paramètres" est la clé pour écrire des Skills pratiques.
Skills : comment obtenir des paramètres
Lorsque Claude lit un Skill, tout le contexte de la conversation devient les paramètres du Skill.
Cela signifie que ce que dit l'utilisateur, les fichiers téléversés et l'historique des conversations peuvent tous servir de sources d'entrée pour le Skill.
| Sources d'entrée | Exemple | Description |
|---|---|---|
| Message actuel de l'utilisateur | "Aide-moi à traiter ce PDF" | L'entrée la plus directe |
| Fichiers téléversés | L'utilisateur a téléversé report.pdf | Transmis via un chemin ou un contenu |
| Historique de conversation | Formats de données précédemment abordés | Référençable dans le contexte |
| Variables système | Date actuelle, chemin du répertoire de travail | Perçu automatiquement par Claude |
Déclaration de l'entrée attendue dans SKILL.md
Dans SKILL.md, les descriptions en langage naturel peuvent indiquer à Claude quelles informations extraire du contexte.
Voici un exemple de Skill pour le traitement de fichiers CSV, montrant comment déclarer les attentes d'entrée dans les instructions :
Exemple
name: csv-analyzer
description: Analyser les fichiers CSV téléversés par l'utilisateur et produire des résumés statistiques. Déclenché lorsque l'utilisateur mentionne CSV ou l'analyse de données tabulaires.
---
# Analyseur CSV
## Exigences d'entrée
L'utilisateur doit fournir les informations suivantes (obtenues à partir du contexte de la conversation) :
- **Chemin du fichier**: Le chemin du fichier CSV téléversé (situé dans/mnt/user-data/uploads/)
- **Objectif de l'analyse**(Facultatif) : Ce que l'utilisateur veut savoir, comme"trouver les valeurs nulles"、"distribution statistique"
- **Format de sortie**(Facultatif) : Tableau, graphique ou résumé textuel
Si les informations ci-dessus ne sont pas claires, confirmez de manière proactive auprès de l'utilisateur avant d'exécuter.
Les "exigences d'entrée" dans une Skill sont écrites pour Claude lui-même. Claude extraira proactivement les informations du contexte sur la base de cette spécification, ou demandera des clarifications à l'utilisateur lorsque les informations sont insuffisantes.
Réception de paramètres structurés via des scripts
Lorsqu'une Skill inclut des scripts Python ou Shell, les paramètres sont transmis via des arguments de ligne de commande ou l'entrée standard.
C'est exactement la même chose que la gestion des paramètres dans des scripts ordinaires.
Exemple
import argparse
import pandas as pd
def main():
# Définir les arguments de ligne de commande
parser = argparse.ArgumentParser(description="CSV file analysis script")
parser.add_argument("file", help="Requis : chemin du fichier CSV")
parser.add_argument("--col", help="Optionnel : spécifiez le nom de la colonne à analyser")
parser.add_argument("--limit", type=int, default=10,
help="Optionnel : nombre maximum de lignes à afficher, par défaut 10")
args = parser.parse_args()
# Lire le fichier
df = pd.read_csv(args.file)
# Filtrer les colonnes selon les besoins
if args.col:
df = df[[args.col]]
# Afficher les informations statistiques
print(df.head(args.limit).to_string())
print("\n--- Résumé statistique ---)
print(df.describe())
if __name__ == "__main__":
main()
Comment Claude appelle ce script dans SKILL.md :
Exemple
Après avoir obtenu le chemin du fichier, exécutez la commande suivante :
```bash
python scripts/analyze.py <Chemin du fichier> [--col <Nom de la colonne>] [--limit <Nombre de lignes>]
```
Affichez la sortie de la ligne de commande à l'utilisateur et fournissez une interprétation textuelle.
Spécifications de gestion du paramètre de chemin de fichier
Les fichiers téléversés par l'utilisateur sont uniformément situés sous le chemin/mnt/user-data/uploads/.
Dans les scripts Skill, utilisez toujours des chemins absolus pour accéder aux fichiers afin d'éviter les erreurs de résolution de chemin.
Exemple
# Correct : Utiliser un chemin absolu
UPLOAD_DIR = "/mnt/user-data/uploads"
file_path = os.path.join(UPLOAD_DIR, "report.csv")
# Incorrect : Utiliser un chemin relatif (échouera en raison de répertoires de travail différents)
# file_path = "uploads/report.csv"
# Vérifier si le fichier existe
if not os.path.exists(file_path):
print(f"Erreur : Le fichier n'existe pas → {file_path}")
exit(1)
Validation des paramètres : Vérification de l'entrée avant exécution
Avant l'exécution, les scripts Skill doivent toujours vérifier que les paramètres clés sont valides.
Cela évite les plantages d'exécution causés par des paramètres manquants ou des erreurs de format.
Exemple
import sys
import os
def validate_csv_input(file_path: str) -> bool:
"""Vérifier si l'entrée du fichier CSV est valide"""
# Vérifier si le chemin de fichier est fourni
if not file_path:
print("Erreur : Chemin de fichier non fourni")
return False
# Vérifier si le fichier existe
if not os.path.exists(file_path):
print(f"Erreur : Le fichier n'existe pas → {file_path}")
return False
# Vérifier l'extension du fichier
if not file_path.lower().endswith(".csv"):
print(f"Erreur : type de fichier non pris en charge, attendu .csv, réel → {file_path}")
return False
# Vérifier la taille du fichier (avertir en cas de dépassement de 100MB)
size_mb = os.path.getsize(file_path) / (1024 * 1024)
if size_mb > 100:
print(f"Avertissement : le fichier est volumineux ({size_mb:.1f} MB), le traitement peut être lent")
return True
if __name__ == "__main__":
if len(sys.argv) < 2:
print("Utilisation : python validate_input.py <chemin de fichier>")
sys.exit(1)
ok = validate_csv_input(sys.argv[1])
sys.exit(0 if ok else 1)
Autres extensionsLes messages d'échec de validation des paramètres doivent indiquer clairement ce qui était attendu et ce qui a été réellement reçu, ce qui permet à Claude de fournir à l'utilisateur des raisons spécifiques.