de liza124
Identifie les contrats manquants au niveau des fonctions et complète les docstrings et les annotations de type ; signale les lacunes ambiguës avec des scénarios de mauvais usage. Incrémental et piloté par l'état.
Le Remplissage des Spécifications de Code automatise la détection et la remédiation des contrats manquants ou faibles au niveau des fonctions dans une base de code. La compétence inspecte les fichiers marqués comme obsolètes ou non revus, liste les callables publics, évalue si un contrat comportemental existe, et soit complète les docstrings/indices de type là où ils sont sûrement inférables, soit enregistre un scénario de mauvais usage lorsque le comportement est ambigu. Elle ne modifie intentionnellement jamais le comportement d'exécution — seulement la documentation et les informations de type.
Exécutez-le de manière incrémentale pour rattraper la dette de contrat après des commits ou selon un calendrier ; utilisez le mode Fichiers pour des audits de modules ciblés. Utilisez-le avant l'intégration de nouveaux développeurs, après de gros refactoring, ou lorsque la couverture de tests révèle des contrats d'API ambigus. Il est conçu pour les bases de code où la documentation et l'hygiène des types sont importantes.
Idéal avec des agents assistants développeurs capables d'analyse et de modification de code (Codex, Copilot/Code, ou Claude Code). S'intègre également aux outils côté CI pour des audits automatisés.
Code-spec-backfill is a well-crafted skill for incrementally backfilling missing docstrings and type annotations in codebases. It uses a state-driven approach (YAML state file tracking per-file review freshness) and applies a clever misuse-scenario heuristic as a quality gate — only documenting gaps where incorrect usage would actually cause harm. The no-tautology rule prevents low-value docstrings. No scripts included; purely instruction-based. Clean, no security concerns.
No scripts to execute — static analysis only. SKILL.md is thorough with clear workflow, stop conditions, and integration guidance. Misuse-scenario format is a strong design choice that prevents over-documentation.
