Communitygithub.com

HXZ09845/ecommerce-sku-skill-builder

Sistema de habilidades para agentes que convierte briefs de productos de comercio electrónico, puntos de venta y activos de referencia en paquetes validados de habilidades SKU para generación de video con IA.

¿Qué es ecommerce-sku-skill-builder?

El constructor de habilidades SKU es un meta-sistema avanzado para agentes de IA, diseñado para crear paquetes de habilidades (Skills) autónomos y publicables para la generación de videos de productos SKU en comercio electrónico. A diferencia de simples generadores de prompts, este sistema guía al agente desde la comprensión del producto, pasando por la demostración visual de los puntos de venta, el mapeo de materiales, hasta la validación y la corrección de casos fallidos. Está optimizado para plataformas como Codex, generando paquetes estándar con estructura de carpetas (`SKILL.md`, `references/`, `scripts/`, `assets/`). El sistema impone una regla de independencia crítica: cada habilidad SKU generada debe ser completamente autónoma y no depender de este meta-sistema, habilidades de categoría, habilidades de casos de oro, o rutas de archivo externas en tiempo de ejecución. Opera en cuatro modos (creación, actualización, parcheado y lote) y aplica extensos puntos de control de calidad (gates) en múltiples áreas, incluyendo la selección de materiales (con preferencia por referencias de bajo ruido), la sincronización audiovisual, y la derivación narrativa de escenas no predeterminadas.

Compatible con✓Claude Code✓Codex CLI✓Cursor
npx skills add HXZ09845/ecommerce-sku-skill-builder

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Constructor de Habilidades SKU

Utilice esta habilidad como el creador general de la industria para nuevas habilidades de generación de video para productos/SKU de comercio electrónico. No solo escribe prompts. Guía al creador desde la comprensión del producto hasta la prueba de los puntos de venta, el mapeo de materiales, la redacción del paquete estándar, la validación y la regresión de casos fallidos.

Enfoque actual: construir habilidades SKU de productos concretos de manera sólida. El mismo flujo de trabajo puede generar posteriormente habilidades de categoría abstractas cuando existan suficientes habilidades SKU concretas calificadas, pero esas habilidades de categoría abstractas aún están destinadas a ayudar a crear futuras habilidades SKU de productos concretos. No trate la abstracción de categoría como la tarea principal a menos que el creador lo solicite explícitamente.

El resultado predeterminado es un paquete de habilidades Codex publicable:

nombre-habilidad/
  SKILL.md
  agents/openai.yaml
  references/
    product-rules.md
    core-asset-layer.md
    audio-visual-sync.md
    asset-manifest.md
    prompt-plan-format.md
    gotchas.md
    trigger-tests.md
    quickstart.md
  scripts/
    validate_*.py
  assets/

No haga un paquete antiguo de tres archivos como el entregable principal. Si se convierten materiales antiguos de la era Cursor, consérvelos como entradas fuente y cree el paquete Codex estándar como salida normalizada.

Este creador también tiene referencias puramente meta como references/golden-case-abstractions.md; utilícelas mientras construye la habilidad SKU objetivo. Son abstracciones autocontenidas, no dependencias de otras habilidades.

Las habilidades SKU de producto generadas deben ser paquetes de entrega autocontenidos. El paquete SKU objetivo no debe requerir este creador, una habilidad meta de categoría, una habilidad de caso de oro, carpetas fuente locales o cualquier habilidad externa para funcionar. Cada regla necesaria en tiempo de ejecución debe estar escrita en el propio SKILL.md, references/, scripts/ o assets/ del paquete objetivo.

Regla de Independencia Meta a SKU

Esta meta habilidad es solo un creador en tiempo de compilación. Debe ser utilizable desde los propios archivos de este paquete.

Cualquier habilidad SKU concreta generada o actualizada por esta meta habilidad debe ser ejecutable de forma independiente después de la entrega. La habilidad SKU generada no debe requerir que los usuarios lean esta meta habilidad, habilidades meta de categoría, habilidades de caso de oro, paquetes SKU antiguos, documentos de colaboración externos, memoria o rutas absolutas locales en tiempo de ejecución.

