CommunityImagegithub.com

dessin-revue (drawing-review)

Examen ciblé des PDF de plans d'exécution et génération de rapports de revue. Extrait la couche texte, supprime les cartouches et anonymise les informations sensibles, puis vérifie chaque point de la grille de relecture avec des preuves textuelles, et produit un rapport Markdown avec localisation et niveaux de preuve.

Qu'est-ce que dessin-revue (drawing-review) ?

Cette compétence, nommée 'dessin-revue', permet à un agent IA (comme Claude Code, Cursor ou Codex) d'effectuer une revue technique automatisée de PDF de plans d'exécution (plans de construction, notes de calcul, rapports géotechniques) en langue chinoise. L'agent extrait d'abord localement la couche texte des PDF, supprime les cartouches et anonymise les données sensibles (noms, entreprises). Ensuite, il parcourt une grille de relecture prédéfinie pour identifier les problèmes pouvant être prouvés par le texte original : contradictions internes dans les notes, incohérences entre les pièces et les armatures, discordances entre les plans et les notes de calcul/rapports, erreurs de calcul dans les formules, références aux normes, etc. Chaque constat est associé à une citation textuelle et à un identifiant de bloc, et les scripts vérifient la localisation de chaque citation dans l'image d'origine. L'agent peut utiliser des images masquées en option pour faciliter l'attribution des textes, ou se baser uniquement sur les coordonnées textuelles. L'utilisateur lance cette compétence avec des termes comme 'revue de plans', 'examen de dessins', 'vérification avant édition', 'génération de rapport de revue'. Le résultat est une liste de problèmes potentiels destinée à l'équipe de conception, et non un avis de conformité officiel.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qiushanyueyue/drawing-review-skill/tree/HEAD/drawing-review

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · 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

Examen de plans d'exécution (drawing-review)

Confiez à l'agent le processus suivant : "glisser les plans → analyse automatique → vérification selon une grille → résultats traçables dans le dessin original → confirmation humaine". Le résultat est une liste de problèmes potentiels à vérifier par les concepteurs, et non un avis d'examen formel ou une conclusion de conformité.

Règles impératives

  1. Ne pas examiner ni divulguer les cartouches et informations d'identité. Les cartouches (signatures de conception, vérification, approbation, etc., noms des entreprises, nom du projet, dates, tampons, numéros de certificat, téléphones) sont des données anonymisées et ne font pas partie de l'examen. Ne signalez pas de problèmes comme "signature manquante", "écriture du nom de l'entreprise", "date du cartouche", etc.
  2. N'ouvrez jamais les plans originaux directement. Lisez uniquement les fichiers générés par extract : review_input.md, blocks.jsonl, coverage.json. En mode image, ne regardez que les images listées dans images.json, déjà masquées localement. mapping.local.json contient la correspondance avec le texte original, ne le lisez, ne le référencez et ne le téléchargez jamais. Conservez les espaces réservés (ex. [Unité1]) dans le rapport, ne tentez pas de les rétablir.
  3. Ne signalez que les problèmes prouvables par le texte original du plan. Chaque problème doit comporter au moins une citation textuelle + un identifiant de bloc (ex. F1-P3-B12). Ne signalez pas ce qui ne peut pas être prouvé par le texte donné. L'ordre d'extraction du PDF ne doit pas faire considérer des textes adjacents comme faisant partie du même élément.
  4. La correspondance entre objets doit être prouvée. Avant de comparer deux textes, confirmez qu'ils se réfèrent au même élément/coupe/zone/condition de charge (même numérotation avec une zone d'étage claire, renvoi explicite à un détail, même clause dans le contexte). Les comparaisons entre pages et entre fichiers doivent comporter object_match: "explicit" et expliquer le fondement dans basis. Si ce n'est qu'une déduction, écrivez inferred ; le script rétrogradera l'élément en "condition supplémentaire nécessaire".
  5. Les conclusions normatives doivent être étayées par des sources vérifiables. N'affirmez pas de mémoire que "la norme exige telle valeur", n'inventez pas de numéros d'articles. Seules les règles vérifiées dans references/verified-rules.md peuvent conclure à une "valeur inférieure à la norme". Pour les autres normes, écrivez "article correspondant à vérifier" ou needs_context. Vérifiez en ligne si une norme est en vigueur ; si impossible, écrivez "non vérifié".
  6. Laissez les scripts effectuer les calculs numériques. Pour vérifier les formules des notes de calcul, les surfaces d'acier, les taux d'armature, utilisez la commande calc ou écrivez calculation dans les constats. Ne faites pas de calcul mental. Si un paramètre manque, écrivez needs_context, ne complétez jamais les paramètres vous-même.
  7. L'interprétation d'images est uniquement un support. Les dimensions ou armatures lues sur l'image mais non corroborées par la couche texte ne peuvent être que des "conditions supplémentaires à vérifier" et doivent préciser "à vérifier sur le plan original". N'inventez pas de diamètres, espacements ou nombres de barres illisibles.
  8. Mieux vaut peu que beaucoup. La valeur réside dans un faible nombre de constats précis. Les mêmes problèmes apparaissant à plusieurs endroits doivent être fusionnés en un seul constat listant toutes les positions. "Aucun problème trouvé" signifie seulement qu'aucun problème n'a été détecté dans le cadre de cette vérification et dans la plage lisible, n'écrivez jamais "conforme/examen réussi".

