CommunityImagemgithub.com

drawing-review (review-input)

Realiza análise direcionada de projetos de construção em PDF e gera relatórios de revisão.

O que é drawing-review (review-input)?

O skill 'drawing-review' automatiza o processo de revisão de plantas de construção em PDF, extraindo a camada de texto, desidentificando informações sensíveis (como selos, nomes de empresas e engenheiros) e analisando sistematicamente o projeto com base em uma lista de verificação. Ele suporta verificação de consistência entre parâmetros internos, correspondência entre componentes e armaduras, concordância entre desenhos e cálculos/relatórios geotécnicos, verificação de fórmulas, versões de normas citadas, resistência mínima do concreto, numeração de notas, erros de texto e muito mais. Cada problema encontrado é amparado por citações textualmente verificáveis e coordenadas de bloco, com um sistema de classificação de evidências (E1, E2, E3) e relatório final em Markdown. Funciona em modo texto (com coordenadas) ou, opcionalmente, em modo imagem (se o modelo puder processar imagens). O foco está em gerar uma lista concisa e precisa de problemas candidatos para revisão humana, evitando conclusões definitivas ou alegações de conformidade regulatória sem verificação externa.

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

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Revisão de Projetos de Construção (drawing-review)

Transfere para você o fluxo de revisão: "Arraste o desenho → Análise automática → Verificação por lista → Resultado rastreável ao original → Confirmação manual". O resultado é uma lista de problemas candidatos para verificação dos projetistas, não uma opinião formal de revisão nem uma conclusão de conformidade.

Regras Inderrogáveis

  1. Selos e informações de identidade não são revisados nem divulgados. Selos (identificação de projeto, verificação, aprovação, etc., unidade projetista, contratante, nome do empreendimento, datas, carimbos, números de registro, telefones) são dados desidentificados e não fazem parte do escopo de revisão. Não relate problemas como "assinatura faltando", "grafia do nome da empresa" ou "data do selo".
  2. Não abra os desenhos originais diretamente. Leia apenas os arquivos gerados pelo extract: review_input.md, blocks.jsonl e coverage.json. Em modo imagem, visualize apenas as imagens listadas em images.json, que já foram mascaradas no computador local. O arquivo mapping.local.json contém a correspondência com o original; nunca leia, referencie ou faça upload dele. Mantenha substituições (ex: [Unidade1]) no relatório, não tente restaurá-las.
  3. Relate apenas problemas comprováveis pelo texto do desenho original. Cada problema deve ter pelo menos uma citação textual contínua de um bloco (ex: F1-P3-B12). Não reporte problemas que não possam ser comprovados pelo texto fornecido; não considere "textos adjacentes" devido à ordem de extração do PDF como pertencentes ao mesmo componente.
  4. A correspondência entre objetos deve ser comprovável. Antes de comparar textos de duas localizações, confirme que se referem ao mesmo componente/seção/parte/caso (mesmo número e área de andar clara, referência explícita de detalhe, contexto da mesma cláusula). Comparações entre páginas ou arquivos devem incluir object_match: "explicit" e justificar o fundamento em basis. Se apenas inferido, escreva inferred, e o script rebaixará para "necessita condição complementar".
  5. Conclusões normativas devem ter fundamento verificável. Não afirme de memória que "a norma exige o valor X" nem invente números de artigos. Apenas as regras verificadas em references/verified-rules.md podem dar conclusões do tipo "inferior ao mínimo normativo"; para outras questões normativas, escreva apenas "artigo relacionado pendente de verificação" ou needs_context. Verifique a vigência das normas online em fontes oficiais; se não encontrar, escreva "não verificado".
  6. Deixe os cálculos para o script. Ao verificar fórmulas de cálculo, áreas de aço, taxas de armadura, use o comando calc ou escreva calculation nos achados; não faça cálculos mentais. Se faltarem parâmetros, escreva needs_context; não complete parâmetros por conta própria.
  7. A leitura de imagens é apenas auxiliar. Dimensões ou armaduras lidas visualmente que não possam ser corroboradas no texto devem ser marcadas como "necessita condição complementar", indicando a necessidade de verificação no desenho original. Não invente diâmetros, espaçamentos ou quantidades ilegíveis.
  8. Menos é mais. O valor está em ser conciso e preciso; problemas iguais em várias localizações devem ser consolidados em um único item, listando todas as posições. "Nenhum problema encontrado" significa apenas que não houve correspondência nos itens verificados e no escopo legível; não escreva "aprovado/conforme a norma".

Fluxo

