Skills-Summarize-Audit — Audit de compétences et de profil de projet (couplé avec summarize)
Réalise un profilage multidimensionnel, une notation à 7 dimensions, une analyse de capacité et des recommandations d'optimisation pour le catalogue de compétences ou le projet actuel, produisant finalement un rapport d'audit actionnable.
Il vous aide à :
- Connaître l'état de santé du catalogue de compétences (🟢/🟡/🔴) et sa tendance (📈 ↑/↓)
- Détecter les compétences mortes et les redondances
- Calculer combien de compétences l'Agent peut encore charger (alerte de capacité multi-facteurs)
- Obtenir une liste d'actions exécutables (archiver/installer/mettre à jour)
- Annuler les opérations en un clic après une erreur (
--undo)- S'intégrer dans les pipelines CI/CD (sortie JSON + logique de gate)
Mots de déclenchement / Trigger Words
Cette compétence utilise un déclenchement par mot indépendant : le mot déclencheur doit être envoyé seul (peut être accompagné d'une sous-commande), il n'est pas déclenché en milieu de phrase. Conçue pour fonctionner avec la compétence summarize, 技能总结 déclenche directement l'audit.
- Audit de compétences :
技能审查,技能审计,技能检查,能力审查,能力审计,工具审查,技能总结,skills-audit,skill-audit,skill-check,capability-audit,tool-audit,skills-summarize-audit - Audit de projet :
项目审查,项目审计,项目诊断,项目画像,环境审查,环境审计,project-audit,project-check,project-diagnosis,project-profile,env-audit - Opération d'annulation :
回滚,撤销,恢复,undo-snapshot,rollback,revert - Sous-commandes :
深度/deep,推荐/recommend,画像/profile,健康/health,轻量/quick,ci/--ci,回滚/undo/--undo
Matrice des mots de déclenchement
| Mode | Mots déclencheurs en chinois | Mots déclencheurs en anglais |
|---|---|---|
| Audit de compétences | 技能审查, 技能审计, 技能检查, 能力审查, 能力审计, 工具审查, 技能总结 | skills-audit, skill-audit, skill-check, capability-audit, tool-audit, skills-summarize-audit |
| Audit de projet | 项目审查, 项目审计, 项目诊断, 项目画像, 环境审查, 环境审计 | project-audit, project-check, project-diagnosis, project-profile, env-audit |
| Opération d'annulation | 回滚, 撤销, 恢复 | undo-snapshot, rollback, revert |
Synonymes : 审查=审计=检查=诊断, 能力=技能=工具, 环境=project → automatiquement classés dans le mode correspondant.
Comportement de déclenchement
| Déclenche ✅ | Ne déclenche pas ❌ |
|---|---|
技能审查 (envoyé seul) | 帮我做一次技能审查 (milieu de phrase) |
skills-audit skills-summarize-audit (envoyé seul) | run skills-audit on this (milieu de phrase) |
技能总结 (envoyé seul, couplé avec la marque summarize) | 总结一下技能 (milieu de phrase) |
技能审计 深度 (mot seul + sous-commande) | 这个项目需要能力审查吗 (milieu de phrase) |
Auto-adaptation linguistique : si la langue principale de l'utilisateur est l'anglais (>70% des échanges), la correspondance des mots déclencheurs privilégie l'anglais et la langue du rapport passe en en.
Quand utiliser / When to Use
- Mode audit de compétences : maintenance régulière de la santé du catalogue (recommandé toutes les 2 à 4 semaines), ou après des changements importants. Peut être couplé avec
summarize: run summarize → détection d'accumulation de compétences → suggestion技能总结. - Mode audit de projet : pour comprendre rapidement la stack technique et la chaîne d'outils lors de la reprise d'un nouveau projet, ou pour évaluer la santé de l'environnement avant une refactorisation.
- Traduction et affinage des mots déclencheurs : traduire automatiquement la description de la compétence en mots déclencheurs chinois + résumé (ou l'inverse), facilitant la compréhension rapide pour les utilisateurs multilingues.
Prérequis / Prerequisites
Prérequis stricts (détection automatique + guide d'installation si absent)
- codegraph — structure du code et requêtes de symboles, moteur d'analyse principal. Tentative d'installation automatique si absent.
- git — comparaison de versions, snapshots et rollbacks. Tentative d'installation automatique si absent.
- config.yaml — source de configuration unique dans le répertoire de cette compétence. Généré à partir d'un modèle si absent.
Prérequis souples (création automatique si absent)
- user-profile.md — profil utilisateur. Créé automatiquement via un questionnaire si absent.
Capacités / Capabilities
skills-summarize-audit fournit les capacités principales suivantes (v6.0.0 : nouvelle matrice de capacités + signaux de qualité + flux communautaire + radar écologique) :
- Profilage de la stack technique du projet et identification du type de projet
- Scan complet du catalogue de compétences et liste incrémentale
- Construction de la matrice de dimensions de capacité (~12 dimensions, v6.0.0)
- Lecture des signaux de qualité (couplé avec le registre d'erreurs de summarize, v6.0.0)
- Analyse de capacité effective multi-facteurs et alerte de capacité
- 6 détections d'activité de compétences
- Notation S/A/B/C/D à 7 dimensions avec justification obligatoire
- Validation d'activité T3 et contrôle du risque de mauvaise archivage
- Recherche de flux communautaire (recherche GitHub pilotée par les lacunes de capacité, v6.0.0)
- Recommandations d'outils basées sur la complémentarité des capacités (remplacement/ complément/supplément/non lié, v6.0.0)
- Bloc radar écologique (sortie conditionnelle, affiché seulement en cas de problème, v6.0.0)
- Lecture approfondie compétence par compétence et vérification par sources externes
- Cache des signaux externes et moteur de recommandation à trois niveaux
- Rapport résumé en 30 secondes et comparaison de tendances
- Sauvegarde de snapshot et rollback avec
--undo - Mode sans interaction CI/CD et sortie JSON pour gate
- Traduction et affinage des mots déclencheurs et vérification de la qualité des descriptions
Tableau détaillé des capacités par phase d'exécution :
| Phase | Capacité | Description |
|---|---|---|
| ⓪ Configuration | Adaptation multi-plateforme | Détection automatique des plateformes Codex/Claude/Cursor/Coze |
| ① Profilage | Scan de la stack technique du projet | Identification automatique de 15+ types de projet (Web/Rust/Python/Go/Java...) |
| ② Liste | Scan complet du catalogue + mapping de capacités | Scan de 4 chemins + mapping capability-dimensions.yaml (v6.0.0) |
| ②-bis | Analyse de capacité | Calcul de capacité effective multi-facteurs (token + facteurs de conflit + capacité cognitive) |
| ②-ter | Détection d'activité | 6 vérifications pour valider la disponibilité de la compétence (accessibilité Agent/MCP/commande/déclencheur/données/preuve d'utilisation) |
| ④ Notation | Notation 7 dimensions + signaux de qualité | Notation 7 dimensions + lecture du registre d'erreurs de summarize (v6.0.0) |
| ④-a | Validation d'activité T3 | Vérification des preuves d'utilisation/date de modification/enregistrement de déclenchement avant archivage, réduit le taux d'erreur d'archivage |
| ④-bis | Lecture approfondie | S/A : lecture complète approfondie ; B (pertinent au profil) : complète ; B (non pertinent) : simplifiée |
| ⑤a | Signaux externes | Collecte en cache de GitHub⭐/npm📥 |
| ⑤-aa | Flux communautaire | Recherche GitHub pilotée par les lacunes de capacité (v6.0.0) |
| ⑤b | Moteur de recommandation par matrice de capacités | Recommandations basées sur la complémentarité des capacités (remplacement/ complément/supplément/non lié, v6.0.0) |
| ⑥ | Génération de rapport + Radar écologique | Résumé en 30 secondes + bloc capacité + tableau de notation + bloc radar écologique conditionnel (v6.0.0) |
| ⑦-a | Sauvegarde de snapshot | Sauvegarde automatique de toutes les compétences editables avant exécution |
| ⑦-d | Rollback des opérations | --undo annule toute opération exécutée, conserve les snapshots 7 jours |
| CI | Audit sans interaction | Sortie JSON + 3 gates (health/t3/actions), intégration GitHub Actions |
Quand ne PAS utiliser / When NOT to Use
- Édition de fichier unique, débogage en temps réel, projet minimal (sans dépendance de compétence), installation d'une seule compétence
- Environnement à faibles ressources (l'audit consomme environ 5K-15K tokens par exécution)
Flux d'exécution
Déclenché, lire d'abord
references/execution-flow.mdpour obtenir le flux complet, le tableau de notation, le calcul de capacité, le modèle de rapport et les règles CI. Le fichier principal ne contient que l'entrée et les règles clés.
⓪ Configuration préalable → ① Profilage projet → ② Liste compétences + collecte capacité → **②-ter Détection d'activité**
→ ③ Chargement données de référence → ④ Notation par couches
→ ④-bis Lecture approfondie → ⑤ Signaux externes + Recommandation → ⑥ Génération rapport → ⑥-bis Validation audit → ⑦ Exécution → ⑧ Persistance
Règles clés
- Profilage : scanner uniquement le répertoire courant. Extraire les points faibles des sources de données, interdiction de deviner. Écrire le résultat dans
{project}/.agents/project-profile.md - Couches : T1 (touche activité principale) → conserver ; T2 (général) → conserver ; T3 (spécialisé) → suggérer archivage
- Notation : 7 dimensions S/A/B/C/D. Chaque compétence est accompagnée d'une phrase de justification ; pas de justification = non notée
- Capacité : calculer la limite maximale de l'Agent. Peut encore charger ≤1 → 🔴, 2-4 → 🟡, ≥5 → 🟢
- Signaux externes : GitHub⭐ en cache 7 jours, npm📥 en cache 30 jours. Ignorer et marquer si réseau indisponible, interdiction de falsifier
- Recommandation : chaque recommandation est accompagnée d'un indice de confiance (0-10) + ROI. <7 : marquer clairement "en évaluation", <5 : nécessite des données pour recommander
- Exécution : ne modifier que les compétences de niveau utilisateur (editable=true). Compétences système en lecture seule
- Règle d'or : pour le développement/la modification/la recommandation de compétences, d'abord chercher et vérifier, citer ≥2 sources indépendantes
- Détection d'activité : détection complète lors du premier audit. Détections ultérieures uniquement pour les nouvelles compétences installées. La sous-commande
深度(deep) force une détection complète. En cas d'anomalie, déclencher une biopsie de compétence unique
Exemple de sortie
Déclenchement de 技能审查 (audit de compétences), sortie prioritaire du bloc résumé en 30 secondes :
🟢 Santé du catalogue de compétences : Bonne
🛠️ Actions clés : Mettre à jour 1 compétence obsolète, archiver 2 compétences T3
💰 Économie estimée : ~3200 tokens/exécution (réduction de l'injection de compétences à faible valeur)
Puis sortie d'un extrait du tableau de notation (exemple) :
| Compétence | Global | Fit | Value | Fresh | Community | ROI | Novelty | Contamination | Suggestion |
|---|---|---|---|---|---|---|---|---|---|
| codegraph | S | 5 | 5 | 4 | 4 | 5 | 5 | 5 | Conserver, outil principal |
| old-linter | C | 2 | 2 | 2 | 3 | 2 | 2 | 4 | Suggérer d'archiver |
Le format complet du rapport se trouve dans references/report-template.md.
Règles d'identification du type de projet
Règles d'inférence principales (mapping complet dans references/project-types.yaml) :
package.json→ Web/Node/Full StackCargo.toml→ Rust ·pyproject.toml→ Python ·go.mod→ Gopom.xml/build.gradle→ Java ·.csproj→ C# ·pubspec.yaml→ FlutterCMakeLists.txt→ C/C++ ·Gemfile→ Ruby- Plusieurs
SKILL.md+MEMORY.md→Développement de compétences pour Agent IA
Règles de limite (référence rapide)
- Déclenchement : déclenchement par mot indépendant, pas en milieu de phrase
- Couches : T1/T2/T3 basé uniquement sur les "activités principales" du profil
- Notation : cinq niveaux S/A/B/C/D. Justification obligatoire, pas de justification = non noté
- Analyse approfondie : lire l'intégralité du corps du texte. Les lacunes doivent être vérifiées par des outils.
- Rapport : sortie uniquement si contenu. Pas de contenu par défaut.
- Recommandation : accompagnée d'un indice de confiance 0-10 + ROI. <5 : ne pas recommander, nécessite des données.
- Confirmation d'exécution : les opérations nécessitent la confirmation de l'utilisateur. Compétences système en lecture seule.
- Règle d'or : d'abord chercher et vérifier, ≥2 sources.
Configuration de la plateforme et CI/CD
Plateformes supportées : platforms/zcode.yaml · platforms/workbuddy.yaml · platforms/claude.yaml · platforms/codex.yaml · platforms/cursor.yaml · platforms/default.yaml.
Mode CI (技能审查 --ci ou skills-summarize-audit --ci ou skills-audit --ci) : sans interaction, sortie JSON, saute la lecture approfondie, limité par le budget ci.max_tokens dans config.yaml. Logique de gate : health=🔴 → exit_code=1 · actions_required>5 → exit_code=2 · t3_ratio>0.35 → exit_code=3. Modèle GitHub Actions dans references/ci-github-actions.yml.
Scan de sécurité SkillSpector (optionnel) : activer via config.yaml → security_scan, les résultats du scan sont intégrés dans la dimension Value (Critical→D, High→C, passed→+0.5 niveau). SkillSpector est un processus externe, ne consomme pas de token Agent.
Structure des fichiers
skills-summarize-audit/
├── SKILL.md # Fichier principal de la compétence
├── VERSION # Numéro de version
├── LICENSE # MIT
├── README.md # Aperçu et installation
├── config.yaml # Configuration d'audit
├── platforms/ # Configuration d'adaptation aux plateformes
├── references/ # Documentation de référence
│ ├── execution-flow.md # Index du flux d'exécution
│ ├── flow/ # Étapes détaillées par phase (19 sous-fichiers)
│ ├── project-types.yaml # Mapping des types de projet
│ ├── skill-registry.yaml # Registre des compétences
│ ├── deep-analysis-template.md
│ ├── description-quality.md
│ ├── report-template.md
│ ├── ci-output-schema.md
│ ├── ci-github-actions.yml
│ └── recommendation-examples.md
├── tests/ # Suites de test et scripts de validation
├── .data/ # Données d'exécution (logs/cache/statistiques/profils/signaux externes)
├── install.ps1 / install.sh # Scripts d'installation
└── CHANGELOG.md # Journal des modifications
Installation
Installation en une commande et installation manuelle détaillées dans references/installation.md (ou dans README.md s'il n'existe pas).
Après installation, saisir 技能审查 ou 技能总结 ou skills-summarize-audit pour déclencher (skills-audit est toujours supporté).
Feedback
License
MIT — voir le fichier LICENSE.