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

# Chemin du fichier : scripts/analyze.py
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

## Exécuter l'analyse

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

import os

# 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

# Chemin du fichier : scripts/validate_input.py
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)

Les 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.

Autres extensions