CommunityRédaction et éditiongithub.com

skill-drift-audit-skill (Audit de dérive SKILL.md)

Audite la dérive de SKILL.md par rapport aux docs, scripts, exemples et notes de version du dépôt.

Qu'est-ce que skill-drift-audit-skill (Audit de dérive SKILL.md) ?

Cette compétence permet d'auditer automatiquement un dépôt de compétence agent en détectant les écarts entre le fichier `SKILL.md` et les sources réelles du projet (README, documentation, scripts de package, exemples et notes de version). Elle est particulièrement utile lors des revues de code ou des mises à jour de compétences, afin de garantir que la documentation reste synchronisée avec le code et les fonctionnalités effectivement livrées. La compétence s'exécute localement via deux commandes principales : `scan` pour analyser l'état actuel et produire des rapports en Markdown ou JSON, et `plan` pour générer un plan de correction dans un fichier de sortie explicite. Elle respecte des limites strictes : elle ne modifie jamais `SKILL.md` par défaut, n'appelle pas de services externes et ne publie rien. L'approbation explicite de l'utilisateur est requise avant toute action destructive ou publication. Cette compétence est conçue pour fonctionner avec tout dépôt contenant un fichier `SKILL.md`, et est compatible avec les environnements de développement locaux (CLI, IDE comme Cursor ou VS Code).

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add rogerchappel/skill-drift-audit-skill

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Skill Drift Audit Skill

Quand l'utiliser

Utilisez cette compétence lorsque vous révisez ou rafraîchissez un dépôt de compétence agent et que vous avez besoin de preuves que SKILL.md correspond toujours au README, à la documentation, aux scripts de package, aux exemples et aux notes de version.

Entrées requises

  • Un chemin de dépôt local contenant SKILL.md.
  • README, documentation, métadonnées de package, journal des modifications et notes de version candidates (optionnels).

Limites des effets de bord

scan lit les fichiers locaux et écrit les rapports sur stdout. plan écrit uniquement dans un chemin --output explicite. La compétence ne doit pas réécrire SKILL.md, appeler des services externes, publier des packages ou modifier les artefacts de version par défaut.

Approbations requises

Demandez une approbation explicite avant de modifier les instructions durables de la compétence, de supprimer des exemples, de publier des packages ou d'envoyer des rapports d'audit en dehors de l'espace de travail local.

Exemples

skill-drift-audit scan . --format markdown
skill-drift-audit scan fixtures/stale-skill --format json
skill-drift-audit plan . --output tmp/skill-drift-plan.md

Workflow de validation

Exécutez ces commandes avant de vous appuyer sur la compétence :

npm run check
npm test
npm run smoke
npm run package:smoke

Skills associés