Aller au contenu principal

pr-review-toolkit

Agents de revue spécialisés pour les commentaires, les tests, la gestion des erreurs, la conception des types, la qualité du code et la simplification, orchestrés par /review-pr.

Référence​

ChampValeur
Nompr-review-toolkit
Version1.0.0
CatégorieProductivité
LicenceAucune valeur
Sourcecatalog/navin/builtin_plugins/pr-review-toolkit/plugin.json
READMEcatalog/navin/builtin_plugins/pr-review-toolkit/README.md
Digestsha256:3dd407df62581242fc7c4506ddf3dbbea288291350295e55b0881f1cd0bf172e
plugin.jsonagents, category, commands, description, name, skills, steps, version

Commandes​

NomArgumentsDescription
/review-pr[comments|tests|errors|types|code|simplify|all] [parallel]Relire le changement en cours ou une pull request avec des agents spécialisés (code, tests, erreurs, types, commentaires, simplification)

Agents​

NomOutilsModèleDescription
code-reviewerread_file, grep, find_files, list_dir, code_index, lsp, code_review, web_fetch, web_search-Relit le code à la recherche de bugs, d'erreurs de logique, de failles de sécurité, de problèmes de qualité et d'écarts aux conventions du projet, note la confiance de chaque constat et ne signale que les plus prioritaires. À utiliser quand du code a été écrit ou modifié et doit être relu avant d'être fusionné.
comment-analyzerread_file, grep, find_files, list_dir, code_index, lsp, code_review-Vérifie que les commentaires et les docstrings sont exacts par rapport au code, complets et utiles dans la durée, et signale les commentaires devenus obsolètes. À utiliser quand des commentaires de documentation ont été écrits ou modifiés, avant de finaliser une pull request qui touche des commentaires, ou pour auditer la dette technique des commentaires existants.
pr-test-analyzerread_file, grep, find_files, list_dir, code_index, lsp, code_review-Relit la couverture de tests d'un changement : complétude du comportement, lacunes critiques et qualité des tests, en notant chaque test manquant selon son importance. À utiliser quand une pull request est ouverte ou mise à jour, quand un nouveau comportement a été ajouté, ou avant de déclarer un changement prêt pour la revue.
silent-failure-hunterread_file, grep, find_files, list_dir, code_index, lsp, code_review-Traque les échecs silencieux, les erreurs avalées, les blocs catch trop larges et les solutions de repli injustifiées dans le code modifié, et signale chacun avec sa sévérité, les erreurs masquées et un exemple corrigé. À utiliser quand un changement ajoute ou modifie la gestion des erreurs, des blocs try/except ou catch, une logique de repli, des nouvelles tentatives, ou tout ce qui pourrait masquer une erreur.
type-design-analyzerread_file, grep, find_files, list_dir, code_index, lsp, code_review-Analyse la conception des types nouveaux ou modifiés (invariants, encapsulation, contrôle) et note de 1 à 10 l'encapsulation, l'expression des invariants, l'utilité et le contrôle. À utiliser quand un type, une classe, un modèle ou un schéma est introduit, quand une pull request ajoute des types de données, ou quand un type existant est refactorisé.
code-simplifierread_file, grep, find_files, list_dir, code_index, lsp, code_review, apply_patch, edit_file, verify, test_run-Simplifie le code récemment écrit ou modifié pour plus de clarté, de cohérence et de maintenabilité tout en préservant exactement son comportement, selon les conventions du projet. À utiliser quand une tâche de code ou un bloc logique est terminé, après une revue réussie, ou quand le code fonctionne mais paraît plus complexe que nécessaire.

Skills​

NomDescription
code-reviewerRelire les modifications de code pour détecter les bugs, les failles de sécurité, les régressions et les problèmes de maintenabilité.
test-generatorGénérer et exécuter des tests unitaires, d'API et E2E (y compris Playwright) conformes aux conventions du projet.

Hooks, serveurs MCP et réglages​

plugin.json ne déclare aucun hook, aucun serveur MCP et aucun réglage : le plugin se compose uniquement des éléments ci-dessus.

Étapes de travail​

ÉtapeUtiliser
relire un changement sous tous les angles/review-pr
relire les changements locaux au regard des règles du projetagent:code-reviewer
vérifier les commentaires et les docstringsagent:comment-analyzer
vérifier la couverture de testsagent:pr-test-analyzer
traquer les échecs silencieux dans la gestion des erreursagent:silent-failure-hunter
relire les nouveaux types et leurs invariantsagent:type-design-analyzer
simplifier le code après la revueagent:code-simplifier
écrire les tests manquantsskill:test-generator

L'activer dans un projet​

Activer pr-review-toolkit crée 10 activations dans le projet : le plugin lui-même, 2 skills, 1 commande et 6 agents. Retirer l'activation du plugin les retire toutes.

curl -X POST <control-plane-url>/v1/projects/<project>/navin-library/activations \
-H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
-d '{"kind": "plugin", "name": "pr-review-toolkit"}'

<project> : identifiant ou slug du projet. <token> : clé d'API avec le rôle éditeur sur le projet.

client.navin_library.activate("<project>", "plugin", "pr-review-toolkit")