Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/nphu0811/pmg-skills --skill pmg-qa-auditAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
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}")