Passo 0: Confirmar escopo e modo (uma ou duas frases, não faça o usuário preencher formulários)

  • Se o usuário forneceu foco de revisão (ex: "apenas impermeabilização", "verificar armadura de vigas", "se determinada seção corresponde ao cálculo"), siga-o; caso contrário, use todos os itens de references/review-checklist.md.
  • Se a especialidade não estiver clara, não adivinhe; marque "especialidade desconhecida" e faça apenas verificações genéricas. Para normas regionais, peça ao usuário que informe o estado/província; o nome do empreendimento já foi desidentificado, não inferir de placeholders.
  • Selecione o modo:
    • Modo texto (padrão, qualquer modelo): Leia apenas a camada de texto, use coordenadas de bloco e near para determinar a qual componente uma anotação pertence.
    • Modo imagem (opcional): Apenas se você puder realmente visualizar imagens e o usuário concordar explicitamente em enviar as imagens mascaradas para o modelo atual. Após o Passo 1, se houver páginas "predominantemente gráficas" ou o usuário quiser verificar armadura/dimensões, pergunte com uma frase: "Estas páginas são predominantemente gráficas. Gostaria que eu mostrasse as imagens das páginas com selos e informações sensíveis mascarados para auxiliar na identificação das anotações?" Se não puder visualizar, não pergunte; use o modo texto.

Passo 1: Extração local e desidentificação

pip install pdfplumber              # Primeira vez; na China, adicione -i https://pypi.tuna.tsinghua.edu.cn/simple
python scripts/drawing_review.py extract <desenho1.pdf> [cálculo.pdf relatório_geotécnico.pdf ...] --out review_pack [--extra-terms arquivo_palavras_sensiveis.txt]
  • Suporta apenas PDF (com camada de texto; PDF vetorial exportado diretamente do CAD é melhor). Se o usuário fornecer DWG/DXF, peça para exportar do CAD para PDF. Páginas digitalizadas ou com fontes ilegíveis são marcadas como "não revisadas"; não faça OCR ou adivinhe o conteúdo.
  • Vários arquivos são extraídos juntos; os blocos são numerados com o número do arquivo (F1, F2…), evitando confusão em comparações entre arquivos. coverage.json contém o SHA-256 de cada arquivo e o tipo inferido (desenho/cálculo/relatório geotécnico).
  • --extra-terms: Palavras sensíveis adicionais especificadas pelo usuário (abreviações do projeto, nomes de lugares, nomes de pessoas), uma por linha.
  • Informe ao usuário: total de páginas, quantas revisadas / predominantemente gráficas (pouco texto) / não revisadas, quantos blocos de selo foram removidos, quantas informações sensíveis foram substituídas; mencione se houve "dica de reconhecimento de selo" ou "possível resquício de nome".

Passo 2: Ler materiais de revisão e verificar por lista

Leia review_pack/review_input.md (se muito longo, leia por página) e references/review-checklist.md, se necessário leia references/verified-rules.md.

  • Percorra a lista item por item; cada lote de páginas geralmente rende 0–2 problemas realmente confirmados.
  • Páginas de notas de projeto: Verifique itens C1–C9. Extraia parâmetros-chave (objeto + parâmetro + valor + citação) para comparação entre páginas e arquivos (C8, C12, C13).
  • Páginas de desenhos (armadura, seções, plantas): Anotações curtas vêm com coordenadas @x,y. Para determinar a qual componente uma anotação pertence, execute: python scripts/drawing_review.py near --pack review_pack --block F1-P3-B12 (lista o texto ao redor, direção, distância), ou near --page F1-P3 --region x0,y0,x1,y1 para listar o texto em uma região. Proximidade não implica relação; se a atribuição não estiver clara, não faça a comparação.
  • Cálculos: Verifique fórmulas e resultados com python scripts/drawing_review.py calc "expressão" (suporta As(d,n), As_s(d,s), rho(As,b,h0), sqrt, sind, etc.). Relate apenas erros de transcrição, substituição ou operação (C14); não avalie a escolha do modelo de cálculo.
  • Modo imagem (com consentimento no Passo 0):
    1. Execute python scripts/drawing_review.py render <mesmos PDFs ...> --pack review_pack [--pages F1-P3,F1-P5] e visualize as páginas completas listadas em images.json (retângulos pretos são máscaras, números azuis na grade são coordenadas da página).
    2. Para detalhes, execute python scripts/drawing_review.py zoom <PDF> --pack review_pack --page F1-P3 --region x0,y0,x1,y1 (coordenadas lidas da grade). A saída lista os blocos de texto na região para referência.
    3. Use a imagem para determinar a correspondência entre anotações, marcas de corte, índices e componentes; a conclusão ainda deve citar blocos de texto. Evidências visuais vão em visual_evidence (página, coordenadas da região, texto lido).
    4. Páginas digitalizadas ou com fontes corrompidas não são renderizadas por padrão; não adicione --allow-unmasked-pages, a menos que o usuário concorde explicitamente e saiba que essas páginas tiveram apenas máscara conservadora nas bordas.
  • Cada candidato é escrito na estrutura JSON definida em references/report-format.md, salvo em review_pack/findings.json (incluindo check_method, object, object_match; cálculos incluem calculation).

