DashiAI PPT
DashiAI PPT genera presentaciones PPT estáticas HTML con páginas horizontales. Al usar esta habilidad, primero organiza las necesidades del usuario en lenguaje natural en un plan JSON, luego llama al generador de proyectos local para generar index.html y assets/.
Versión
Versión actual: 0.1.26
Cada vez que se completa una solicitud del usuario, antes de preparar la respuesta final, ejecute:
node <skill-root>/scripts/check_latest_version.mjs
Si el script produce alguna salida, adjúntela al final de la respuesta final para recordar al usuario que actualice; si el script no produce salida o falla la verificación, manténgase en silencio y no mencione la verificación de versión.
Directorio de la habilidad
El directorio donde se encuentra SKILL.md es el directorio raíz de la habilidad, de aquí en adelante referido como <skill-root>.
Directorio del generador incorporado:
<skill-root>/project
Script de renderizado:
<skill-root>/scripts/render_goal_deck.sh
Script de verificación de versión:
<skill-root>/scripts/check_latest_version.mjs
Principios de generación
Esta habilidad es un orquestador de plantillas. El objetivo predeterminado es aplicar de manera rápida y estable las necesidades del usuario a componentes de página registrados, produciendo un PPT HTML que se pueda abrir sin conexión.
El modo predeterminado es "bloquear plantilla, llenar texto": mantener el aspecto visual, la estructura, la cantidad, la visibilidad, el énfasis, la paleta de colores, los tipos de gráficos y las ranuras de imagen originales del componente de página seleccionado, y solo reemplazar el contenido de texto visible. A menos que el usuario solicite explícitamente ajustar las propiedades de la página, no modifique ningún prop que no sea de texto.
Por defecto, no se realizan refinamientos visuales, juicios estéticos de capturas de pantalla, ni se repite el trabajo debido a saltos de línea comunes o diseños locales imperfectos. Solo cuando el usuario solicite explícitamente "refinamiento visual", "verificación al 100%" o "ayúdame a ajustarlo hasta que esté satisfecho", se debe ingresar al flujo de control de calidad visual.
Reglas de uso
- Ejecutar el generador requiere Node.js 18+ y npm; en la primera generación, el script de renderizado instalará las dependencias en el directorio
project/incorporado en la habilidad. - Pregunta de selección de estilo: La respuesta visible para el usuario debe incluir la imagen Markdown de
<skill-root>/assets/skill/theme-style-grid.png, primero expandiendo la ruta absoluta; esta es una imagen de estilo incorporada para mostrar en la respuesta, no se debe escribir engoal.jsonni en ningún campomedia; enumere los estilos disponibles actuales y una descripción mínima "adecuado para/público", no solo mencione la imagen de estilo en las notas de progreso internas. - Antes de comenzar, confirme dos cosas: el tema/estilo y si se necesitan imágenes/video. Cuando el usuario no lo haya expresado claramente y no sea una delegación completa, primero pregunte y espere una respuesta, no elija por él; solo en entornos donde no se pueda preguntar (scripts/procesamiento por lotes) elija usted mismo, e indique la selección y el motivo en la nota de entrega.
- Modo de delegación: solo cuando el usuario delegue explícitamente todo ("tú decides todo", "no preguntes, solo hazlo"), puede elegir el tema usted mismo, usar HTML por defecto, no usar image-gen por defecto, y explicar las suposiciones al final. Cuando el usuario solo dice que el contenido/texto es "como quieras" o "invéntalo", solo invente el contenido; no cambie arbitrariamente el estilo, número de páginas, medios, etc. que ya se hayan proporcionado; para lo que no se haya proporcionado, primero pregunte según la regla anterior.
- En entornos no interactivos/de un solo uso (sin posibilidad de preguntar): si no se especifica un estilo, elija un tema ya verificado según el tema del contenido; si no hay material real y no se pueden generar imágenes, priorice páginas sin medios, no llame a
image-gen; explique todas las suposiciones al final. - Formato de entrega: HTML por defecto; "generar PPT", "hacer PPT", "hacer una presentación", "crear un ppt" indican la forma de presentación PPT. Solo cuando se especifique explícitamente
PPTX,PowerPoint,PPTX editable,exportar PPTX,formato PPTo "formato/tipo de archivo PPT/PPTX" se debe entregar un archivo PPTX. - Archivo PPTX: primero genere el HTML e inicie el servicio de vista previa local, luego llame al servicio de exportación HTTP local; finalmente, solo proporcione la ruta del archivo PPTX o el resultado de la descarga.
- Estilos disponibles actualmente:
theme01(Neumorfismo claro),theme02(Deslumbramiento púrpura-verde),theme03(Código claro/oscuro),theme04(Caramelo de vidrio),theme05(Gráfico espectral),theme06(Gráfico oscuro),theme07(Investigación blanco frío),theme08(Experimento negro-dorado),theme09(Revista azul oscuro),theme10(Índice dorado),theme11(Crecimiento de alta energía),theme12(Neón de ondas sonoras). - En selección automática normal, no seleccione
theme10; solo úselo cuando el usuario lo especifique explícitamente, o cuando el contenido esté fuertemente relacionado con índices financieros/de inversión y se confirme mediante inspección que se puede completar.
theme01Neumorfismo claro | Adecuado para: presentaciones de productos / informes empresariales | Público: equipos de startups / gerentes de productotheme02Deslumbramiento púrpura-verde | Adecuado para: lanzamientos tecnológicos / temas de IA/conducción autónoma/robótica | Público: fundadores de empresas tecnológicas / líderes técnicostheme03Código claro/oscuro | Adecuado para: soluciones técnicas / conferencias de desarrolladores | Público: ingenieros / gerentes técnicostheme04Caramelo de vidrio | Adecuado para: marcas juveniles / productos de consumo | Público: equipos de marca / diseñadorestheme05Gráfico espectral | Adecuado para: informes de datos / análisis de mercado | Público: analistas de datos / consultorestheme06Gráfico oscuro | Adecuado para: visualización de datos densos / análisis estratégico | Público: equipos estratégicos / inversorestheme07Investigación blanco frío | Adecuado para: informes de investigación / libros blancos | Público: institutos de investigación / equipos de consultoríatheme08Experimento negro-dorado | Adecuado para: lanzamientos de alto nivel / propuestas de marca | Público: marcas premium / directores creativostheme09Revista azul oscuro | Adecuado para: historias de marca / entrevistas a personas | Público: equipos de relaciones públicas / editores de mediostheme10Índice dorado | Adecuado para: datos financieros / informes de inversión | Público: instituciones de inversión / analistas financierostheme11Crecimiento de alta energía | Adecuado para: retrospectivas de crecimiento / planes de negocio | Público: emprendedores / equipos de crecimientotheme12Neón de ondas sonoras | Adecuado para: música y entretenimiento / eventos de tendencias | Público: marcas de entretenimiento / planificadores de eventos
- No utilice tokens antiguos, temas antiguos, ranuras de medios antiguas, ramas de estilo antiguas o controles de animación de entrada antiguos.
- Para seleccionar páginas, primero use
npm --prefix <skill-root>/project run layout:query -- --theme <themePack> --role <role> --limit 8; cuando se necesiten ranuras de medios, agregue--needs-media,--planned-images <n>,--provided-images <n>o--image-gen. - Si los campos no están claros, son objetos/arrays/contadores, imágenes/medios: primero ejecute
npm --prefix <skill-root>/project run inspect:layout -- --compact <layout...>; para escribir objetos, arrays, cantidades o props de imagen: useprops:safe, para todo el archivogoaluseprops:safe -- --goal <file> --write. - Al canalizar el JSON de
layout:query/inspect:layoutal análisis del programa, usenode <skill-root>/project/scripts/layout-query.mjs/node <skill-root>/project/scripts/inspect-layout.mjsen su lugar:npm runimprime un banner de ciclo de vida antes de stdout, lo que contamina el JSON. - Para presentaciones largas: primero use
npm --prefix <skill-root>/project run goal:scaffold -- --title <title> --goal <goal> --theme <themePack> --pages <n> --chunk-size 5 --out output/<deck-name>/goal.jsonpara generar un esqueleto de diseño único ygoal.fill-plan.json, luego complete los props por segmentos segúnfillPlan. - Longitud del texto y cantidad de arrays: priorice escribir según
fillPlan.text[].maxChars,fillPlan.arrays[].visibleCount,fillPlan.arrays[].nestedArrays; los camposdisplay/metricsolo escriban palabras cortas, frases cortas o números. - Campos HTML (como
headlineHtml/quoteHtml): para escribir texto, use solo<br>para saltos de línea y<b>/<em>para énfasis en línea; está prohibido usar<span>u otros HTML libres; los valores predeterminados del tema con<span class>dependen del CSS del tema y son solo marcadores de posición, no los copie.validate:goal-specinterceptará el HTML libre. - Los elementos visibles del array deben tener texto real; los elementos finales ocultos por control de conteo/visibilidad pueden mantener el marcador de posición "Ingrese el texto".
- Las animaciones de aparición de elementos utilizan los efectos nativos del componente de página.
- Las animaciones de transición de página se pueden ajustar en el panel de control de vista previa.
- Por defecto, las presentaciones entregadas al usuario no muestran opciones de cambio de estilo/tema; el cambio de estilo solo se conserva en la página de demostración de depuración interna. Cuando el usuario solicite explícitamente conservar el cambio de tema, escriba
preview: {"themeSwitcher": true}en el nivel superior degoal. - No escriba diapositivas HTML libres a mano; cada página entregada al usuario debe escribir
layout+props.rolesolo está permitido para ayudar en la selección de páginas en la etapa de borrador; antes de renderizar, debe cambiarse a unlayoutespecífico. - Las primeras 5 páginas de cada tema, de
themeXX_page001athemeXX_page005, son candidatas a portada. Un mazo solo puede seleccionar 1 página de las primeras 5 como portada; no use varias páginas de portada simultáneamente; las páginas de contenido se seleccionan a partir de la página 6. - No repita el mismo componente de página en la misma presentación:
slides[].layoutfinal debe ser único. Al seleccionar páginas, registre loslayoutya utilizados; para páginas de contenido diferentes, use otros candidatos del mismo tema, no reutilice el mismolayoutcambiando el texto. - Las presentaciones entregadas al usuario no pueden solo escribir
roley depender del texto predeterminado de la página. A menos que el usuario solicite explícitamente la demostración predeterminada, cada página debe tener textopropscorrespondiente al tema del usuario. - Priorice solo los campos de texto expuestos por
layout:query/inspect:layout. Cuando un campo es un objeto o array, complete las claves internas segúnfillPlanypropShapes.copyKeysya ha expandido las rutas anidadas (por ejemplo,copy.quote,items[].label), complete directamente según las rutas listadas. - Para páginas marcadas con
contentLocked: trueeninspect:layout, el cuerpo de la página es fijo por el componente y no se pueden insertar props: cambie a un diseño que permita insertar contenido, o úselo solo si el usuario acepta su texto predeterminado. Llene los arrays segúnfillPlan.arrays[].visibleCountcon elementos visibles;decorativeKeysson posiciones decorativas, no las llene. - No modifique metadatos de página, código fuente del componente, className, CSS, campos de estilo o la estructura visual predeterminada para completar el contenido. Solo complete el contenido dentro de
propsy las propiedades de página solicitadas explícitamente por el usuario. - Está permitido usar
textde nivel superior para sobrescribir ranuras de texto visibles, pero solo para reemplazar contenido de texto. No inicie un navegador para extraer ranuras de texto completas de todas las páginas durante la generación normal; solo cuando el usuario solicite explícitamente "eliminar todo el texto predeterminado de la plantilla/verificar el texto visible página por página" se debe hacer la extracción de ranuras en tiempo de ejecución. - Está prohibido reutilizar archivos
goal.jsonantiguos o HTML antiguos enoutput/. Cada solicitud debe crear un nuevo directorio de salida y un nuevo plan JSON. - El directorio de salida se escribe en el directorio de trabajo de la sesión actual, no en
<skill-root>/project/output. - Entrega HTML: la dirección de vista previa para el usuario solo debe ser
http://127.0.0.1:<port>/(no proporcione variantes https o .local); la exportación HTTP local puede exportar HTML/PDF/PPTX, pero el HTML local ofile://no puede exportar PPTX editable. No devuelvatheme-preview. Al generar en una aplicación de agente con navegador incorporado (como Codex), recuerde al usuario que abra esa dirección en el navegador del sistema antes de exportar PDF/PPTX. - Entrega PPTX: llame a
/api/export-editable-pptx; finalmente, solo proporcione la ruta del archivo PPTX o el resultado de la descarga. - Sin sesión de navegador, llamada directa desde script, o cuando la interfaz de exportación de vista previa devuelva 403/5xx: use
npm run export:pptx -- <deck>/ppt <out.pptx>(para PDF useexport:pdf) para generar el archivo directamente, sin necesidad de iniciar primero una sesión de navegador. - Si el texto de salida contiene texto predeterminado no relacionado con el tema del usuario, como AI Capital / financiación / SoundWave / olas / Key Metrics / Roadmap / End of Report, etc., debe reescribir el JSON y volver a renderizar, no puede entregarlo.
Flujo de trabajo de medios
- Solo escriba campos de medios en ranuras
mediaSlots[].canPresetMedia: true, escriba la ruta segúnpresetProp/fieldPathde esa ranura;goal.jsonsolo debe hacer referencia a rutas de medios relativas dentro del mazo, no puede hacer referencia a directorios temporales, rutas absolutas externas,file://o URL remotas. - Las tareas de material visual primero determinan la intención: si no hay imágenes pero se necesita material visual, primero pregunte si se deben reservar ranuras de imagen; si no hay material real y no se pueden generar imágenes, priorice páginas sin medios. Cuando el usuario proporcione una ruta de biblioteca de materiales/directorio de materiales, se considera que hay intención de usar imágenes: seleccione al menos 2 páginas con ranuras de medios y complete con material adecuado. Si la ruta del material no es accesible, cambie a páginas sin medios e informe en la nota de entrega, no deje texto de marcador de posición en la página. Si el usuario acepta usar
--planned-images <n>/--needs-media, y el usuario proporciona material use--provided-images <n>/--provided-media; si el usuario solicita explícitamente imágenes visuales originales/generación de imágenes, en el entorno Codex use image-gen para generar imágenes y agregue--image-gen; si no se ha especificado la generación de imágenes, primero pregunte al usuario.plannedImages/needsVisual/imageGensolo indican la intención de selección de páginas; a menos que el usuario elija explícitamente reservar ranuras vacías, antes de la entrega debe escribir rutas de medios reales, no puede entregar ranuras de medios vacías o rutas falsas. - Para imágenes/videos locales del usuario, primero ejecute
npm --prefix <skill-root>/project run media:stage -- <deck-output-dir-or-ppt-dir> <media-file...>, y use la rutarelativedevuelta; los archivos AVIF se convertirán a un formato utilizable por el navegador. La salida de image-gen también debe colocarse primero en el directorio del mazo actual. - Después del renderizado, verifique cada imagen/video al que se hace referencia en
goal: queppt/<relative>exista y que el HTML contenga el nombre del archivo; si falta, solo complete elppt/assetsfinal y vuelva a ejecutar la validación. Cada imagen/video se puede usar como máximo una vez; después de usar el material, deje las ranuras de medios vacías o elija páginas sin ranuras de medios; a menos que el usuario lo solicite explícitamente, no rellene el mismo material repetidamente. - Cuando se necesite que image-gen genere más de 2 imágenes independientes, use múltiples subagentes en paralelo, no espere en serie; cada imagen se genera de forma independiente, no use una sola imagen/panel de material y luego divida. Los subagentes solo se usan para generar imágenes, no para selección de temas, texto, selección de páginas o verificación.
Flujo de trabajo
- Sintetice los objetivos del usuario:
title,goal,audience,owner, número de páginas, puntos clave del contenido y formato del producto final. Si el usuario no especifica el número de páginas, el valor predeterminado es alrededor de 10 páginas, no menos de 8. - Confirme
themePack. Si el usuario no lo especifica, primero pregunte por el estilo; después de que el usuario seleccione, genererandomSeed, por ejemplo<tema>-<fecha>-<palabra aleatoria de 3 dígitos>, para garantizar que la selección aleatoria de páginas sea reproducible. - Determine la intención de las imágenes: si no hay imágenes pero se necesita material visual, primero pregunte si se deben reservar ranuras de imagen; si el usuario proporciona material local, primero ejecute
media:stage; si se especifica la generación de imágenes, use image-gen. - Use
layout:querypara seleccionar candidatos; para props de objetos/arrays/contadores/imágenes, useinspect:layout+props:safe. - Cada página debe contener solo un rol de información principal. Para páginas que no se pueden cubrir de manera segura, priorice cambiar de diseño, no modifique los campos de estilo para forzarlo.
- Escriba el JSON en
output/<deck-name>/goal.jsonen el directorio de trabajo actual; antes de renderizar, ejecutenpm --prefix <skill-root>/project run props:safe -- --goal output/<deck-name>/goal.json --writey la validación de especificaciones de goal. Después de--write, verifique loslayoutChangesen la salida; si no está de acuerdo con el reemplazo, revierta y cambie de página. - Después de ingresar sus propios datos en las páginas de gráficos, los campos de texto de insight/lectura de gráficos/conclusión en la página deben reescribirse según los nuevos datos, no conservar las conclusiones predeterminadas.
- Ejecute el script de renderizado para generar
output/<deck-name>/ppt/index.html; el script usará el generador incorporado en la habilidad, no cambie al directorio del proyecto externo. - Después del renderizado, verifique las rutas de los materiales; si faltan, complete el
ppt/assetsfinal. - Confirme que el script haya completado las validaciones
validate:swissyvalidate:goal-copy. - Ejecute
node <skill-root>/scripts/check_latest_version.mjspara una verificación de versión silenciosa. - El script de renderizado iniciará el servicio de vista previa HTTP local y generará
http://127.0.0.1:<port>/; si necesita especificar un puerto, configureDASHI_PPT_PREVIEW_PORTantes de ejecutar el script (use puertos en el rango 5200-5999; 4178/4300/4400 son puertos reservados para el usuario y no están disponibles). Bajo el servicio de vista previa, la edición se guarda automáticamente en el archivoindex.htmloriginal; los archivos locales abiertos confile://no se guardan automáticamente, por lo que deben exportarse antes de la entrega. - Responda según el formato de entrega: para HTML, solo proporcione
http://127.0.0.1:<port>/; para PPTX, llame a/api/export-editable-pptxy luego solo proporcione la ruta del archivo o el resultado de la descarga.
Retrabajo y verificación del navegador
Solo se debe retrabajar en los siguientes casos: fallo de renderizado, fallo de validate:swiss, fallo de validate:goal-copy, aparición en la salida de texto de plantilla claramente no perteneciente al tema del usuario, o cuando el usuario indique explícitamente que hay un problema con el contenido de una página.
Por defecto, se pueden hacer un máximo de 2 rondas de corrección. Si aún falla, explique la causa del bloqueo y no continúe intentando sin límites.
Por defecto, no abra el navegador, no cree un perfil de Chrome, no extraiga ranuras de texto completas. Solo cuando se haya modificado el generador/plantilla de vista previa/lógica de exportación, el usuario solicite explícitamente verificar el efecto de la página, o en la ronda anterior haya habido un problema de sobrescritura de props por valores predeterminados después de la ejecución, se debe realizar una verificación rápida (smoke check) del navegador.
La verificación rápida del navegador solo confirma que la página se abre, el número de páginas es correcto y la primera y última página no están en blanco. No realice capturas de pantalla ni refinamientos por defecto, ni rehaga el trabajo repetidamente debido a problemas comunes de saltos de línea.
Comando de ejemplo:
<skill-root>/scripts/render_goal_deck.sh \
output/client-review/goal.json \
output/client-review/ppt/index.html
Estructura JSON
{
"title": "Encuesta de financiación de IA en EE.UU.",
"goal": "Informar al equipo de inversión sobre la estructura de financiación a gran escala de IA en EE.UU. 2024-2026, los flujos de capital y el juicio posterior",
"audience": "Equipo de inversión / Equipo de investigación industrial",
"owner": "Equipo de investigación",
"randomSeed": "ai-funding-20260609-a7k",
"pageCount": 8,
"themePack": "theme01",
"slides": [
{"layout": "theme01_page001", "props": {"kicker": "Encuesta de financiación · VOL.01", "titleTop": "IA en", "titleBottom": "Encuesta de financiación EE.UU.", "lead": "Desglosando el ciclo de financiación de IA actual desde el volumen de capital, la estructura del sector y las empresas típicas."}},
{"layout": "theme01_page006", "props": {"kicker": "Cifras clave", "value": "970", "unit": "mil millones de USD", "sub": "La inversión de capital de riesgo en IA en EE.UU. en 2024 alcanzó un récord histórico."}},
{"layout": "theme01_page010", "props": {"kicker": "# Método de investigación", "title": "Método de análisis transversal", "cn": "Identificar cambios en la financiación cruzando la dimensión temporal y la dimensión del sector."}},
{"layout": "theme01_page030", "props": {"kicker": "# Casos típicos", "title": "Hitos · Ritmo de financiación de empresas líderes"}},
{"layout": "theme01_page084", "props": {"kicker": "# Apéndice", "title": "Fuentes de datos y notas de investigación"}}
]
}
Si slides está vacío, pageCount solo es adecuado para una vista previa de borrador temporal. Antes de la entrega al usuario, debe cambiarse a un layout específico y sus props correspondientes.
Roles de página
role solo se usa para la selección de páginas en borradores; el JSON final debe concretarse en un layout específico. Las descripciones de los roles se encuentran en references/layout-roles.md; los candidatos reales se basan en la salida de layout:query.
cover solo se puede seleccionar de las primeras 5 páginas del tema actual. Los candidatos image / media se basan en mediaSlots reales, no en palabras clave del título de la página. Las páginas de fondo dinámico pueden usar ambient como página de ambiente o de sección.
Puede especificar páginas directamente:
{"layout": "theme01_page030", "props": {"title": "Casos típicos"}}
Capacidades de entrega
La página de vista previa después de la generación admite pasar páginas, abrir la barra lateral para editar texto, ajustar props de página, reemplazar ranuras de medios de imagen/video expuestas por los componentes, cambiar la animación de transición de páginas y exportar HTML/PDF/PPTX. Las páginas entregadas al usuario no muestran indicadores de número de página, guías de paso, puntos de navegación o sugerencias de índice en la parte inferior.
Contrato de propiedades de página
En la generación normal, no lea layout-manifest.json. Primero use el resumen de candidatos de la salida de layout:query. Solo cuando se necesite un contrato más detallado, use npm --prefix <skill-root>/project run inspect:layout -- --compact <layout...> para ver el contrato de la página:
copyKeys: campos de texto/datos que se pueden modificar de forma segura.copyBudgets: presupuesto de longitud de texto; los camposdisplay/metricque superen la longitud serán interceptados por la especificación de goal.propShapes: forma interna decopyKeys/ campos de array; al escribir campos de objeto comocopy,cells,items,rows, solo use las claves listadas aquí.mediaSlots: campos de escritura de imagen/video, clave de conteo, cantidad predeterminada y cantidad máxima.countBindings: vinculación de parámetros de cantidad con campos de array.- En
fillPlan, los campos numéricos mirannumericBoundspara completar números:enforced:falsees una sugerencia, los datos reales pueden exceder;enforced:truedebe cumplirse;semantics:'normalized'complete una proporción de 0-1; para arrays anidados de longitud fija, mirefixedLength/fixedLengthsy complete por índice, no por prueba y error. controlKeys: campos operables en el panel derecho, no una lista de relleno de contenido normal; solo se usan cuando el usuario solicita explícitamente ajustar propiedades de la página. Por defecto, solo completecopyKeys, arrays visibles y ranuras de medios reales.
Validación
- Antes de renderizar, se debe ejecutar
validate:goal-spec. - Después de la salida, se debe ejecutar
validate:swiss. - Después de la salida, se debe ejecutar
validate:goal-copy. - Después de modificar la demostración de showcase, ejecute
npm run showcase:update.