사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/nphu0811/pmg-skills --skill pmg-engine시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
PMG Universal Runtime & Motion Intelligence Engine (v2.4.0)
PMG v2.4.0 provides a production-quality, capability-aware PowerPoint generation, validation, and self-healing system. The compiler produces 100% native, editable PowerPoint presentations across:
- Mode A: Web / Sandbox (Claude Web, ChatGPT sandbox, restricted Linux environments without Microsoft PowerPoint or internet).
- Mode B: Local Desktop (Windows, macOS, Linux with local Python and optional PowerPoint COM/AppleScript).
- Mode C: Remote Worker (configured & authenticated Windows validation worker with Bearer token authentication).
Critical Invariant: Creating native PowerPoint animations does NOT require Microsoft PowerPoint to be installed. Microsoft PowerPoint is an optional Level 3 validation and playback backend, never a compilation prerequisite.
Unified Architecture Overview
- v2.1.0 Universal Runtime: Deterministic capability detection (
pmg doctor), offline-first 6-tier dependency resolution, and Three-Level Validation. - v2.2.0 Native Animation Compiler: Decoupled Animation Intermediate Representation (
AnimationIR), explicit Capability Catalog, deterministicTimelineCompilerwith cycle detection, andMorphReliabilityValidatorfor persistent traveling entity tracking. - v2.3.0 Distributed PowerPoint QA: Remote Windows PowerPoint validation worker, secure Bearer token authentication, artifact SHA-256 integrity verification, and idempotent job lifecycle (
CREATED -> QUEUED -> RUNNING -> COMPLETED / FAILED / TIMED_OUT / CANCELLED). - v2.4.0 Self-Healing Compatibility: Standardized
ErrorCodediagnostics, transactional repair pipeline with automatic rollback (TransactionalRepairManager), bounded 3-retry limit, safe automatic repair of missing ContentTypes and duplicate IDs, andImmutableValidationCertificatecryptographically bound to artifact SHA-256.
Universal Agent Execution Workflow
All AI agents (Claude Web, ChatGPT, Claude Code, Codex, local agents) follow this canonical execution workflow:
- Inspect Environment Capabilities:
Run pmg doctor or query in Python:
from pmg import PMGRuntime
runtime = PMGRuntime.auto()
print(runtime.doctor())- Determine PMG Accessibility:
Verify if Python and core dependencies (python-pptx, lxml, Pillow) are present.
- If available, use the active runtime directly.
- If missing in an offline environment, inspect cached wheels via
PMG_OFFLINE_CACHEor local./wheels. - Never abandon PMG merely because
pip installor network access fails if core dependencies are already present! - If the environment strictly prohibits code execution, honestly report that limitation rather than pretending to execute PMG.
- Select Execution Backend:
- No PowerPoint installed -> Mode A (Web/Sandbox). Compiles native PPTX and executes Level 1 structural validation.
- Windows with PowerPoint -> Mode B (Local Desktop). Compiles native PPTX and executes Level 1, Level 2, and Level 3 playback validation.
- Remote worker configured -> Mode C (Remote Worker). Compiles natively and submits candidate for remote Windows PowerPoint playback validation.
- Build Presentation Using Shared Native Compiler:
Compile from project JSON specification, dictionary, or AnimationIR:
result = runtime.build(
project="presentation_spec.json", # or AnimationIR instance or preset
output="presentation.pptx",
validate=True,
repair="safe",
)
print(result.output_path)
print(result.artifact_sha256)
print(result.validation_report.overall_status)Or via CLI:
pmg build presentation_spec.json -o presentation.pptx --repair safe
pmg build --preset space --slides 10 -o space.pptx- Run All Available Validation Levels:
- Level 1 (Structural): Always executed. Validates ZIP integrity, XML well-formedness, OPC ContentTypes, relationships, unique shape IDs, animation target existence, and
<p:timing>trees. - Level 2 (Visual): Executed when slide renderer (PowerPoint or LibreOffice) is available. Checks boundary overflow and generates slide previews. If unavailable, reports
SKIPPED — No slide rendering backend available. - Level 3 (Playback): Executed when Microsoft PowerPoint automation is genuinely available. Verifies clean opening (
ppAlertsAll=2, no repair prompts) and Slide Show playback. If unavailable, reports:
NOT_TESTED — PowerPoint Desktop unavailable. Never report Level 3 PASS without actual Microsoft PowerPoint Desktop execution.
- Apply Transactional Self-Healing if Defects Detected:
- When defects are detected, invoke
TransactionalRepairManager. - Apply only
SAFE_AUTOMATICrepairs: missing ContentTypes, duplicate shape IDs, dangling animation targets. - Automatically roll back to the original if repair does not achieve a valid state.
- Deliver Deliverables to User:
Deliver the final validated .pptx file along with its machine-readable validation report and immutable validation certificate.
Command-Line Interface (CLI)
# Environment diagnostics and capability inspection
pmg doctor
pmg capabilities
# Build presentation from JSON specification, AnimationIR, or preset
pmg build presentation_spec.json -o presentation.pptx --repair safe
pmg build --preset space --slides 20 -o space.pptx
# Validate existing presentation across Level 1, Level 2, Level 3
pmg validate presentation.pptx [--json]
# Transactional safe self-healing
pmg repair presentation.pptx --safe -o presentation_healed.pptx
# Distributed or local PowerPoint QA
pmg qa presentation.pptx
pmg qa presentation.pptx --remote --worker-url https://worker.internal:8765
# Render, record, and inspect (when PowerPoint / FFmpeg is available)
pmg inspect presentation.pptx --timeline-out expected_timeline.json
pmg render presentation.pptx -o powerpoint_export.mp4 --fps 60
pmg record presentation.pptx -o slideshow_recording.mp4 --fps 30