Passo 3: Auto-refutação (obrigatório)

Para cada candidato, faça o papel de um revisor rigoroso e tente refutá-lo: é um desalinhamento devido à ordem de extração? É de partes/condições/fases de construção diferentes por natureza? Os dois locais podem ser confirmados como o mesmo objeto? É uma notação usual da indústria? Depende de conhecimento externo para ser válido? A verificação utilizou parâmetros não presentes nos desenhos? Em caso de dúvida, delete ou rebaixe para needs_context. Escreva no JSON basis (fundamento do julgamento) e uncertainties (condições não confirmadas).

Passo 4: Verificar e gerar relatório

python scripts/drawing_review.py verify --pack review_pack --findings review_pack/findings.json
python scripts/drawing_review.py evidence <mesmos PDFs ...> --pack review_pack     # Opcional: gera recortes das imagens mascaradas para cada problema
python scripts/drawing_review.py report --pack review_pack --title "XX Relatório de Revisão (Auto-verificação Assistida por IA)"
  • verify classifica a evidência de cada problema: E1 A citação aparece textualmente no bloco indicado (ou blocos subsequentes contínuos)? E2 A comparação entre páginas/arquivos declarou a correspondência do objeto? E3 O recálculo confirma a inconsistência numérica? Se a citação for encontrada apenas em outra página/arquivo, não conta como localizada (relocated_candidate), e o problema é rebaixado para "pista a investigar"; se a correspondência do objeto não for confirmada ou apenas por leitura visual, rebaixado para "necessita condição complementar"; se o recálculo for consistente com o arquivo, rebaixado para pista.
  • Se muitos problemas forem rebaixados, volte ao Passo 2, verifique citações, números de bloco e correspondência de objetos, corrija e execute novamente; não reescreva ou invente citações para passar na verificação.
  • evidence gera recortes apenas no computador local, com retângulo vermelho para a evidência e preto para a máscara; não é necessário visualizar essas imagens no modo texto.
  • report gera review_pack/review-report.md. Para exportar para Word/PDF, converta a partir deste; não adicione ou remova conclusões.

Passo 5: Relatar ao usuário

Em 3–6 linhas: número de problemas suspeitos (liste os 1–3 mais importantes com título e localização), quantos necessitam condição complementar, quais páginas/conteúdo não foram revisados, se o modo imagem foi usado, caminho do arquivo de relatório. Lembre que os problemas no relatório devem ser confirmados manualmente um a um. Após o usuário confirmar ou descartar um problema, mantenha a decisão do usuário (review_status) em revisões subsequentes, não sobrescreva.

Revisão (nova análise após modificação)

Ao receber uma nova versão dos desenhos: execute novamente extract em um novo diretório (SHA-256 diferente indica nova versão). Após a revisão, compare com o verified.json da versão anterior. Problemas que existiam na versão anterior e não na atual devem ser marcados como "não reapareceu nesta versão" (pode ter sido corrigido ou pode não ter sido detectado devido a diferenças de reconhecimento); não diga "corrigido". Problemas já descartados pelo usuário na versão anterior devem permanecer descartados.

Arquivos de Referência

  • references/review-checklist.md: Itens de verificação (C1–C15, incluindo geometria dos desenhos, armadura, correspondência entre cálculos e parâmetros geotécnicos, verificação de fórmulas, fases de construção), pontos de atenção por especialidade, conteúdo que não deve ser relatado.
  • references/verified-rules.md: Regras normativas verificadas e executáveis (resistência mínima do concreto, etc.) e substituições de normas confirmadas.
  • references/desensitization.md: Escopo da desidentificação, significado dos placeholders, método e limitações do reconhecimento de selos e da máscara de imagens.
  • references/report-format.md: Campos de findings.json, classificação de conclusões, classificação de evidências, estrutura do relatório.

Habilidades Relacionadas