À propos du projet

Jules Prompts est une bibliothèque de consignes de tâches lisibles par machine, de compétences d'agent, et de fixtures à défauts plantés, conçue pour les agents de codage. Le nom est historique ; les instructions sont indépendantes du harnais et ne dépendent pas de produits spécifiques comme Jules, Claude Code, Codex, ou Cursor. Le dépôt est organisé en plusieurs couches : - `_prompts/` : Texte canonique des procédures, incluant un site web, un index JSON, et des commandes slash MCP. - `skills/` : Le même texte formaté en compétences d'agent, généré depuis `_prompts/`, prêt à copier dans `.claude/skills/` ou `.agents/skills/`. - `fixtures/` : Dépôts miniatures avec défauts plantés pour démontrer comment les compétences échouent. - `plugin/` : La bibliothèque entière comme un paquet installable avec manifeste, compétences, et commandes slash. - `library.json` : Une liste lisible par machine de chaque procédure, sa catégorie, et son niveau. Toutes les sorties générées sont vérifiées octet par octet dans le CI pour garantir leur synchronisation avec la source. Ajouter un nouveau format de sortie est une simple entrée dans la liste `TARGETS` de `scripts/emit.py`. Les procédures sont classées comme `core` sauf si marquées `status: legacy`. Les procédures core traitent les échecs que les agents rencontrent réellement, tandis que les procédures legacy sont des textes de tâches génériques de 2025 restant utiles mais ne rendant pas cette bibliothèque unique. La bibliothèque inclut une doctrine permanente pour `AGENTS.md` dans `harness/AGENTS.md` pour garantir qu'elle s'active quand aucune compétence n'est sélectionnée. Des guides de démarrage sont fournis dans `PROMPTS_GUIDE.md` (explique chaque invite et la séquence recommandée) et `ENVIRONMENT_SETUP.md` (préparation d'un dépôt pour clonage, installation, et test d'agent). Les options d'utilisation incluent : - En tant que compétences d'agent : Copier les répertoires de compétences dans `.claude/skills/` et coller `harness/AGENTS.md` dans le `AGENTS.md` du projet. - En tant que serveur MCP : Configurer le serveur dans `mcpServers` pour exposer les invites comme commandes slash dans Claude Code, Claude Desktop, VS Code/Copilot Chat, Windsurf, et Zed. Le serveur lit le dépôt en direct, et les espaces réservés comme `<PR_URL_OR_DIFF_RANGE>` sont exposés comme arguments. - Pour les humains : Copier le corps d'un fichier d'invite après le front matter YAML et le coller dans l'entrée d'instruction de l'agent. - Pour les agents : Récupérer `https://jules-prompts.wecanuseai.com/prompts.json`, sélectionner une invite par titre/description/catégorie, et récupérer l'invite rendue depuis son URL ou lire `_prompts/<slug>.md`. - Contre les fixtures : Utiliser `python scripts/score_fixture.py fixtures/unfailable-tests path/to/REPORT.md` pour évaluer une fixture, avec des verdicts de tenue/cassée/sautée et une ligne de couverture. Les directives de contribution soulignent d'ajouter des invites uniquement pour des tâches récurrentes non déjà couvertes, de garder le front matter YAML aligné, d'écrire des instructions indépendantes du harnais, de régénérer les compétences, de mettre à jour les guides et flux de travail, d'ajouter des fixtures pour les invites attrapant les échecs, et de passer les vérifications d'intégrité.