Los materiales externos como briefs de productos, tablas de puntos de venta, activos de toma real, paquetes SKU antiguos, documentos de colaboración externos, habilidades meta de categoría, videos de casos, capturas de pantalla o memoria pueden usarse solo como entradas de la ejecución actual durante la creación. Cualquier regla útil aprendida de ellos debe ser copiada, reescrita o resumida en el propio SKILL.md, references/, scripts/, assets/ o asset-manifest.md de la habilidad SKU generada.

Los activos de toma real confirmados que sean necesarios para el uso en tiempo de ejecución deben normalizarse en el directorio assets/ de la habilidad SKU generada y registrarse en references/asset-manifest.md con su función semántica, estado del producto, estado de aprobación y límites de referencia. Mantenga solo las versiones de material no aprobadas, de gran tamaño o no resueltas como pendiente; no deje materiales de ejecución requeridos en carpetas externas.

Modos de Trabajo

  1. Creación de Nueva Habilidad SKU: utilice el flujo de trabajo completo desde la comprensión del producto hasta la matriz de estado, arquetipo, prueba de punto de venta, estrategia de materiales, borrador del paquete, validación representativa y enrutamiento de casos fallidos.
  2. Actualización de Habilidad SKU Existente: comience desde el problema reportado, la fuente modificada o el caso fallido. Identifique los archivos afectados, parchee la superficie de reglas/materiales/validador más pequeña necesaria, luego ejecute una auditoría autocontenida y una validación representativa.
  3. Parche de Caso Fallido: enrute el fallo a las reglas del producto, el manifiesto de activos, las advertencias (gotchas), el validador o las pruebas de activación. No reescriba toda la habilidad a menos que el problema revele una brecha estructural.
  4. Lote de Producción: permitido solo después de que la habilidad SKU haya pasado la validación representativa, o cuando el creador solicite explícitamente procesar por lotes con riesgos pendientes conocidos.

