Synthèse automatique
Analyse la qualité du code dans des scripts R, Stata, Python ou Julia en utilisant un agent Debugger en mode autonome, en se concentrant sur les catégories 4 à 12 (structure, reproductibilité, qualité des figures, etc.).
Points forts
- Évaluation systématique et standardisée de la qualité du code.
- Applicable à plusieurs langages (R, Stata, Python, Julia).
- Séparation claire entre la critique et la correction (pas de modification automatique).
- Génération de rapports détaillés avec niveaux de sévérité.
Limites
- Ne couvre pas l'alignement stratégique (catégories 1-3) en mode autonome.
- Nécessite un agent Debugger configuré et accessible.
- La revue peut être longue pour de nombreux scripts.
Lorsque vous avez besoin d'une revue de code approfondie et cohérente sur plusieurs scripts, sans intervention humaine immédiate.
Lorsque vous attendez une revue incluant la pertinence métier ou stratégique du code, ou si vous souhaitez des corrections automatiques.
Analyse de sécurité
SûrThe skill uses only safe allowed tools (Read, Grep, Glob, Write, Task) and prohibits editing source files. It does not execute code or network calls, and the dispatching of a debugger agent is limited to code review tasks with no destructive actions.
Aucun point d'attention détecté
Comment cette analyse est faiteExemples
Run the review-r skill on scripts/analysis.RRun the review-r skill on all scripts in scripts/R/ and scripts/stata/Run the review-r skill on scripts/python/name: review-r description: Code review dispatching the Debugger agent in standalone mode (categories 4-12 only). Checks code quality, reproducibility, figure standards, and professional polish. Use for R, Stata, Python, or Julia scripts. argument-hint: "[filename or 'all']" allowed-tools: ["Read", "Grep", "Glob", "Write", "Task"]
Review Code Scripts
Run the code review protocol by dispatching the Debugger agent in standalone mode.
In standalone mode, the Debugger runs categories 4-12 only (code quality). Categories 1-3 (strategic alignment) require a strategy memo and are only run within the pipeline or via /econometrics-check.
Workflow
Step 1: Identify Scripts
- If
$ARGUMENTSis a specific file: review that file only - If
$ARGUMENTSisall: review all scripts inscripts/R/,scripts/stata/,scripts/python/,scripts/julia/ - If
$ARGUMENTSis a directory: review all scripts in that directory
Step 2: Launch Debugger Agent
For each script (or batch), delegate to the debugger agent via Task tool:
Prompt: Review [file] in standalone mode (categories 4-12 only).
Categories:
4. Script structure (header, sections, flow)
5. Console hygiene (no print/cat pollution, clean output)
6. Reproducibility (set.seed, relative paths, no hardcoded values)
7. Function design (DRY, appropriate abstraction level)
8. Figure quality (labels, dimensions, theme, transparency)
9. RDS pattern (saveRDS for all computed objects)
10. Comments (explain why, not what)
11. Error handling (graceful failures, informative messages)
12. Polish (consistent style, no dead code, clean namespace)
Save report to quality_reports/[script_name]_code_review.md
Step 3: Present Summary
After all reviews complete:
- Total issues found per script
- Breakdown by severity (Critical / Major / Minor)
- Top 3 most critical issues across all scripts
- Code review score
Step 4: IMPORTANT
Do NOT edit any source files. Only produce reports. Fixes are applied after user review, either manually or by re-dispatching the Coder agent.
Principles
- Standalone mode = code quality only. Strategic alignment (does the code match the design?) requires a strategy memo.
- Language-flexible. Same categories apply to R, Stata, Python, Julia — adapt checks to language idioms.
- Proportional severity. A missing
set.seed()is Major. A missing comment is Minor. - Worker-critic separation. The Debugger never fixes code — it only critiques.
Specification Design-to-Dev
Developpement
Traduisez vos maquettes en specifications techniques pour les developpeurs.
Patterns d'exports et fichiers barrel
Developpement
Définit les conventions pour les exports de modules et les fichiers baril : exports nommés uniquement, pas de wildcards plats (sauf `export * as Name` pour les composants composés), commentaires par section, types exportés avec les valeurs, et une ligne d'export par fichier source. Aide à maintenir des exports cohérents et optimisés pour le tree-shaking dans les applications portal utilisant Turbopack ou des bundlers similaires.
Créer une compétence d'agent
Developpement
Guide étape par étape pour créer une compétence d'agent structurée, incluant structure de répertoire, format SKILL.md et principes de conception.