Procédure

Étape 0 : Définir le périmètre et le mode (une ou deux phrases, ne faites pas remplir de formulaire à l'utilisateur)

  • Si l'utilisateur a donné des points de vérification précis (ex. "uniquement l'étanchéité", "vérifier en priorité les armatures des poutres", "cette coupe correspond-elle aux notes de calcul"), suivez-les. Sinon, utilisez tous les points de la grille references/review-checklist.md.
  • Si la spécialité technique n'est pas claire, ne devinez pas ; indiquez "spécialité inconnue" et effectuez uniquement les vérifications génériques. Pour les normes locales, demandez à l'utilisateur la province concernée. Le nom du projet étant anonymisé, ne déduisez rien des espaces réservés.
  • Choisir le mode :
    • Mode texte (par défaut, utilisable par tout modèle) : lisez uniquement la couche texte, utilisez les coordonnées des blocs et la commande near pour déterminer l'appartenance des annotations.
    • Mode image (optionnel) : uniquement si vous pouvez effectivement voir les images et que l'utilisateur a explicitement accepté de transmettre les pages masquées localement au modèle actuel. Après l'étape 1, s'il y a des pages "principalement graphiques" ou si l'utilisateur souhaite vérifier des armatures/dimensions, demandez en une phrase : "Ces pages sont principalement graphiques. Voulez-vous que je vous montre les pages avec les cartouches et informations sensibles masqués pour m'aider à attribuer les annotations ?". Si vous ne pouvez pas voir les images, ne demandez pas et utilisez le mode texte.

Étape 1 : Extraction locale et anonymisation

pip install pdfplumber              # Première utilisation ; en Chine, ajoutez -i https://pypi.tuna.tsinghua.edu.cn/simple
python scripts/drawing_review.py extract <plan1.pdf> [notes_de_calcul.pdf rapport_géotechnique.pdf ...] --out review_pack [--extra-terms mots_sensibles.txt]
  • Uniquement PDF (doit contenir une couche texte ; les PDF vectoriels directement exportés depuis la CAO sont les meilleurs). Si l'utilisateur fournit des DWG/DXF, demandez-lui d'exporter en PDF depuis la CAO. Les pages scannées ou dont les polices ne sont pas décodables sont marquées "non examinées". Ne faites pas d'OCR et ne devinez pas le contenu.
  • Plusieurs fichiers sont extraits ensemble ; les identifiants de bloc incluent automatiquement le numéro de fichier (F1, F2…), ce qui évite les confusions lors des comparaisons entre fichiers. coverage.json contient le SHA-256 et le type présumé de chaque fichier (plan/note de calcul/rapport géotechnique).
  • --extra-terms : mots sensibles supplémentaires spécifiés par l'utilisateur (abréviations de projet, noms de lieux, noms de personnes), un par ligne.
  • Informez d'abord l'utilisateur : nombre total de pages, nombre de pages examinées / principalement graphiques (peu de texte) / non examinées, nombre de textes de cartouches supprimés, nombre d'informations sensibles remplacées. Si des "alertes de reconnaissance de cartouche" ou de "possibles résidus de noms" sont détectées, mentionnez-le également.

Étape 2 : Lecture des documents d'examen et vérification selon la grille

Lisez review_pack/review_input.md (divisez page par page si trop long) et references/review-checklist.md. Si nécessaire, lisez references/verified-rules.md.

  • Parcourez chaque point de la grille. Pour chaque lot de pages, il y a généralement 0 à 2 problèmes réellement certains.
  • Pages de notes de conception : vérifiez selon les points C1 à C9. Extrayez simultanément les paramètres clés (objet + paramètre + valeur + citation) pour les comparaisons entre pages et entre fichiers (C8, C12, C13).
  • Pages de plans (plans d'armatures, coupes, vues en plan) : les courtes annotations sont accompagnées de coordonnées @x,y. Pour déterminer à quel élément une annotation appartient, exécutez python scripts/drawing_review.py near --pack review_pack --block F1-P3-B12 (liste les textes environnants, direction, distance) ou near --page F1-P3 --region x0,y0,x1,y1 (liste les textes dans une région). La proximité n'implique pas de relation ; si l'appartenance n'est pas claire, ne comparez pas.
  • Notes de calcul : vérifiez les formules et résultats avec python scripts/drawing_review.py calc "expression" (prend en charge As(d,n), As_s(d,s), rho(As,b,h0), sqrt, sind, etc.). Signalez uniquement les erreurs de recopie, de substitution et de calcul (C14), n'évaluez pas le choix du modèle de calcul.
  • Mode image (si l'étape 0 a obtenu l'accord) :
    1. python scripts/drawing_review.py render <mêmes PDF...> --pack review_pack [--pages F1-P3,F1-P5]. Consultez les pages entières listées dans images.json (les cadres noirs sont des zones masquées, les nombres en grille bleue sont les coordonnées de la page).
    2. Pour les détails : python scripts/drawing_review.py zoom <PDF> --pack review_pack --page F1-P3 --region x0,y0,x1,y1 (les coordonnées sont lues sur les nombres de la grille). La sortie liste les blocs de texte dans cette région, facilitant les références.
    3. L'image est utilisée pour déterminer la correspondance entre annotations, hachures de coupe, renvois et éléments. Les conclusions doivent toujours citer des blocs de texte. Les preuves visuelles sont écrites dans visual_evidence (page, coordonnées de la région, texte lu).
    4. Les pages scannées ou avec des polices illisibles ne sont pas rendues par défaut. N'ajoutez pas --allow-unmasked-pages, sauf si l'utilisateur accepte explicitement et sait que ces pages n'ont subi qu'un masquage conservateur sur les bords.
  • Chaque constat potentiel est écrit dans la structure JSON définie par references/report-format.md et enregistré dans review_pack/findings.json (incluez check_method, object, object_match, et calculation pour les vérifications de calcul).

Étape 3 : Contre-argumentation et vérification personnelle (obligatoire)

Pour chaque constat potentiel, jouez le rôle d'un vérificateur strict et tentez de le réfuter : s'agit-il d'un décalage dû à l'ordre d'extraction ? Est-ce que différentes zones/conditions de charge/étapes de construction sont naturellement différentes ? Les deux textes peuvent-ils être confirmés comme appartenant au même objet ? La formulation est-elle une convention courante dans le secteur ? La conclusion repose-t-elle sur des connaissances externes ? Le recalcul a-t-il utilisé des paramètres absents du plan ? En cas de doute, supprimez le constat ou rétrogradez-le en needs_context. Dans le JSON, écrivez clairement basis (fondement du jugement) et uncertainties (conditions non confirmées).

Étape 4 : Vérification et génération du rapport

python scripts/drawing_review.py verify --pack review_pack --findings review_pack/findings.json
python scripts/drawing_review.py evidence <mêmes PDF...> --pack review_pack     # Optionnel : génère des captures d'écran masquées du plan original pour chaque problème
python scripts/drawing_review.py report --pack review_pack --title "Rapport d'examen XX (Auto-assistance IA)"
  • verify attribue à chaque problème un niveau de preuve : E1 la citation apparaît-elle textuellement dans le bloc indiqué (ou dans les blocs suivants contigus) ; E2 la comparaison entre pages/fichiers déclare-t-elle et explique-t-elle la correspondance des objets ; E3 le recalcul confirme-t-il une incohérence numérique. Si la citation n'est trouvée que dans une autre page/fichier, elle n'est pas considérée comme localisée (relocated_candidate) et le problème est rétrogradé en "indice à vérifier" ; si la correspondance des objets n'est pas confirmée ou repose uniquement sur une lecture visuelle, le problème est rétrogradé en "condition supplémentaire nécessaire" ; si le recalcul est cohérent avec le fichier, le problème de calcul est rétrogradé en indice.
  • Si le nombre de rétrogradations est élevé, revenez à l'étape 2 pour vérifier les citations, les identifiants de bloc et les correspondances d'objets, puis corrigez et relancez. Ne modifiez ni n'inventez de citations pour passer la vérification.
  • evidence génère uniquement les captures localement, avec des cadres rouges pour localiser les preuves et des cadres noirs pour le masquage. En mode texte, il n'est pas nécessaire de visualiser ces images.
  • report génère review_pack/rapport_d_examen.md. Pour obtenir un Word/PDF, convertissez à partir de ce fichier sans ajouter ni supprimer de conclusions.

Étape 5 : Présentation à l'utilisateur

En 3 à 6 lignes, résumez : nombre de problèmes suspects (listez les 1 à 3 plus importants avec titre et position), nombre de conditions supplémentaires nécessaires, pages/contenu non examinés, utilisation éventuelle du mode image, chemin du fichier de rapport. Rappelez que les problèmes du rapport doivent être confirmés manuellement un par un. Lorsque l'utilisateur confirme ou exclut un problème, conservez sa décision (review_status) dans les examens ultérieurs, sans qu'elle soit écrasée par une nouvelle vérification.

Réexamen (après modification)

Lorsque l'utilisateur fournit une nouvelle version des plans : réexécutez extract dans un nouveau répertoire (SHA-256 différent = nouvelle version). Après l'examen, comparez avec la version précédente verified.json. Les problèmes présents dans la version précédente mais absents de la nouvelle sont écrits comme "n'est plus apparu cette fois" (peut être modifié ou non détecté en raison de différences de reconnaissance). Ne dites pas "corrigé". Les problèmes exclus par l'utilisateur dans la version précédente restent exclus.

Fichiers de référence

  • references/review-checklist.md : Grille des points de vérification (C1 à C15, incluant géométrie des plans, armatures, correspondance avec les notes de calcul et les paramètres géotechniques, recalcul des formules, étapes de construction), points d'attention par spécialité technique, contenu à ne pas signaler.
  • references/verified-rules.md : Règles normatives vérifiées et applicables (ex. classe de résistance minimale du béton) et substitutions de normes vérifiées.
  • references/desensitization.md : Périmètre d'anonymisation, signification des espaces réservés, méthodes et limites de la reconnaissance des cartouches et du masquage d'images.
  • references/report-format.md : Champs de findings.json, classification des conclusions, classification des preuves, structure du rapport.

Skills associés