Contrato Operativo

  1. Después de cargar esta habilidad, guíe al creador con una recepción fija y segura para principiantes. No diga "proporcione cualquier cosa" ni salte directamente a la escritura final de la habilidad. Use espacios de entrada con nombre, explique el siguiente resultado y permita que los elementos faltantes se marquen como pendiente.
  2. Comience con la confirmación de la fuente. Primero lea las reglas internas de este paquete. Luego lea las entradas de la ejecución actual proporcionadas o aprobadas por el creador, como meta de categoría, referencias SKU antiguas, documentos de colaboración externos, videos de casos, capturas de pantalla o carpetas de materiales.
  3. Si la meta de categoría o las referencias SKU antiguas faltan o son débiles, continúe con las reglas de la industria de este paquete más las abstracciones de casos de oro incorporadas; no se bloquee por la ausencia de fuentes externas.
  4. Primero comprenda el producto. No solicite la biblioteca completa de materiales aprobados ni escriba reglas finales en la primera ronda a menos que el creador proporcione explícitamente todo.
  5. Confirme la estructura del producto y la matriz de estado antes de la escritura detallada de reglas.
  6. Clasifique el producto en un arquetipo de producción antes de escribir prompts: A+B grande fijo, A+B pequeño móvil o A puro no deformable/vestible.
  7. Trate el juicio A/B como la puerta de decisión más importante. El estándar explícito del creador y el juicio de la ejecución actual anulan las heurísticas predeterminadas; cuando haya incertidumbre, presente el razonamiento y espere la confirmación.
  8. Aplique las abstracciones de casos de oro incorporadas para el arquetipo elegido. Extraiga puntos de alucinación, manejo A/B, salvaguardas de prompts, reglas de materiales y ganchos de validador de esas abstracciones.
  9. Extraiga la capa de activos central de casos de alta calidad y entradas actuales: identidad/logotipo, entorno, ritmo, acción, forma de prompt, contrato de envío y riesgo TS.
  10. Mapee los puntos de venta a prueba visual uno por uno. Para cada punto de venta, proponga opciones de referencia de toma real candidatas y realice una prueba de diálogo con la experiencia histórica de selección de materiales del creador antes de marcarlo como OK. No pase al siguiente punto de venta hasta que la ruta de prueba, el tipo de referencia, el estado del producto, el juicio A/B, los materiales prohibidos y la ruta de degradación del punto de venta actual estén confirmados. 10.5. Durante la selección de materiales del punto de venta, audite el riesgo del estado del producto y los límites de herencia de referencias. Prefiera referencias de producto de bajo ruido, como imágenes P0/P1 con fondo blanco. Una Unidad puede usar múltiples referencias, pero por defecto deben servir a un solo estado del producto. Para zapatos, bolsos, prendas de vestir y otros productos vinculados al cuerpo, no herede modelo/persona, estilismo, atuendo, fondo o accesorios de las referencias del producto a menos que el creador lo apruebe explícitamente.
  11. Construya la disposición de sincronización audiovisual antes de escribir prompts: copia del guión -> entidades visuales concretas -> entorno real -> prueba de punto de venta -> Unidad -> funciones de material -> acción de prompt -> riesgo TS. No escriba prompts solo a partir de la copia o solo a partir de los materiales. 11.5. Derivación narrativa de escena (§11.5 en product-rules.md). Si la escena del guión NO es la escena predeterminada/principal del producto, complete la derivación de cuatro pasos antes de escribir cualquier prompt de clase A: Paso 1 micro-acciones de la escena → Paso 2 accesorios específicos de la escena → Paso 3 arcos emocionales → Paso 4 autoevaluación de calidad narrativa (Q1-Q6). Genere una "Tabla de Adaptación Narrativa de Escena" al inicio del plan de prompts. Los guiones de escena predeterminada pueden omitir los Pasos 1-3, pero aún deben pasar Q1-Q6.
  12. Cada prompt de Unidad que utilice @图片 o @视频 debe incluir un bloque conciso 【素材说明】 / Reference Materials. La tabla de auditoría puede usar controls / does_not_control, pero el prompt final debe usar una redacción corta y amigable para el modelo, como 只参考..., 不参考... y ...以 @图片X 为准.
  13. Clasifique cada unidad como A, A-out, A-in o B según el comportamiento del estado del producto, luego confirme las filas clave con el creador. No seleccione activos "suficientes" en silencio.
  14. Mantenga los activos de ejecución como pendientes hasta que se seleccione la versión de material aprobada. En modo de prueba, uno o dos guiones crean el primer borrador de la habilidad y el bucle de retroalimentación visual; en modo de producción, los guiones por lotes impulsan planes de prompts por lotes, disposiciones de materiales, validación y entradas de tareas de video.
  15. Genere un paquete de habilidad estándar solo después de que la comprensión del producto, el arquetipo de producción, la abstracción de caso de oro, el inventario de activos central, la prueba de punto de venta, la sincronización audiovisual y la estrategia de materiales estén alineados.
  16. Ejecute una auditoría de entrega autocontenida: sin dependencia de habilidad externa, sin dependencia de ruta absoluta local, sin instrucción de "leer la habilidad padre/meta/dorada", y todas las referencias de ejecución se resuelven dentro del paquete objetivo o están explícitamente pendiente.
  17. Valide con un plan de prompts representativo y un validador de producto; retroalimente los casos fallidos a las reglas, advertencias, manifiesto o validador.

