CommunityRédaction et éditiongithub.com

troels-im/agent-skills-playbook-template

Modèle progressif de documentation en tant que code pour les compétences d'agents IA, AGENTS.md, playbooks, traces de travail et politiques de test just.

Qu'est-ce que agent-skills-playbook-template ?

Ce skill fournit un modèle de documentation en tant que code (docs-as-code) pour les agents IA, permettant de formaliser les flux de travail dans un dépôt. Il est conçu pour minimiser la consommation de tokens tout en guidant l'agent à travers des playbooks définis et des politiques de test reproductibles. L'agent lit d'abord le fichier `AGENTS.md` puis la documentation racine, sélectionne le flux le plus pertinent dans le répertoire `flows/`, et exécute les étapes en respectant des formats précis de suivi de progression et de vérification (tests `just turn-test` avant chaque commit et `just pr-test` avant la fin). Une attention particulière est portée aux « portes d'entrée utilisateur » : l'agent doit demander une confirmation ou une décision lorsque celle-ci est manquante, sauf instruction explicite de l'utilisateur de continuer en autonomie. Ce skill est utile pour tout développeur souhaitant une approche structurée et reproductible de l'interaction avec un agent IA dans un repository logiciel.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add troels-im/agent-skills-playbook-template

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

Lets

Utilisez ce skill comme surface de commande à faible consommation de tokens pour les flux de dépôt.

Workflow

  1. Lisez AGENTS.md.
  2. Lisez le fichier racine index.md.
  3. Lisez flows/index.md.
  4. Sélectionnez le plus petit flux correspondant.
  5. Chargez le fichier de flux sélectionné.
  6. Créez ou mettez à jour une checklist d'exécution de flux nommée d'après ce flux. Utilisez des slugs horodatés UTC pour les noms générés : run-YYYYMMDDTHHMMSSZ-short-slug.md.
  7. Suivez uniquement les playbooks nommés par le flux et requis par l'étape en cours.
  8. Préfixez les mises à jour de progression avec le format requis par le flux : XX% / YY% / ZZ% : message.
  9. Exécutez just turn-test avant chaque commit.
  10. À l'étape finale d'un flux, exécutez just pr-test, corrigez les tests PR défaillants, et répétez jusqu'à ce que les tests PR réussissent ou qu'un vrai blocage soit enregistré.

Portes d'entrée utilisateur

Lorsqu'une étape du flux nécessite une saisie utilisateur, une approbation, une décision produit ou un retour pour continuer correctement, faites une pause dans la boucle et demandez. N'inférez pas de décisions manquantes ni ne continuez sur des exigences devinées.

Continuez sans demander uniquement lorsque l'utilisateur dit explicitement de ne pas le déranger, de ne pas demander, de procéder au mieux de votre jugement, ou donne une instruction équivalente. Lorsque vous le faites, enregistrez l'hypothèse dans la checklist d'exécution et maintenez-la réversible dans la mesure du possible.

Si aucun flux ne correspond, dites-le clairement et acheminez via playbooks/repository/choose-workflow.md.

Ne traitez pas /goal ou /loop comme des commandes utilisateur pour ce modèle. Utilisez /lets comme commande utilisateur et flows/ comme couche de dépôt durable.

Skills associés