Habilidad de Aprendizaje con Conocimiento Gráfico
Dado un tema, entrega un artículo de conocimiento en chino que explique los principios, con diagramas explicativos ya generados e incrustados, junto con fuentes rastreables y prompts, y lo guarda en el Obsidian del usuario.
Requisitos Previos
El anfitrión debe poder cargar la skill o ejecutar este conjunto de instrucciones, tener conectividad a Internet, capacidad de lectura/escritura de archivos y un modelo de generación de imágenes invocable. Se recomienda un entorno Codex / ChatGPT con estas capacidades; otros Agentes pueden usar herramientas de generación de imágenes ya configuradas. La escritura directa en Obsidian local también requiere acceso a archivos locales; si solo hay capacidad de exportación, entrega el artículo y las imágenes y explica la brecha de archivado. Primero verifica las herramientas reales, no asumas capacidades completas solo por el nombre del producto.
Elegir el Formato de Salida
- Artículo de conocimiento: Sigue los pasos 1–6 a continuación para verificar fuentes, crear explicaciones gráficas y archivar en Obsidian.
- README gráfico de proyecto: Primero lee el Flujo de trabajo README, organiza el contenido gráfico en torno a "qué hace, cómo se ve el resultado, cómo instalar, cómo usarlo por primera vez" y guárdalo en el proyecto. Este formato no requiere configuración de Obsidian ni aplica la extensión, cantidad de imágenes, YAML y resumen gráfico del artículo largo. Los principios de verificación, redacción e ilustración se siguen aplicando.
Alcance y Resultados por Defecto
- Un artículo completo suele tener entre 3000 y 6000 caracteres chinos y 3–5 imágenes explicativas; la cantidad incluye una imagen de resumen final, ajustable según el tema.
- Al inicio, usa una introducción conceptual con fondo claro para explicar "qué es, cómo funciona, qué problema resuelve", manteniendo la definición completa; luego presenta los antecedentes, la motivación y el origen necesarios.
- Las imágenes usan por defecto el Estilo del taller de IA de Jiale. El texto principal y las leyendas de las imágenes aclaran las condiciones que afectan la comprensión; las imágenes explican directamente el conocimiento.
- Las tareas de revisión solo modifican las partes especificadas por el usuario. Al ajustar solo la tarjeta inicial, conserva el texto principal, las imágenes, las leyendas y el estilo de las imágenes; solo cambia las imágenes si el usuario lo solicita explícitamente.
- Realiza la verificación, redacción, generación y archivado dentro del alcance autorizado. Cuando falten configuraciones que afecten el resultado, pregunta de forma concentrada, sin convertir elecciones de formato simples en aprobaciones.
1. Determinar la Bóveda de Notas y Dependencias
Lee el archivo config.local.json en el directorio raíz de la skill (si existe). La solicitud actual tiene prioridad sobre la configuración; si la configuración carece de algo, usa el entorno del usuario o las pautas de la base de conocimiento. Consulta Reglas de archivado. Si falta la bóveda de destino y no se puede determinar desde el contexto, solo pregunta por la ruta de la bóveda de destino y primero realiza el trabajo independiente de investigación y borrador.
Después de entrar en la bóveda de destino, lee los archivos AGENTS.md, la guía de uso y la página de inicio que existan; consulta notas similares para determinar el directorio, metadatos y enlaces. Al depender de contenido wikilink, abre el archivo real.
Para esta etapa, usa las siguientes capacidades, localizando desde el directorio de la skill del entorno actual, sin fijar rutas de instalación:
| Capacidad | Priorizar reutilización | Si no está instalada |
|---|---|---|
| Búsqueda y lectura en plataformas | agent-reach; primero lee sus instrucciones, usa los canales realmente disponibles | Usa la recuperación de solo lectura disponible en el anfitrión e indica el canal usado esta vez |
| Verificación web y de artículos genérica | Herramientas de red del anfitrión; se puede complementar con research-workflow | Lee directamente las fuentes primarias |
| Planificación de redacción e ilustración | Reglas de este paquete; se puede complementar con content-research-writer, baoyu-article-illustrator | Sigue el flujo de este paquete |
| Generación o edición de imágenes rasterizadas | Herramientas de generación de imágenes invocables del anfitrión; si hay Image / imagegen nativo, úsalo primero | Conserva los borradores y planes de ilustración completados, indica claramente la brecha de imágenes |
| Archivado local | Python 3.10+, script de archivado de este paquete | Indica claramente el entorno faltante, conserva archivos de trabajo transferibles |
Estas skills externas no se distribuyen con este paquete. Los pasos ya autorizados continúan ejecutándose; respeta las capacidades y limitaciones reales de las herramientas del anfitrión.
2. Verificar y Crear un Borrador de Fuentes
Guarda sources.md en el directorio de trabajo actual: registra los materiales realmente abiertos, URLs, versiones o fechas, conclusiones respaldadas y problemas no resueltos. Primero consulta documentación oficial, artículos, código fuente y publicaciones originales; las publicaciones en plataformas se usan para descubrir pistas, experiencias prácticas o controversias. Los materiales de plataformas adecuados se obtienen preferiblemente a través de Agent Reach.
Los números importantes, épocas, arquitecturas y conclusiones de rendimiento en el artículo deben corresponder al texto original realmente leído. Los resúmenes de búsqueda solo sirven como pistas; distingue entre hechos, inferencias, ejemplos didácticos y resultados de pruebas. Al abordar orígenes y evoluciones, verifica las fuentes originales. Lee las notas existentes según sea necesario, reutiliza conceptos y verifica los destinos de los enlaces.
Condición de finalización: Los mecanismos centrales y los antecedentes tienen fundamento, las discrepancias clave están explicadas, y las fuentes son suficientes para respaldar los ejemplos concretos del artículo.
3. Redactar la Línea Principal de Aprendizaje
Lee las Reglas de redacción y crea un borrador en Markdown con YAML frontmatter. Comienza con una definición completa, organiza el contenido como "Antecedentes y motivación → Proceso general → Mecanismos clave → Ejemplo concreto → Compensaciones de ingeniería → Cierre del aprendizaje", ajustando el orden según el tema.
Coloca marcadores únicos en lugares con valor de ilustración, por ejemplo <!-- figure:01 -->. El texto principal explica las razones y el razonamiento intermedio; las imágenes muestran estructuras, procesos o diferencias; las fuentes se enlazan cerca de las conclusiones relevantes. La imagen de resumen final se sitúa después de la explicación principal y antes de la lista de materiales de referencia.
Condición de finalización: El lector puede explicar el proceso causal, repetir un ejemplo y juzgar las condiciones de aplicación; la definición inicial, los antecedentes y el resumen final están conectados, y las conclusiones clave coinciden con el borrador de fuentes.
4. Planificar y Generar las Ilustraciones
Lee las Pautas visuales, guarda illustration-plan.md, listando para cada imagen: la pregunta, el párrafo correspondiente, nodos, conexiones, valores y leyendas. Si se reutilizan las ilustraciones de Baoyu, copia esas pautas visuales al directorio actual como .baoyu-skills/baoyu-article-illustrator/EXTEND.md.
Guarda el prompt final completo de cada imagen en archivos como prompts/01-flow.md. Organiza la descripción positiva en torno a "propósito de la explicación, objetos y relaciones específicos, formato, estilo visual, etiquetas palabra por palabra, tamaño del lienzo". Usa las herramientas de generación de imágenes invocables del anfitrión; si hay Image / imagegen nativo, úsalo primero; los parámetros y la invocación siguen las reglas de la herramienta actual, generalmente dos imágenes por lote.
Localiza los archivos reales a partir de los resultados de la herramienta, cópialos al directorio de trabajo actual. Revisa cada imagen para verificar terminología, caracteres chinos, números, flechas, escalas de comparación y legibilidad. Si encuentras errores claros, guarda el prompt de revisión y corrige selectivamente; conserva las versiones utilizables, y si aún hay brechas, regístralas fielmente. No declares resultados completos de imágenes si faltan ilustraciones o no se han verificado.
5. Guardar en Obsidian
Lee las Reglas de archivado y guarda images.json. Primero ejecuta el script de archivado con --dry-run sobre el borrador real, las imágenes, los prompts y el registro de fuentes; después de confirmar los resultados, archívalos. Resuelve la ruta del directorio de la skill a una ruta real, luego invoca scripts/archive_note.py, pasando explícitamente la bóveda de destino, el directorio de notas y el directorio de archivos adjuntos.
El script de archivado solo agrega notas; si hay un nombre duplicado, crea un sufijo de versión. Al modificar un artículo existente, primero haz una copia de seguridad y modifica in situ según la autorización actual; no crees una segunda copia duplicada ni regeneres imágenes no modificadas.
Si se necesita definir un estilo de tarjeta, usa assets/jiale-knowledge.css; la primera instalación del estilo solo agrega ese fragmento, conservando la configuración y personalización existentes del usuario. Si la base de conocimiento tiene un índice adecuado, agrega un enlace, evitando duplicados.
6. Verificación Final
Verifica que el artículo final, las imágenes y los archivos existan realmente, que todos los marcadores figure estén reemplazados, y que las inserciones y wikilinks se puedan resolver. La verificación de archivos, la revisión de texto en imágenes y la vista previa de la interfaz informan por separado el alcance real de la verificación.
Al entregar, explica brevemente el contenido completado, la ubicación de guardado y las brechas reales, adjuntando la nota que se puede abrir o el archivo exportado. Un artículo de conocimiento solo se marca como entrega completa si se han completado las fuentes, el texto principal, las imágenes reales y el archivado; el README del proyecto se verifica según las condiciones de finalización de su flujo de trabajo correspondiente.