Yinyo Skill Craft — Skill 工匠
Outil d'audit d'ingénierie Skill et de correction interactive. Basé sur le guide officiel de l'équipe Perplexity Agents + les normes de codage Karpathy CLAUDE.md + l'expérience pratique de la série yinyo.
Nouvelle capacité : prise en charge de la correction automatique + mode de confirmation utilisateur.
Règles essentielles
1. Skill est un répertoire, pas un fichier
- Fichier unique > 50 Ko → doit être divisé en structure hub-and-spoke
- Structure standard : SKILL.md + README.md + docs/ + examples/ + subskills/
- Imbrication multi-niveaux : 300 sujets → 20 domaines → 15 sujets/domaine
2. Description est le déclencheur de routage
- Doit commencer par
Load when... - Décrit la condition de déclenchement, pas une liste de fonctionnalités
- Maximum 50 mots
3. Chargement progressif à trois niveaux
| Niveau | Budget Token | Contenu | Fréquence de paiement |
|---|---|---|---|
| Index | ~100 | nom + description | Chaque session |
| Body | ~5000 | Règles essentielles + Référence rapide | Après chargement jusqu'à compaction |
| Runtime | Illimité | docs/ + examples/ + subskills/ | Quand utilisé |
4. Supprimer le contenu déjà connu du modèle
- Expliquer des concepts de base → supprimer
- Principes génériques de programmation → supprimer
- "If it's easy to explain, the model already knows it. Delete it."
5. Quatre principes de codage Karpathy
- Think Before Coding : en cas de doute, demande
- Simplicity First : si 200 lignes suffisent, n'en écris pas 500
- Surgical Changes : ne touche que ce qui doit l'être
- Goal-Driven Execution : définis des objectifs vérifiables
Processus de correction interactif (nouveau)
Principes de correction
- Faible risque (structure, format, version) → exécution automatique, rapport a posteriori
- Risque moyen (réécriture de description) → afficher la comparaison avant/après, confirmation utilisateur
- Risque élevé (suppression de contenu) → lister les éléments à supprimer, confirmation individuelle
Périmètre des corrections
| Type de correction | Exemple | Niveau de risque |
|---|---|---|
| Ajustement structurel | Diviser un fichier unique en répertoire | Faible |
| Réécriture de description | Remplacer par Load when... | Moyen |
| Suppression de contenu | Supprimer le contenu déjà connu du modèle | Élevé |
| Synchronisation de version | Mettre à jour version/last_updated | Faible |
| Normalisation du format | Compléter le frontmatter | Faible |
Processus de correction
Audit → Lister les problèmes → Classer par risque → Confirmation utilisateur → Correction automatique → Second audit → Rapport des résultats
Vérification après correction
- Exécution automatique d'un second audit
- Comparaison des scores avant/après correction
- Génération d'un rapport de correction (quoi, pourquoi, changement de score)
Processus d'audit
Entrée
L'utilisateur fournit :
- Le chemin du répertoire Skill, ou
- Le contenu du fichier SKILL.md
Sortie
Générer un rapport d'audit :
## Rapport d'audit : {skill-name}
### Audit structurel
- [PASS/WARN/FAIL] Structure du répertoire
- [PASS/WARN/FAIL] Taille des fichiers
- [PASS/WARN/FAIL] Profondeur hiérarchique
### Audit de contenu
- [PASS/WARN/FAIL] Rédaction de la description
- [PASS/WARN/FAIL] Détection de contenu déjà connu du modèle
- [PASS/WARN/FAIL] Densité du signal
### Gestion de version
- [PASS/WARN/FAIL] Format du numéro de version
- [PASS/WARN/FAIL] État de synchronisation
### Score total : {X}/100
### Recommandations : {actions prioritaires}
Liste de détection des anti-patrons
Anti-patrons structurels
- Fichier unique gonflé (> 50 Ko)
- Description trop longue (> 100 tokens)
- Aucune hiérarchie (> 50 sujets à plat)
- Aucune gestion de version
Anti-patrons de contenu
- Contenu déjà connu du modèle (explications de concepts de base)
- Sur-ingénierie (couche d'abstraction > besoin réel)
- Simulation de processus (respect de la conformité d'exécution plutôt que qualité du résultat)
- Aucun critère de validation
Toxicités spécifiques à yinyo
- Hésitation à revenir en arrière (ne pas revenir immédiatement en cas de baisse de qualité)
- Plus le processus est complet, plus la qualité se dégrade (leçon yinyo-writer)
- Fichier unique de 277 Ko (leçon yinyo-liuyao)
Modèle de suggestions de correction
Fichier unique gonflé → Division
Ancien : SKILL.md (277 Ko)
Nouveau :
├── SKILL.md (5 Ko : règles essentielles)
├── docs/
│ ├── rules.md (50 Ko : 120 règles)
│ ├── examples.md (100 Ko : 412 exemples de cas)
│ └── reference.md (30 Ko : tableau des 64 hexagrammes)
└── subskills/
├── edge-case-1.md
└── edge-case-2.md
Description erronée → Correction
❌ "This Skill helps you write articles."
✅ "Load when the user needs to write a WeChat public account article."
Référence rapide
Nommage Skill
yinyo-{domaine}-{action}
Taille des fichiers
- Index : < 1 Ko
- Body : < 50 Ko
- Runtime : illimité
Gestion de version
- SemVer : MAJEUR.MINEUR.CORRECTIF
- Synchronisation à chaque mise à jour : SKILL.md + README.md + commit Git + mémoire
Mots-clés de correction
- "Réparer ce Skill" → entrer en mode correction interactif
- "Correction automatique" → exécuter les correctifs à faible risque
- "Aide-moi à modifier" → afficher les suggestions de modification, attendre confirmation