Habilidad de Maquetación de Artículos para WeChat
Convierte un artículo en Markdown a HTML que se puede copiar y pegar directamente en el editor de artículos de WeChat, conservando el estilo después del pegado.
El activo principal es la biblioteca de componentes temáticos en references/ (cada tema incluye: variables de diseño + HTML completo de cada componente + plantilla base + reglas de mapeo) más 1 biblioteca de incrementos comunes (bloques de código / imágenes·GIF / títulos con etiquetas pequeñas, compartida por todos los temas). La lista de temas se basa únicamente en references/theme-index.md. Este SKILL.md solo gestiona el flujo y las decisiones; el código HTML específico se obtiene siempre de la biblioteca de componentes, no se escribe de memoria.
Flujo de Trabajo
0. Entrada y Normalización de Formato
El usuario puede proporcionar: texto Markdown o ruta de archivo .md (va directamente al paso 1), .docx, .pdf, .txt/texto plano sin marcado, o HTML enriquecido. Si la entrada no es Markdown, primero se debe leer references/format-normalize.md y seguir sus reglas para convertirla en un borrador Markdown y confirmar la estructura (docx usar scripts/extract_docx.py, PDF usar Read por páginas + limpiar ruido, texto plano inferir estructura heurísticamente según títulos). Si no se proporciona nada, se solicita al usuario.
Si el usuario dice «maquetar directamente / automático / un clic / no preguntes», se pasa al modo completamente automático: se salta la confirmación de estructura y la pregunta de selección de tema, se infiere la estructura automáticamente, se selecciona el tema según el contenido, se maqueta y verifica, y al entregar se incluye una nota explicativa de las decisiones (estructura de capítulos, títulos propuestos, razón de la elección del tema).
1. Selección de Tema (Sistema de Recomendación Automática)
Leer references/theme-index.md (fuente única de información de temas). Recomendar activamente el tema más adecuado según el contenido del artículo, y luego pedir al usuario que confirme — recomendar pero no imponer:
- Si el usuario ya especificó un tema en la solicitud → usarlo directamente, sin preguntar.
- Si el contenido tiene una afinidad clara → preguntar con una única confirmación: «Sugiero usar XX (razón), ¿confirmas o prefieres cambiar?». Las opciones incluyen la recomendación + 1~2 alternativas + "Ver todos". Correspondencia tema-contenido (consulte la columna "Escenarios aplicables" de theme-index):
- Tutorial / reseña / lista / inventario de herramientas / organización de conocimiento / desglose de metodologías (alta densidad de información) → Verde Yu
- Análisis profundo / opinión / temas contundentes → Rojo y Blanco
- Diseño / crítica tecnológica / opinión profesional / marca de alta gama → Minimalista Grafito
- Zen / vida minimalista / ensayo profundo → Zen Blanco
- Comparación de herramientas / reseña creativa (metáfora visual de ticket) → Ticket Yu
- Notas de revista interna / reseña profunda / retrospectiva de caso → Oliva Notas
- Sin inclinación clara → por defecto, se coloca el primer tema de theme-index (Verde Yu) como recomendación y se usa AskUserQuestion para que elija entre varios temas (si hay más de 4, primero agrupar por estilo y preguntar el grupo, luego preguntar el tema dentro del grupo).
- Modo completamente automático (el usuario dice explícitamente «maquetar directamente / un clic / no preguntes») → no preguntar, seleccionar automáticamente el tema más afín al contenido o el primer tema por defecto, y al entregar explicar el motivo de la elección.
- Si el usuario no está satisfecho con los temas existentes / quiere un nuevo estilo → ir al flujo de «Generación de tema personalizado» (ver sección siguiente), generar y registrar, luego volver a este paso para su uso.
- Si theme-index está vacío → detener la maquetación e informar al usuario que primero debe agregar un estilo de tema (puede usar «Generación de tema personalizado»).
Una vez que el usuario decide el tema, se procede a la coincidencia de componentes dentro de ese tema (pasos 3 y 4: determinar el tipo de artículo → seleccionar la combinación de componentes según la receta de ese tema).
2. Leer la Biblioteca de Componentes (Dos Partes)
(1) Según la columna "Archivo de biblioteca de componentes" de ese tema en theme-index, leer la biblioteca de componentes específica del tema references/theme-{identificador}.md (incluye tarjeta de introducción, títulos de sección, marcado de texto, firma y otros componentes específicos del tema).
(2) Al mismo tiempo, leer la biblioteca de incrementos comunes references/common-components.md — bloques de código, imágenes/GIF, títulos con etiquetas pequeñas, compartidos por todos los temas; solo se debe aplicar el color principal del tema actual.
La generación posterior se basa completamente en estas dos bibliotecas de componentes; el HTML se obtiene de ellas, no se escribe a mano.
3. Analizar la Estructura Markdown
| Elemento | Regla de Identificación |
|---|---|
| Título del artículo | # Título o frontmatter title |
| Cita inicial | Bloque > cita al inicio del artículo |
| Título de sección | ## Título |
| Subsección | ### Título |
| Negrita / Resaltado / Subrayado | **texto** / ==texto== / <u>texto</u> o ++texto++ |
| Párrafo citado | > texto que no esté al inicio |
| Imagen / GIF | ,  (GIF se trata igual que imagen) |
| Código / Comando / Prompt | ``` bloque de código ```, en línea `code` |
| Línea divisoria / Lista | ---, *** / - elemento o 1. elemento |
| Tabla | Tabla Markdown separada por ` |
Después de analizar la estructura, determinar el tipo de artículo (tomar el tipo dominante, puede ser compuesto): tutorial/guía práctica, lista/inventario de herramientas, opinión/análisis profundo, entrevista/perfil de persona, revisión de datos/informe, ensayo de vida/emociones, caso práctico. Base de determinación: muchos pasos y comandos → tutorial; muchos elementos en paralelo → lista; muchas citas y narrativa de personas → entrevista; muchos números y comparaciones → datos; mucha argumentación y deducción → opinión.
4. Seleccionar Combinación de Componentes según la Receta → Ensamblar HTML
Primero consultar la tabla «Tipo de artículo → Combinación de componentes según receta» de la biblioteca del tema seleccionado, y determinar la combinación de componentes principales y componentes decorativos de este artículo según el tipo de artículo — no elegir componentes al azar párrafo por párrafo al obtener la biblioteca; la receta garantiza un estilo de maquetación estable para artículos del mismo tipo. Los elementos fuera de la receta se complementan según la tabla de reglas de mapeo de la biblioteca del tema.
Luego, ensamblar según la sección «Plantilla de esqueleto de artículo completo» de la biblioteca del tema, reemplazando cada elemento Markdown con el componente correspondiente:
- El orden del esqueleto se basa en la biblioteca del tema; diferentes temas pueden tener esqueletos diferentes, no usar el esqueleto de otro tema.
- Las marcas en línea se buscan por semántica en la biblioteca de componentes seleccionada (los números de componentes no son uniformes entre bibliotecas, siempre basarse en la semántica, no usar números fijos):
**negrita**→ negrita con color principal;==resaltado==→ resaltado con fondo degradado;<u>texto</u>o++texto++→ subrayado;~~texto~~→ resaltador (medio resaltado en la parte inferior);>cita→ bloque de cita resaltado. - Componentes de la biblioteca de incrementos comunes:
``` bloque de código ```→ 1a bloque de código oscuro / 1b claro, en línea`code`→ 1c;→ 2a imagen (agregar componente de descripción solo si hay descripción),.gif→ 2b GIF; subtítulo/énfasis que necesite destacar → 3a subtítulo con barra vertical izquierda o 3b etiqueta píldora, frase clave → 3d, nota marginal → 3e. Prioridad: primero consultar la tabla de reglas de mapeo de la biblioteca del tema — si el tema tiene un componente semántico equivalente (como su propia frase clave/bloque de nota), usar la versión de la biblioteca del tema para mantener la coherencia de estilo; si la biblioteca del tema no tiene un componente correspondiente, entonces usar 3x de la biblioteca común y aplicar la regla de cambio de color para que coincida con el color del tema. - Un artículo usa solo los componentes de un tema seleccionado, no mezclar componentes entre temas.
- Énfasis y subtítulos usar «etiqueta pequeña / barra vertical izquierda», no usar bordes de puntos: para destacar un subtítulo o un contenido, usar subtítulo con barra vertical izquierda (3a), etiqueta píldora (3b), bloque de frase clave/nota con barra vertical izquierda (3d/3e); no usar un borde de puntos (
dashed) alrededor de un título, es torpe y llama demasiado la atención.
5. Verificar Cumplimiento (Obligatorio)
Después de generar el HTML y guardarlo en el archivo de destino, se debe ejecutar el script de verificación. El proceso solo se completa cuando los ERROR se reducen a cero:
# Usar la ruta absoluta del skill para llamar al script, y la ruta real para el parámetro HTML (normalmente los directorios son diferentes)
<SKILL_ROOT>/scripts/validate_gzh_html.py <ruta_real_del_.html generado>
Verifica de manera determinista los elementos prohibidos por la plataforma y el envoltorio <span leaf>. Si informa ERROR, volver al paso 4 para corregir; las ADVERTENCIAS de puntuación de ancho medio también deben corregirse a cero antes de entregar (este es el punto de mayor frecuencia de retrabajo en el uso real).
6. Salida
Formato del producto: fragmento de cuerpo <section>…</section> puro, comenzando desde el contenedor global, sin envolver <!DOCTYPE>/<html>/<head>/<body> — el editor de WeChat solo acepta fragmentos de cuerpo; las envolturas de documento sobrantes se descartan o interfieren con el pegado.
- Archivo de cuerpo limpio: HTML guardado en el directorio de trabajo actual, nombre de archivo
{nombre_original}_maquetado_{nombre_chino_del_tema}({identificador_inglés}).html(identificador inglés = nombre del archivo de la biblioteca de componentes de theme-index sin el prefijotheme-y el sufijo.md). Este se usa para verificación y como respaldo para pegado manual. - Página de vista previa con botón «Copiar» (para que el usuario copie con un clic, evitando seleccionar todo manualmente):
Genera<SKILL_ROOT>/scripts/wrap_preview.py <archivo_de_cuerpo_limpio_anterior.html>{...}_preview.html— al abrirlo en el navegador, aparece un botón «Copiar a WeChat» en la esquina superior derecha; al hacer clic, el texto enriquecido renderizado se copia al portapapeles (equivalente a Ctrl+A/Ctrl+C), y luego se pega en el editor de WeChat con Ctrl/⌘+V. El botón y el script solo están en la envoltura de vista previa, no dentro de la sección que se copia, por lo que lo pegado en WeChat sigue siendo un cuerpo limpio y compatible. - Informar al usuario: Abrir
{...}_preview.html→ hacer clic en «Copiar» (esquina superior derecha) → pegar en el editor de WeChat; y proporcionar la ruta del archivo de cuerpo limpio como respaldo. Incluir la conclusión del script de verificación (pasado / warnings restantes).
Procesamiento Inteligente durante la Generación (Estas son las características distintivas de esta skill, deben hacerse)
- Numeración automática de capítulos: Asignar
01/02/03…según el orden de aparición de##; si el último capítulo es del tipo conclusión/resumen, usar la variante de numeración de conclusión especificada por la biblioteca del tema (como∞); si la biblioteca del tema no lo especifica, seguir usando números. - Etiqueta en inglés: Generar una etiqueta en inglés a partir del título del capítulo en chino (ej. 实测→TEST, 教程→TUTORIAL, 总结→SUMMARY, 思考→THOUGHTS…); usarla si la biblioteca del tema tiene un espacio correspondiente.
- Subrayado de palabras clave en el texto (característica principal): Para cada párrafo del texto, buscar activamente 1–3 frases más importantes y marcarlas con el CSS de subrayado de ese tema (ver theme-index). Priorizar: ideas clave, conclusiones, datos críticos, nombres propios; frases de 4–15 caracteres; si todo el párrafo no tiene puntos clave, no marcar. Incluso si el texto original no tiene negrita, se debe agregar subrayado activamente — es la marca básica más frecuente.
- Resaltado de palabras clave en la cita inicial: Identificar palabras clave en la frase inicial y marcarlas con el componente de resaltado.
- Extracción de tabla de contenido: Tomar los primeros 3 de todos los
##como puntos de guía/tabla de contenido (cuando la biblioteca del tema tenga un componente de tabla de contenido). - Firma en la tarjeta de cita inicial: Según el autor o tema del artículo — si el artículo tiene firma, escribir "—— Nombre del autor"; si no hay autor claro, usar una frase corta relacionada con el tema o simplemente omitir. No escribir fijo "甲木" (la zona de firma al final también usa
{{nombre_del_autor}}como marcador de posición, ver punto 7). - Zona de firma de autor al final (para que el autor la complete, solo una al final): No escribir ningún nombre fijo por defecto, usar un marcador de posición de firma para que el usuario lo reemplace por el suyo.
- Primera frase (presentación del autor):
Soy {{nombre_del_autor}}, {{breve introducción, ej.: apasionado por compartir observaciones sobre IA}}— si el usuario proporcionó firma o introducción en la solicitud/preferencia, se completa directamente; si no, se mantiene el marcador{{nombre_del_autor}}/{{introducción}}, y se indica al usuario que lo reemplace por su propia firma al entregar. - Segunda frase (llamada a la interacción, general, se puede mantener igual):
Si te ha resultado útil el artículo de hoy, ¡no dudes en **darle "Me gusta", "Watching" y compartir**! ¡Nos vemos en el próximo! - Si el texto original ya tiene un párrafo de firma al final (como "Soy XXX…") → usar la firma original directamente, no reemplazar por marcador.
- Primera frase (presentación del autor):
- Conversión de listas: Procesar según las reglas de mapeo de la biblioteca del tema; si no hay un componente de lista específico, convertir a párrafos de texto con sangría.
- Puntuación de ancho completo en chino: La puntuación del texto debe ser siempre de ancho completo (,。!?:;""''()—— …), no usar de ancho medio
, . ! ? :y comillas rectas inglesas" '. Al generar HTML, escribir directamente comillas curvas ""'', no escribir primero comillas rectas y luego reemplazar — las comillas rectas en el texto original se convierten en el momento de la transcripción. Excepción: bloques de código, código en línea, nombres propios en inglés/URL/identificadores de código se mantienen como están.
Jerarquía Visual (3 niveles progresivos, común a todos los temas)
| Nivel | Función | Frecuencia | Método |
|---|---|---|---|
| Nivel Ancla | Ancla más fuerte: nombre de producto/paso/CTA/frase clave principal | ≤ 5 en todo el artículo | Negrita con color principal, cita de fondo oscuro texto blanco |
| Nivel Marca | Palabras clave del texto, 1–3 por párrafo | Alta frecuencia | Subrayado |
| Nivel Contenedor | Bloque de cita, etiqueta de concepto, énfasis en oraciones largas | Según necesidad | Cita de fondo claro, resaltador, insignia |
Líneas Rojas de la Plataforma (Core, la verificación completa se deja al script de verificación)
- Prohibido:
<style>/<script>/<div>, atributosclass/id,position:fixed/absolute/sticky,float,@media/@keyframes,display:grid, variables CSS, fuentes externas/CSS. - Obligatorio: todo el estilo en línea
style; todos los nodos de texto deben envolverse con<span leaf="">texto</span>(de lo contrario, el estilo se pierde después de pegar). - Permitido:
display:flex(limitado),linear-gradient,border-radius,box-shadow,<section>/<p>/<span>/<strong>/<img>/<h3>.
Gotchas (Errores Comunes en Maquetación Real)
- Omitir envoltorio
<span leaf>es el error fatal más común — el estilo completo se pierde después de pegar en WeChat. Se soluciona con el script de verificación del paso 5, no saltarlo. - Subrayado: aplicar por párrafo, 1–3 frases por párrafo. No subrayar todo un párrafo (pierde el foco), ni marcar algunos párrafos y omitir otros; las descripciones clave en elementos de lista también deben marcarse.
- Numeración de capítulos desordenada: seguir estrictamente el orden de
##, no saltar números; la variante de numeración de conclusión solo se usa para el último capítulo, no para capítulos intermedios. - La zona de firma solo debe haber una al final: usar texto fijo, no aparecer en el medio ni en múltiples lugares; si el texto original ya tiene un párrafo de firma de autor / "dale like, watching, comparte" al final, identificarlo e integrarlo en esta única zona de firma/tarjeta CTA, no mantener el párrafo original y generar otro.
- Inventar descripciones de imágenes: solo si
realmente tiene texto de descripción, generar el componente de descripción;con alt vacío, no inventar descripciones. - Imágenes adaptables, no a ancho completo:
<img>siempre conmax-width:100%;height:auto;display:block;margin:0 auto— mostrar según el tamaño propio de la imagen, centrada; las imágenes grandes se reducen al ancho del contenedor, las pequeñas mantienen su tamaño original. No usarwidth:100%(estiraría las imágenes pequeñas y las haría borrosas); solo elementos de diseño como tablas/tarjetas de portada/diagramas de flujo usanwidth:100%. - Mezclar componentes entre temas: un artículo usa solo los componentes del tema seleccionado + biblioteca común, no tomar prestados componentes de otros temas.
- Abuso del nivel ancla: el énfasis más fuerte ≤ 5 en todo el artículo; poner negrita en todas partes equivale a no tener énfasis.
- Omisión de contenido original: cada párrafo, cada imagen debe convertirse; no omitir; no agregar ni eliminar contenido sustancial del original.
- Residuos de marcadores de posición en imágenes: si la zona de firma/componente CTA tiene marcadores de posición de tarjeta de presentación (como
<img src="...URL de tarjeta o imagen de guía">), si no hay URL real de imagen, eliminar toda la línea, no dejar el marcador en el producto. - La tabla de contenido es seleccionada, no completa: la guía de introducción/componente de tabla de contenido muestra 3 puntos clave seleccionados, no la lista completa de capítulos; si hay más de 3 capítulos, elegir los 3 más importantes, no forzar ni inducir a error al lector pensando que solo hay 3 capítulos.
- No usar bordes de puntos: para destacar títulos/énfasis, usar etiquetas pequeñas o barra vertical izquierda (3a–3e de la biblioteca común); no usar
border:…dashedalrededor de un título. Excepción: componentes de puntos definidos explícitamente en la biblioteca del tema (como el cuadro de cita quote-box de Verde Yu, la tarjeta de punto destacado oneliner-card) son características de estilo de ese tema; usarlos según las reglas de uso de la biblioteca del tema. - No mezclar puntuación de ancho medio: las comas y puntos de ancho medio en el texto, las comillas rectas inglesas
"'deben convertirse a ancho completo; pero los símbolos de ancho medio dentro de bloques de código/código en línea se mantienen como están, no "ancho completo" el código. - El código/Prompt debe usar bloques de código: el código, comandos y prompts en el artículo deben usar el componente de bloque de código de la biblioteca común (1a/1b), no meterlos en párrafos normales o bloques de cita, de lo contrario se pierden la sangría y el monoespaciado.
- Bloques de código compactos, evitar grandes espacios en blanco: usar la escritura "un
<p style="margin:0">por línea" de 1a/1b, nunca usarwhite-space:pre— esto renderizaría la sangría antes de span y los saltos de línea en el código fuente como gran sangría izquierda + líneas en blanco; la sangría solo usar espacios de ancho completo, el interlineado conline-height:1.6. - Material pendiente centrado:
【Insertar…】, captura de pantalla / GIF / video / imagen de resultados pendientes, usar 2c Bloque de material pendiente centrado de la biblioteca común (fondo claro borde punteado suave + icono centrado y descripción), no usar bloque de nota alineado a la izquierda.
Generación de Tema Personalizado (Segundo Flujo de Trabajo)
Cuando el usuario quiera un nuevo estilo más allá de los temas integrados (dice "generar un nuevo tema / estilo personalizado / hacer una biblioteca de componentes basada en esta imagen de referencia", o no está satisfecho con ningún tema existente), leer references/theme-generator.md y ejecutar estrictamente según su flujo:
- Recopilar preferencias: la descripción del tema es obligatoria (o imagen de referencia); nombre/ID/cinco colores/fuente/tres tipos de TAG/radio de borde/sombra pueden estar vacíos y se completan automáticamente; preguntar todo de una vez, no por campos.
- Generar biblioteca de bloques HTML: usar el [Prompt de generación] al final de theme-generator.md tal cual, generar una biblioteca de bloques completa de 45~75 Bloques, guardar en
assets/theme-previews/{theme-id}.html— todos los bloques dispuestos secuencialmente en la misma página; el usuario abre la página completa en el navegador para confirmar el estilo de un vistazo, no bloque por bloque. - Convertir + Registrar: después de la confirmación del usuario, convertir a
references/theme-{identificador}.mdestándar (obligatorio agregar envoltorio<span leaf="">, eliminar id de vista previa, completar los cinco capítulos, reglas detalladas en el paso 3 de theme-generator.md), registrar en theme-index.md, ejecutarcomponent_lint.pyhasta 0 ERROR. - Después de la entrega, ese tema se convierte en un tema permanente seleccionable, con los mismos derechos que los temas integrados para maquetaciones posteriores.
Durante la fase de generación, se siguen las reglas del prompt; durante la fase de conversión a la biblioteca de temas, se sigue este documento («Líneas Rojas de la Plataforma» y «Normas para Añadir Nuevos Temas») (en caso de conflicto, este último prevalece, porque la biblioteca de temas determina directamente el producto de maquetación).
Normas para Añadir Nuevos Temas
Los nuevos temas se nombran como references/theme-{identificador_inglés}.md, y el contenido debe incluir:
- Tabla de variables de diseño (color principal/fondo claro/texto oscuro/color de título/color de texto/color de línea divisoria, etc.)
- HTML completo de cada componente (estilo en línea + envoltorio
<span leaf="">, cumpliendo las "Líneas Rojas de la Plataforma" anteriores) - Plantilla de esqueleto de artículo completo (orden de ensamblaje de componentes; si hay componente de tabla de contenido/navegación, especificar su posición relativa a la portada/introducción)
- Tabla de combinación de componentes por tipo de artículo (combinación de componentes principales + componentes decorativos para cada tipo de artículo; la receta es clave para un estilo de maquetación estable)
- Tabla de reglas de mapeo de Markdown a componentes
Después de añadirlo, registrar una línea en references/theme-index.md (nombre del tema / color principal / escenarios aplicables / archivo de biblioteca de componentes / CSS de subrayado de texto), y ejecutar python3 scripts/component_lint.py . para confirmar que la biblioteca de componentes no tiene antipatrones (0 ERROR).
Para casos de regresión de activación y selección de tema, ver
references/eval-cases.md(se usa para verificación de regresión durante el mantenimiento, no afecta a la generación individual).