Flujo de Trabajo Requerido

  1. Lea references/creator-onboarding.md antes de la primera respuesta al creador. Úselo para solicitar entradas de primera ronda con nombre y explicar el proceso por etapas en un lenguaje seguro para principiantes.
  2. Lea references/sku-creator-workflow.md.
  3. Lea references/product-rules.md para reglas estrictas de la industria, lógica A/B, funciones de material, consistencia de estado, requisitos del plan de prompts y reglas de abstracción de casos.
  4. Lea references/golden-case-abstractions.md después de elegir el arquetipo de producción. Use sus abstracciones integradas de barra de té, taza/contenedor, zapatos/ropa y accesorios tipo bolso para puntos de alucinación y manejo A/B. No cargue habilidades externas a menos que el creador proporcione explícitamente una fuente de la ejecución actual para abstraer.
  5. Lea references/core-asset-layer.md antes del mapeo de puntos de venta o la escritura de prompts. Úselo primero para elegir el arquetipo de producción, luego extraiga las reglas de logotipo/texto, entorno, ritmo, división de Unidades, forma de prompt, envío y riesgo TS de casos de alta calidad y entradas actuales.
  6. Lea references/audio-visual-sync.md antes de escribir prompts. Úselo para vincular la copia del guión, las entidades visuales concretas, el entorno real, la prueba de punto de venta, la división de Unidades, las funciones de material A/B o A+B, la acción de prompt, la duración y la degradación del riesgo TS.
  7. Use references/category-questionnaire.md para preguntas escalonadas al creador y tarjetas de confirmación.
  8. Use references/method-decision-tree.md para elegir el método de generación. Por defecto, use generación directa; solo use el flujo de cuadrícula/TVC cuando el usuario solicite explícitamente TVC/publicidad.
  9. Use references/skill-template.md al redactar el paquete de habilidad SKU objetivo.
  10. Use references/asset-manifest.md al definir las funciones semánticas de los activos y los activos de ejecución aprobados/pendientes.
  11. Use references/prompt-plan-format.md al validar el plan de guiones representativo.
  12. Use references/gotchas.md antes de la entrega y al incorporar casos fallidos.
  13. Use references/validate-template.py y casos específicos del producto para crear scripts/validate_*.py.
  14. Use scripts/scaffold_category_skill.py solo como un andamio inicial, luego refínelo con las reglas reales del producto.

Respaldo de Meta de Categoría

Prefiera meta de categoría madura o referencias SKU antiguas cuando existan, pero trátelas como asistentes, no como bloqueadores. Si faltan o son débiles, use las reglas de la industria más las abstracciones de casos de oro incorporadas. Al heredar cualquier regla antigua, genere 可继承 / 需改写 / 禁止继承 antes de aplicarla.

Puertas de Calidad

  • Puerta de recepción: espacios de entrada de primera ronda con nombre, confirmación de fuente, comprensión del producto, matriz de componentes/estado y arquetipo de producción se producen antes de las reglas detalladas.
  • Puerta de prueba: cada punto de venta tiene una ruta de prueba visual confirmada por el creador, tipo de material, estado del producto, juicio A/B, material/estado prohibido, ruta de degradación y registro de prueba de diálogo uno por uno.
  • Puerta de activos: el inventario de activos central, el riesgo TS, las funciones P0/P1/P2, el riesgo del estado del producto, la preferencia de referencia de bajo ruido, el contenido de referencia útil/ignorado y el estado de aprobación de los activos de ejecución se registran antes de escribir prompts.
  • Puerta de sincronización: cada pulso significativo del guión se mapea a entidades visuales concretas, entorno real, Unidad, objetivo de prueba, función de material, acción de prompt, duración/ritmo y riesgo TS.
  • Puerta de prompt: cada Unidad con @图片 o @视频 incluye un bloque conciso de propósito de material utilizando la redacción 只参考 / 不参考 / 以...为准 amigable para el modelo.
  • Puerta de escena U31: las escenas no predeterminadas completan las micro-acciones de escena, los accesorios de escena, el arco emocional y la autoevaluación narrativa Q1-Q6 antes de los prompts de clase A.
  • Puerta de Unidad U32-U35: las Unidades se dividen por prueba, estado del producto, tipo A/B, escena y riesgo de alucinación en lugar de cortes de reloj fijos; los prompts estándar de clase A declaran el objetivo de la unidad, el flujo de acción y la condición final sin prosa segmentada segundo a segundo.
  • Puerta de entrega: la habilidad SKU generada tiene la forma Codex estándar, es autocontenida, ligera en SKILL.md, detallada en references/, y libre de dependencias de ejecución de este creador, meta de categoría, casos de oro, documentos externos, memoria, rutas locales o carpetas de materiales externos.
  • Puerta de validación: pruebas de activación, plan de prompts representativo, validador de producto, tabla de materiales, clasificación A/B, mapeo de sincronización audiovisual, conteos de API/materiales, registro de validación y enrutamiento de casos fallidos están presentes.

Skills relacionados