mdpr-skill

Visão Geral

Use esta skill como um complemento opcional para o agente, para o MDPR, um runtime determinístico de Markdown para apresentação. O MDPR é responsável por análise, layout, temas, validação e renderização final em PPTX/HTML/PDF. Esta skill ajuda um agente a revisar fluxos de trabalho do MDPR, propor sugestões semânticas fracas e explicar descobertas visuais sem assumir o controle da geometria dos slides.

O código fonte da skill upstream é ch040602/mdpr-skill, que inclui esquemas, comandos de revisão, artefatos de compatibilidade, exemplos de evidências visuais e documentação de limites do MDPR.

Quando Usar Esta Skill

• Use quando o usuário perguntar sobre MDPR, mdpresent, Markdown-para-PPTX ou revisão de apresentações em Markdown.
• Use quando os artefatos gerados pelo MDPR precisarem de notas de revisão semântica, narrativa, de acessibilidade ou visual.
• Use quando o usuário desejar dicas de fluxo de trabalho de apresentação no estilo Codex, mantendo o MDPR como o renderizador determinístico.
• Use ao comparar a saída do MDPR com geradores de decks apenas de imagem, como um fluxo de trabalho estilo codex-ppt.
• Use quando uma proposta de tema ou pacote de estilos reutilizável deve ser expressa como um candidato MDPR vinculado à aprovação, em vez de edições diretas nos slides finais.

Limites Principais

• Deixe o MDPR ser o responsável por análise, divisão de slides, receitas, layout, coordenadas, geometria, tipografia, cores, ordem z, setas, efeitos, ativos de ícones exatos, IDs de objetos do renderizador e objetos PPTX finais.
• Mantenha a saída do agente semântica, baseada em evidências e válida de acordo com o esquema.
• Expresse correções como limpeza de Markdown, alterações nas regras do MDPR, alterações de configuração, alterações de política determinística ou propostas vinculadas à aprovação.
• Preserve a capacidade de construir o mesmo deck com todas as dicas do agente desativadas.
• Não modifique o Markdown fonte, a menos que o usuário solicite explicitamente um rascunho limpo da fonte.

Como Funciona

Passo 1: Identificar a Superfície do MDPR

Classifique a solicitação do usuário antes de produzir o aconselhamento:

• semantic hints: intenção compacta, sugestões de agrupamento, importância e palavras-chave de ícones.
• review report: preocupações visuais ou narrativas fundamentadas em evidências renderizadas, manifestos ou relatórios de validação.
• layout intent: objetivos de layout de alto nível de um catálogo de modelos resumido, nunca coordenadas concretas de placeholders.
• theme candidate: proposta de token reutilizável e pacote de estilos para futuros portões de aprovação/importação do MDPR.
• codex-ppt compatibility: apenas mapeamento de recursos e notas de comparação; não transforme o MDPR em um renderizador de imagem de slide completo.

Passo 2: Fundamentar Cada Descoberta

Referencie evidências disponíveis, como:

• caminho do Markdown fonte ou texto do título
• resumos do manifesto do MDPR
• caminhos de imagem de pré-visualização renderizada
• IDs de relatórios de validação
• notas fonte ou metadados de citação
• nomes de esquemas como agent-hint.json, review-report.json, ou mdpr-theme-candidate-v1

Se a evidência estiver faltando, diga qual artefato é necessário em vez de inventar um resultado de aprovação/reprovação.

Passo 3: Manter Dicas Fracas

Dicas permitidas:

• intenção de slide ou seção
• agrupamento de conteúdo
• importância relativa
• palavras-chave de busca de ícones
• notas de revisão de acessibilidade ou citação
• resumos de candidatos a imagem gerada quando um ícone seria muito pequeno ou semanticamente ambíguo

Dicas não permitidas:

• coordenadas finais, tamanhos, ordem z, geometria ou IDs de objetos
• cores exatas, tipografia, setas, efeitos ou escolhas de ativos de ícones
• IDs de layout finais ou IDs de placeholders
• decisões de validação de aprovação/reprovação não suportadas pela validação do MDPR

Passo 4: Roteie Correções para Mudanças de Propriedade do MDPR

Quando problemas repetidos aparecerem, recomende uma superfície de acompanhamento determinística:

• Limpeza de Markdown
• Mudança nas regras do MDPR
• Mudança de configuração/perfil do MDPR
• Registro de pacote de temas do MDPR
• Melhoria na validação do MDPR
• Sobrescrita local de deck vinculada à aprovação ou candidato a pacote de estilos

Comandos Locais Úteis

Execute estes apenas quando a CLI mdpr-skill upstream estiver disponível no workspace atual e os arquivos de entrada referenciados existirem.

node bin/mdpr-skill.js hint --source-sha256 <64hex> --out .mdpresent/proposals/agent-hint.json
node bin/mdpr-skill.js review --manifest dist/mdpresent-manifest.json --out .mdpresent/review/review-report.json
node bin/mdpr-skill.js narrative --markdown deck.md --manifest dist/mdpresent-manifest.json --out .mdpresent/review/narrative-review.json
node bin/mdpr-skill.js layout-intent --layout-catalog template-layout-catalog.json --out .mdpresent/review/layout-intent.json

…