Como usar
- Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
- Consulte no original as ferramentas, credenciais e ambientes necessários.
- Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/nphu0811/pmg-skills --skill pmg-qa-auditAntes de começar
- A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
- Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.
Read-only QA Audit & Immutable Certification (v2.4.0)
Own inspection and defect detection. Use pmg.validation.validate_presentation, pmg.validator.StaticValidator, pmg.diagnostics.DiagnosticClassifier, and shared ComprehensiveValidationReport. Do not create a parallel validator, repair objects or start an unauthorized repair loop.
Three-Level QA Audit Framework
- Level 1 — Structural Validation (Package & OOXML):
- ZIP package integrity, XML parsing, OPC ContentTypes (
[Content_Types].xml). - Relationships (
_rels/.rels,ppt/_rels/*), unique shape and animation IDs. - Animation targets (
<p:spTgt spid="...">matches existing shape). - Intra-slide
<p:timing>trees (mainSeq,bldLst,<p:set>visibility). - Morph continuity (
<p159:morph>, matching!!object tags). - Missing or orphaned media parts.
- Level 2 — Visual Validation (Slide Rendering & Geometry):
- Slide rendering via available backend (PowerPoint COM or LibreOffice).
- Bounding box overflow (elements outside 16:9 13.333" x 7.5" canvas).
- Obvious clipping, text truncation, and missing fonts.
- If renderer is missing, reports:
SKIPPED — No slide rendering backend available. - Static slide rendering does NOT prove animation correctness.
- Level 3 — Native PowerPoint Playback Validation:
- Real Microsoft PowerPoint Desktop execution (local COM or remote Windows worker).
- Clean-open preflight (
ppAlertsAll=2,OpenAndRepair=False). - Measured export and Slide Show recording frame rates (requested 60 FPS vs actual).
- If PowerPoint Desktop is unavailable, reports:
NOT_TESTED — PowerPoint Desktop unavailable. - Never report Level 3 PASS without actual Microsoft PowerPoint Desktop execution.
Standardized Diagnostics & Immutable Certification
- Error Classification: Classify detected defects into standard
ErrorCodecategories:
PKG_INVALID_ZIP, XML_PARSE_FAILURE, REL_BROKEN_TARGET, OPC_MISSING_CONTENT_TYPE, SHP_DUPLICATE_ID, ANIM_MISSING_TARGET, TIMING_INVALID_REFERENCE, MORPH_IDENTITY_COLLISION, PPT_OPEN_FAILURE.
- Immutable Certification: Certified presentations receive an
ImmutableValidationCertificatecryptographically bound to the artifact's exact SHA-256 hash. Any byte-level modification invalidates the certificate.
# Validate existing presentation across available levels
pmg validate deck.pptx [--json]
pmg inspect deck.pptx --timeline-out expected_timeline.json
pmg qa deck.pptx [--remote]from pmg.validation import validate_presentation
from pmg.self_healing import issue_validation_certificate, verify_certificate
report = validate_presentation("deck.pptx")
cert = issue_validation_certificate("deck.pptx", validation_level="Level 1 Structural", overall_status=report.overall_status.value)
is_valid, msg = verify_certificate(cert, "deck.pptx")
print(f"Certified: {cert.certificate_id}, Valid={is_valid}")
