kairyou/agent-tooling

Compétences réutilisables pour agents, hooks, outils de barre d'état et utilitaires d'installation pour Codex, Claude Code et opencode.

Qu'est-ce que agent-tooling ?

Ce skill fournit des compétences réutilisables pour agents IA (comme Claude Code, Codex et opencode), incluant des hooks, des outils de barre d'état et des utilitaires d'installation. Il est conçu pour standardiser les workflows de génération de messages de commit en suivant les règles de Conventional Commits et en garantissant une cohérence entre différents agents. Le point central est le fichier SKILL.md, qui est la source unique de vérité et est référencé par des adaptateurs légers (shims) pour chaque agent. Le skill automatise la génération de messages de commit à partir du diff git stagé, en veillant à ce que les messages soient précis, en langue chinoise, et respectent des directives strictes de formatage et de contenu. Il améliore l'efficacité des développeurs en réduisant les erreurs de commit et en maintenant une traçabilité claire des changements.

Compatible avec✓Claude Code✓Codex CLI~Cursor✓OpenCode
npx skills add kairyou/agent-tooling

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · 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

Générateur de Message de Commit

Ce fichier est la source unique de vérité, chaque agent (Claude / opencode / codex) y fait référence via son propre adaptateur léger (shim).

Processus

  1. Exécutez git diff --staged pour voir les modifications stagées ; si vide, indiquez « Faites d'abord git add » et arrêtez-vous.
  2. Générez un message selon les règles ci-dessous, affichez-le à l'utilisateur pour confirmation, ne validez pas directement ; si l'utilisateur doit choisir, donnez directement les messages optionnels, ne vous contentez pas de demander.
  3. N'exécutez git commit -m que lorsque l'utilisateur confirme (ex. répond « Valider » ou « OK »). Ne faites pas git push sauf demande explicite.

Règles

Lisez git diff --staged et générez un message en suivant les Conventional Commits, en expliquant le QUOI et le POURQUOI.

  • Titre type(scope): description, longueur totale ≤ 74 caractères, pas de point à la fin, aucun préfixe/guillemet/bloc de code.
  • type choisissez le plus pertinent :
    • feat nouvelle fonctionnalité · fix correction de bug
    • refactor refactorisation sans changement de comportement externe (ni nouvelle fonctionnalité ni correction de bug) · perf optimisation des performances
    • docs uniquement documentation · style ajustements de format sans impact sémantique (espaces blancs/format/points-virgules, etc.)
    • test ajout ou correction de tests · build modifications du système de construction ou des dépendances externes · ci configuration et scripts CI
    • chore autres tâches n'affectant pas src/test · revert annulation d'un commit précédent
  • scope (optionnel) nom du module affecté, selon les conventions de ce dépôt – pour un monorepo, utilisez le nom du répertoire app/package ; si plusieurs modules sont concernés ou si vous hésitez, omettez-le.
  • La description doit être en français : une phrase verbe-objet concise expliquant « ce qui a été fait », sans expressions creuses comme « Plusieurs fichiers ont été modifiés », « Ce commit » ou « Cette modification » ; les identifiants (noms de fonctions/fichiers/packages) restent en anglais.
  • Un seul ligne : en toutes circonstances, le message de commit n'a qu'une seule ligne de titre, pas de corps/pied de page ; intégrez le POURQUOI nécessaire dans cette ligne.
  • Breaking change marquez avec un ! dans type(scope)!: description, restez sur une seule ligne, n'utilisez pas le pied de page BREAKING CHANGE.
  • Ponctuation utilisez la ponctuation anglaise semi-large, pas les pleines largeurs ,。:().

Stratégie de Génération

Avant d'écrire, réfléchissez d'abord au « problème résolu par cet ensemble de modifications / à la ligne directrice », puis suivez le format ci-dessus :

  • Identifiez la ligne directrice : n'écrivez que les informations nécessaires à la compréhension de ce commit, ne listez pas les noms de fichiers/fonctions/configurations (sauf s'ils sont eux-mêmes cruciaux).
  • Repérez les changements significatifs : y a-t-il des modifications de logique, de contrat, de construction, de porte qualité ou de comportement utilisateur visible ? Choisissez le type approprié en conséquence, et déterminez si le ! pour breaking est nécessaire.

Discipline de Contenu (D'où vient le QUOI)

Ce qui précède concerne le format ; ce qui suit concerne la véracité du contenu – le message ne doit relater que des faits de code confirmés, sans deviner les intentions ni extrapoler à partir de la documentation :

  • Priorisez les modifications de comportement dans src/test : la documentation ne sert que de contexte secondaire, ne l'utilisez pas pour déduire le QUOI (la documentation est souvent en avance ou en retard sur le code).
  • Le contexte de la conversation prime sur la documentation : les objectifs explicitement mentionnés dans les prompts récents de l'utilisateur peuvent être utilisés pour le POURQUOI ou pour choisir un libellé plus pertinent (ex. « Correction de la vérification/typecheck complète ») ; mais le QUOI/scope repose toujours sur le diff stagé – les informations contextuelles non reflétées dans le diff ne doivent pas être incluses dans le message. En cas de conflit, le diff prime et demandez confirmation.
  • Diff de suppression/renommage : si vous ne pouvez pas confirmer le but via les relations d'appel de code, contentez-vous de déclarations objectives (Supprimer X / X renommé en Y), n'écrivez pas de relations causales fortes comme « remplace / migre vers / change en ».
  • Plusieurs points de changement mais un même objectif (ex. une correction de qualité de code/construction) → donnez directement un message récapitulatif unique ; ne proposez une séparation que si elle améliore significativement la revue/le rollback, et alors en option complémentaire, sans bloquer par défaut.
  • Mélange évident d'objectifs indépendants (fonctionnalités/corrections) → fournissez tout en une fois : les messages unitaires pour chaque partie + un message récapitulatif prudent, laissant l'utilisateur choisir entre décomposition ou synthèse, sans reporter la synthèse au tour suivant ; ne forcez un résumé que si le QUOI global ne peut être objectivement synthétisé, sinon listez simplement les unités.
  • Modifications dont l'appartenance/l'intention n'est pas claire (parallèles, sans raison apparente) → produisez « Ces fichiers nécessitent une confirmation d'appartenance/intention », plutôt que de forcer un message ; en cas d'incertitude, évitez les mots vagues comme « rangement / ajustement », préférez demander à l'utilisateur de confirmer ou décomposer.

Skills associés