Générer une carte de compétence

Répertoire de compétence à analyser : $ARGUMENTS

Objectif

Créer un projet de carte de gouvernance NVIDIA pour une compétence d'agent existante. La compétence rassemble les signaux sources, guide l'agent à construire un contexte JSON fondé, rend une carte markdown déterministe et vérifie que les marqueurs de révision humaine ont été supprimés avant soumission.

Utilisez ceci quand :

Un répertoire de compétence existe déjà et a besoin d'une nouvelle carte de gouvernance.
Une compétence modifiée a besoin que sa carte existante soit actualisée.
Un propriétaire de compétence prépare du matériel de révision NVCARPS ou légal/sécurité.

N'utilisez PAS pour :

Expliquer, lister, comparer ou discuter de compétences ou de capacités de compétences.
Créer ou réécrire la compétence source elle-même.
Générer des cartes pour des actifs non-compétences comme les modèles, datasets, conteneurs ou systèmes complets.
Signer, publier ou approuver une carte de compétence.
Remplacer la révision humaine requise légale, sécurité ou propriétaire.

Prérequis

Python 3 est disponible.
jinja2 est installé avant d'exécuter render_card.py.
Le chemin cible est un répertoire de compétence contenant SKILL.md ou skill.md.
L'agent peut écrire un fichier de contexte JSON temporaire et la sortie de carte rendue.
Les permissions d'exécution autorisent les lectures depuis target_skill_directory plus references/ et scripts/ de cette compétence, les écritures uniquement vers le répertoire de compétence cible ou /tmp/, et l'exécution shell uniquement pour les trois scripts listés ci-dessous.

Instructions

Commencez par lire ce SKILL.md complètement avant d'exécuter un script.
Résolvez le répertoire de compétence cible depuis $ARGUMENTS ; s'il est omis, utilisez le répertoire de travail courant.
Restez dans la portée de permissions déclarée. Ne lisez pas .env, fichiers de credentials, dossiers auth cachés, ou fichiers repo non liés ; n'écrivez pas en dehors du répertoire de compétence cible ou /tmp/.
Exécutez scripts/discover_assets.py contre la cible. Utilisez d'abord le résumé de signal structuré ; si la sortie est tronquée, lisez uniquement les fichiers ciblés ou de petits extraits.
Construisez un fichier de contexte JSON à partir du résumé de signal structuré d'abord, puis depuis le contenu de fichiers extraits uniquement si nécessaire.
Suivez references/style-guide.md pour chaque champ de contexte. Utilisez HUMAN-REQUIRED uniquement quand aucune source ne supporte une valeur véridique.
Rendez la carte avec scripts/render_card.py et corrigez les erreurs de schéma avant de continuer.
Révisez la carte manuellement, supprimez les marqueurs VERIFY et SELECT résolus, puis exécutez scripts/validate_submission.py.
Avant de terminer, confirmez que la carte rendue n'a aucun fragment template {{ ... }} ou {% ... %} non rendu.

Scripts disponibles

Script	Objectif	Arguments
`scripts/discover_assets.py`	Extrait les fichiers de compétence, signaux repo, guide de style et template dans un rapport de découverte unique.	`<skill_directory>`
`scripts/render_card.py`	Valide le contexte JSON et rend la carte de compétence depuis le template Jinja.	`--context <context.json> --template <skill-card.md.j2> --out <output.md>`
`scripts/validate_submission.py`	Échoue si la carte rendue contient encore des marqueurs de révision VERIFY ou SELECT.	`<rendered-card.md>`

Exemples

Découvrir les signaux pour une compétence cible :

run_script("scripts/discover_assets.py", args=["/path/to/target-skill"])

Rendre une carte depuis le contexte complété :

run_script(
  "scripts/render_card.py",
  args=[
    "--context", "/tmp/target-skill-context.json",
    "--template", "references/skill-card.md.j2",
    "--out", "/path/to/target-skill/target-skill-card.md"
  ]
)

Valider la carte révisée avant soumission :

run_script("scripts/validate_submission.py", args=["/path/to/target-skill/target-skill-card.md"])

Limitations

La carte générée est un projet et doit être révisée par un propriétaire humain.
La découverte est limitée aux fichiers locaux et métadonnées repo visibles depuis le chemin cible.
Le renderer valide la forme du contexte requise, pas la justesse légale ou sécurité des valeurs de champ.
Les catalogues de limitation et risque pré-définis sont des points de départ ; supprimez les entrées qui ne s'appliquent pas.

Dépannage

Erreur	Cause	Solution
`directory not found`	Le chemin cible est faux ou non monté dans l'espace de travail.	Réexécutez la découverte avec le chemin absolu vers le répertoire de compétence.
`jinja2 not installed`	La dépendance du renderer est manquante.	Installez `jinja2`, puis réexécutez `render_card.py`.
`Context validation failed`	Les champs requis manquent ou ont un type incorrect.	Corrigez le contexte JSON en utilisant `references/style-guide.md`.
Échec du marqueur non résolu	Les marqueurs VERIFY ou SELECT restent après la révision.	Confirmez chaque champ marqué, élaguez les entrées de catalogue, puis réexécutez `validate_submission.py`.

Fichiers dans cette compétence

SKILL.md - ce fichier (orchestration)
references/style-guide.md - guidance par champ de contexte
references/skill-card.md.j2 - mise en page exacte de la carte
references/Skill Card Generator License.txt - texte de licence pour ce package de compétence
references/catalog/limitations.json - catalogue pré-défini de limitations techniques
references/catalog/risks.json - catalogue pré-défini de gestion des risques
scripts/discover_assets.py - découverte et extraction de signaux
scripts/render_card.py - renderer Jinja avec validation de contexte
scripts/validate_submission.py - validateur de marqueur pré-soumission

skill-card-generator