theus-cli-linux-arm64 0.2.84

package/vendor/theus-arsenal/skills/tours-de-codigo/SKILL.md

@@ -0,0 +1,252 @@
+---
+name: tours-de-codigo
+description: Crea archivos `.tour` de CodeTour — recorridos paso a paso dirigidos a un perfil de lector, con anclas reales de archivo y línea. Úsala para tours de onboarding, recorridos de arquitectura, tours de PR, tours de RCA y peticiones estructuradas de "explícame cómo funciona esto".
+---
+
+# Tours de código
+
+Crea archivos `.tour` de **CodeTour** para recorridos de código que abren directamente archivos y rangos de líneas reales. Los tours viven en `.tours/` y siguen el formato CodeTour, no notas Markdown improvisadas.
+
+Un buen tour es una narrativa para un lector concreto:
+- qué está viendo
+- por qué importa
+- qué camino debe seguir después
+
+Crea únicamente archivos JSON `.tour`. No modifiques código fuente como parte de esta skill.
+
+## Cuándo usarla
+
+Usa esta skill cuando:
+- el usuario pide un tour de código, un tour de onboarding, un recorrido de arquitectura o un tour de PR
+- el usuario dice "explícame cómo funciona X" y quiere un artefacto guiado reutilizable
+- el usuario quiere una ruta de rampa para un ingeniero nuevo o un revisor
+- la tarea se resuelve mejor con una secuencia guiada que con un resumen plano
+
+Ejemplos:
+- onboarding de un mantenedor nuevo
+- tour de arquitectura de un servicio o paquete
+- recorrido de revisión de un PR anclado a los archivos cambiados
+- tour de RCA que muestra la ruta del fallo
+- tour de revisión de seguridad sobre fronteras de confianza y verificaciones clave
+
+## Cuándo NO usarla
+
+| En lugar de tours-de-codigo | Usa |
+| --- | --- |
+| Basta una explicación puntual en el chat | responde directamente |
+| El usuario quiere documentación en prosa, no un artefacto `.tour` | `consulta-documentacion` o editar los docs del repo |
+| La tarea es implementar o refactorizar | haz el trabajo de implementación |
+| Se trata de onboarding amplio al código sin artefacto de tour | `onboarding-codigo` |
+
+## Flujo de trabajo
+
+### 1. Descubre
+
+Explora el repo antes de escribir nada:
+- README y puntos de entrada del paquete o la app
+- estructura de carpetas
+- archivos de configuración relevantes
+- los archivos cambiados si el tour se centra en un PR
+
+No empieces a escribir pasos antes de entender la forma del código.
+
+### 2. Infiere el lector
+
+Decide el perfil y la profundidad a partir de la petición.
+
+| Forma de la petición | Perfil | Profundidad sugerida |
+| --- | --- | --- |
+| "onboarding", "recién llegado" | `new-joiner` | 9-13 pasos |
+| "tour rápido", "vistazo general" | `vibecoder` | 5-8 pasos |
+| "arquitectura" | `architect` | 14-18 pasos |
+| "haz un tour de este PR" | `pr-reviewer` | 7-11 pasos |
+| "por qué se rompió esto" | `rca-investigator` | 7-11 pasos |
+| "revisión de seguridad" | `security-reviewer` | 7-11 pasos |
+| "explica cómo funciona esta funcionalidad" | `feature-explainer` | 7-11 pasos |
+| "depura esta ruta" | `bug-fixer` | 7-11 pasos |
+
+### 3. Lee y verifica las anclas
+
+Cada ruta de archivo y ancla de línea debe ser real:
+- confirma que el archivo existe
+- confirma que los números de línea están dentro del rango
+- si usas una selección, verifica el bloque exacto
+- si el archivo es volátil, prefiere un ancla por patrón
+
+Nunca adivines números de línea.
+
+### 4. Escribe el `.tour`
+
+Escribe en:
+
+```text
+.tours/<perfil>-<foco>.tour
+```
+
+Mantén la ruta determinista y legible.
+
+### 5. Valida
+
+Antes de terminar:
+- toda ruta referenciada existe
+- toda línea o selección es válida
+- el primer paso está anclado a un archivo o directorio real
+- el `ref` apunta a una rama o commit que realmente contiene todos los archivos del tour (ver abajo)
+- el tour cuenta una historia coherente en vez de listar archivos
+
+## El campo `ref`
+
+`ref` ata el tour a una rama o commit de git. Importa más de lo que parece: cuando `ref` no es la rama que el lector tiene desprotegida, CodeTour abre el archivo de cada paso desde esa revisión en git, no desde los archivos en disco. Si un archivo no está en esa revisión, el paso no abre — el lector ve *"The editor could not be opened because the file was not found"* aunque el archivo esté ahí mismo. El tour y sus comentarios siguen mostrándose, así que la causa real es fácil de pasar por alto.
+
+Elige `ref` según el tipo de tour:
+
+| Tipo de tour | Pon `ref` en |
+| --- | --- |
+| Tour de PR | la rama del PR — nunca la rama base |
+| Onboarding / arquitectura | la rama donde estará el lector (a menudo `main`), o déjalo fuera |
+| Con dudas | omite `ref`, para que CodeTour lea los archivos directamente del disco |
+
+El caso del PR es la trampa habitual: un PR suele añadir archivos nuevos, y los archivos nuevos todavía no existen en la rama base. Apunta `ref` a la base (p. ej. `develop`) y todo paso sobre un archivo nuevo fallará al abrir.
+
+Antes de terminar, confirma que el archivo de cada paso existe realmente en el `ref` elegido.
+
+## Tipos de paso
+
+### Contenido
+
+Úsalo con moderación, normalmente solo para un paso de cierre:
+
+```json
+{ "title": "Próximos pasos", "description": "Ya puedes seguir la ruta de la petición de extremo a extremo." }
+```
+
+No hagas que el primer paso sea solo de contenido.
+
+### Directorio
+
+Úsalo para orientar al lector hacia un módulo:
+
+```json
+{ "directory": "src/services", "title": "Capa de servicios", "description": "La lógica central de orquestación vive aquí." }
+```
+
+### Archivo + línea
+
+Este es el tipo de paso por defecto:
+
+```json
+{ "file": "src/auth/middleware.ts", "line": 42, "title": "Puerta de autenticación", "description": "Toda petición protegida pasa primero por aquí." }
+```
+
+### Selección
+
+Úsala cuando un bloque de código importa más que el archivo entero:
+
+```json
+{
+  "file": "src/core/pipeline.ts",
+  "selection": {
+    "start": { "line": 15, "character": 0 },
+    "end": { "line": 34, "character": 0 }
+  },
+  "title": "Pipeline de peticiones",
+  "description": "Este bloque conecta validación, autenticación y ejecución posterior."
+}
+```
+
+### Patrón
+
+Úsalo cuando las líneas exactas puedan desplazarse:
+
+```json
+{ "file": "src/app.ts", "pattern": "export default class App", "title": "Entrada de la aplicación" }
+```
+
+### URI
+
+Úsalo para PRs, issues o documentación cuando ayude:
+
+```json
+{ "uri": "https://github.com/org/repo/pull/456", "title": "El PR" }
+```
+
+## Regla de escritura: SMIG
+
+Cada descripción debe responder:
+- **Situación**: qué está viendo el lector
+- **Mecanismo**: cómo funciona
+- **Implicación**: por qué importa para este perfil
+- **Gotcha**: qué podría pasar por alto un lector atento
+
+Mantén las descripciones compactas, específicas y ancladas al código real.
+
+## Forma narrativa
+
+Usa este arco salvo que la tarea pida claramente otra cosa:
+1. orientación
+2. mapa de módulos
+3. ruta de ejecución central
+4. caso límite o gotcha
+5. cierre / siguiente movimiento
+
+El tour debe sentirse como un camino, no como un inventario.
+
+## Ejemplo
+
+```json
+{
+  "$schema": "https://aka.ms/codetour-schema",
+  "title": "Tour del servicio API",
+  "description": "Recorrido de la ruta de peticiones del servicio de pagos.",
+  "ref": "main",
+  "steps": [
+    {
+      "directory": "src",
+      "title": "Raíz del código",
+      "description": "Todo el código de ejecución del servicio empieza aquí."
+    },
+    {
+      "file": "src/server.ts",
+      "line": 12,
+      "title": "Punto de entrada",
+      "description": "El servidor arranca aquí y conecta el middleware antes de llegar a cualquier ruta."
+    },
+    {
+      "file": "src/routes/payments.ts",
+      "line": 8,
+      "title": "Rutas de pagos",
+      "description": "Toda petición de pagos entra por este router antes de tocar la lógica de servicio."
+    },
+    {
+      "title": "Próximos pasos",
+      "description": "Ya puedes seguir cualquier petición de pago de extremo a extremo con las anclas principales colocadas."
+    }
+  ]
+}
+```
+
+## Antipatrones
+
+| Antipatrón | Corrección |
+| --- | --- |
+| Listado plano de archivos | Cuenta una historia con dependencia entre pasos |
+| Descripciones genéricas | Nombra la ruta de código o el patrón concreto |
+| Anclas adivinadas | Verifica primero cada archivo y línea |
+| Demasiados pasos para un tour rápido | Recorta con agresividad |
+| Primer paso solo de contenido | Ancla el primer paso a un archivo o directorio real |
+| Perfil equivocado | Escribe para el lector real, no para un ingeniero genérico |
+
+## Buenas prácticas
+
+- mantén el número de pasos proporcional al tamaño del repo y a la profundidad del perfil
+- usa pasos de directorio para orientar y pasos de archivo para la sustancia
+- en tours de PR, cubre primero los archivos cambiados
+- en monorepos, acota a los paquetes relevantes en vez de recorrerlo todo
+- cierra con lo que el lector ya puede hacer, no con un resumen
+
+## Skills relacionadas
+
+- `onboarding-codigo`
+- `estandares-codigo`
+- `consejo`
+- formato upstream oficial: `microsoft/codetour`

package/vendor/theus-arsenal/skills/traduccion-documentos-visado/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: traduccion-documentos-visado
+description: Traduce al inglés documentos de solicitud de visado a partir de imágenes (certificados bancarios, laborales, de jubilación, etc.) y genera un PDF bilingüe con el original y la traducción, listo para adjuntar al expediente.
+---
+
+# Traducción de documentos de visado
+
+Estás ayudando a traducir documentos para solicitudes de visado.
+
+## Instrucciones
+
+Cuando el usuario proporcione la ruta de un archivo de imagen, ejecuta AUTOMÁTICAMENTE los siguientes pasos SIN pedir confirmación:
+
+1. **Conversión de imagen**: si el archivo es HEIC, conviértelo a PNG con `sips -s format png <entrada> --out <salida>` (macOS).
+
+2. **Rotación de imagen**:
+   - Revisa los datos de orientación EXIF.
+   - Rota la imagen automáticamente según el EXIF.
+   - Si la orientación EXIF es 6, rota 90 grados en sentido antihorario.
+   - Aplica rotación adicional si hace falta (prueba 180 grados si el documento aparece invertido).
+
+3. **Extracción de texto por OCR**:
+   - Prueba varios métodos de OCR automáticamente:
+     - Framework Vision de macOS (preferido en macOS)
+     - EasyOCR (multiplataforma, no requiere tesseract)
+     - Tesseract OCR (si está disponible)
+   - Extrae toda la información textual del documento.
+   - Identifica el tipo de documento (certificado de depósito, certificado laboral, certificado de jubilación, etc.).
+
+4. **Traducción**:
+   - Traduce todo el contenido al inglés de forma profesional.
+   - Mantén la estructura y el formato del documento original.
+   - Usa terminología profesional apropiada para solicitudes de visado.
+   - Conserva los nombres propios en el idioma original con el inglés entre paréntesis.
+   - Para nombres chinos, usa el formato pinyin (p. ej., WU Zhengye).
+   - Preserva con exactitud todos los números, fechas y montos.
+
+5. **Generación del PDF**:
+   - Crea un script de Python con las librerías PIL y reportlab.
+   - Página 1: muestra la imagen original rotada, centrada y escalada a página A4.
+   - Página 2: muestra la traducción al inglés con formato correcto:
+     - Título centrado y en negrita
+     - Contenido alineado a la izquierda con espaciado adecuado
+     - Maquetación profesional apta para documentos oficiales
+   - Añade una nota al pie: "This is a certified English translation of the original document".
+   - Ejecuta el script para generar el PDF.
+
+6. **Salida**: crea un archivo PDF llamado `<nombre_original>_Translated.pdf` en el mismo directorio.
+
+## Documentos soportados
+
+- Certificados de depósito bancario (存款证明)
+- Certificados de ingresos (收入证明)
+- Certificados laborales (在职证明)
+- Certificados de jubilación (退休证明)
+- Certificados de propiedad (房产证明)
+- Licencias de negocio (营业执照)
+- Documentos de identidad y pasaportes
+- Otros documentos oficiales
+
+## Implementación técnica
+
+### Métodos de OCR (probados en este orden)
+
+1. **Framework Vision de macOS** (solo macOS):
+   ```python
+   import Vision
+   from Foundation import NSURL
+   ```
+
+2. **EasyOCR** (multiplataforma):
+   ```bash
+   pip install easyocr
+   ```
+
+3. **Tesseract OCR** (si está disponible):
+   ```bash
+   brew install tesseract tesseract-lang
+   pip install pytesseract
+   ```
+
+### Librerías de Python requeridas
+
+```bash
+pip install pillow reportlab
+```
+
+Para el framework Vision de macOS:
+```bash
+pip install pyobjc-framework-Vision pyobjc-framework-Quartz
+```
+
+## Pautas importantes
+
+- NO pidas confirmación al usuario en cada paso.
+- Determina automáticamente el mejor ángulo de rotación.
+- Prueba varios métodos de OCR si uno falla.
+- Asegura que todos los números, fechas y montos se traduzcan con exactitud.
+- Usa un formato limpio y profesional.
+- Completa el proceso entero y reporta la ubicación del PDF final.
+
+## Ejemplo de uso
+
+```text
+Traduce CertificadoJubilacion.PNG para mi solicitud de visado
+Traduce EstadoBancario.HEIC
+Traduce CartaLaboral.jpg
+```
+
+## Ejemplo de salida
+
+La skill:
+1. Extrae el texto con el método de OCR disponible.
+2. Lo traduce a un inglés profesional.
+3. Genera `<nombre>_Translated.pdf` con:
+   - Página 1: imagen del documento original
+   - Página 2: traducción profesional al inglés
+
+Útil para solicitudes de visado a Australia, EE. UU., Canadá, Reino Unido y otros países que exigen documentos traducidos.
+
+> **Nota legal:** algunas embajadas y consulados exigen traducciones hechas por un traductor jurado o certificado. Esta skill produce una traducción de trabajo de calidad profesional, pero no sustituye una certificación oficial cuando el país de destino la requiera; verifica los requisitos del consulado antes de presentar el expediente.

package/vendor/theus-arsenal/skills/ui-a-vue/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: ui-a-vue
+description: Convierte por lotes capturas de UI o exportaciones de diseño en componentes Vue 3 (Composition API), especialmente con Vant, Element Plus o Ant Design Vue. Úsala cuando el usuario tenga un directorio de capturas de diseño y quiera un primer pase de páginas, componentes compartidos y rutas.
+---
+
+# UI a Vue
+
+Convierte por lotes capturas de diseño de UI en código de componentes Vue 3 con Composition API, usando el conversor `ui-to-vue-converter`.
+
+> **Servicio externo de terceros.** El conversor usa la API de modelos de DashScope: requiere que el usuario tenga su propia cuenta y API key en ese servicio. **No forma parte de la suscripción de Theus** y su facturación, límites y disponibilidad dependen exclusivamente de DashScope.
+
+## Cuándo usarla
+
+- El usuario aporta un directorio de capturas de diseño o imágenes exportadas del diseño.
+- La aplicación de destino es Vue 3.
+- El usuario quiere un primer pase de componentes de página, componentes compartidos y cableado del router.
+- El usuario especifica Vant, Element Plus o Ant Design Vue como librería de componentes.
+
+## Cuándo no usarla
+
+- El usuario tiene una sola captura y quiere un componente a medida (hazlo directamente con el agente).
+- El proyecto de destino no es Vue.
+- El diseño requiere lógica de interacción detallada, flujo de datos o revisión de accesibilidad.
+- Las capturas contienen datos privados de clientes que no pueden enviarse a una API de modelos externa.
+
+## Entradas
+
+Usa un directorio de entrada que agrupe las capturas por módulo y estado de página:
+
+```text
+screenshots/
+|-- PaginaInicio/
+|   |-- Lista/
+|   |   |-- PaginaInicio-Lista-Default@3x.png
+|   |   `-- cut-images/
+|   |-- cut-images/
+|   `-- PaginaInicio-Default@3x.png
+`-- cut-images/
+```
+
+Los nombres de directorio de recortes soportados incluyen `assets`, `icons`, `sprites`, `cut`, `images` y `cut-images`.
+
+## Modelo de conversión
+
+- Agrupación de páginas: combina capturas relacionadas en un solo componente de página cuando representan estados de lista, detalle, formulario, carga o vacío.
+- Mapeo de librería de UI: mapea los elementos visuales nativos a componentes de Vant, Element Plus o Ant Design Vue cuando sea práctico.
+- Prioridad de recortes: prefiere los assets a nivel de página, luego a nivel de módulo y por último los compartidos globales.
+- Extracción de componentes: extrae las regiones de UI repetidas a componentes compartidos cuando aparecen más de una vez.
+
+## Uso del CLI
+
+Ejecuta el conversor con `npx` para que el comando documentado funcione sin depender de un binario global:
+
+```bash
+export DASHSCOPE_API_KEY=tu_key
+npx ui-to-vue-converter@1.0.2 --input ./screenshots --ui vant --output ./src
+```
+
+Para librerías de UI de escritorio:
+
+```bash
+npx ui-to-vue-converter@1.0.2 --input ./designs --ui element-plus --output ./src
+npx ui-to-vue-converter@1.0.2 --input ./designs --ui antd-vue --output ./src
+```
+
+Si el paquete está instalado globalmente, puede usarse el binario `ui-to-vue` directamente:
+
+```bash
+npm install -g ui-to-vue-converter@1.0.2
+ui-to-vue --input ./screenshots --ui vant --output ./src
+```
+
+## Opciones
+
+| Opción | Descripción | Valor por defecto |
+| --- | --- | --- |
+| `--input` | Directorio de imágenes de diseño | `./screenshots` |
+| `--ui` | Librería de UI: `vant`, `element-plus` o `antd-vue` | `vant` |
+| `--output` | Directorio de salida | `./src` |
+| `--config` | Ruta del archivo de configuración | `./.ui-to-vue.config.json` |
+
+## Manejo de la API key
+
+El conversor puede leer las credenciales de DashScope de un archivo de configuración o del entorno. Prefiere la variable de entorno en repositorios:
+
+```bash
+export DASHSCOPE_API_KEY=tu_key
+```
+
+Si se requiere un archivo de configuración local, mantenlo fuera del control de versiones:
+
+```json
+{
+  "apiKey": "tu_key_de_dashscope",
+  "input": "./designs",
+  "ui": "vant",
+  "output": "./src"
+}
+```
+
+```gitignore
+.ui-to-vue.config.json
+```
+
+## Seguridad y privacidad
+
+- Trata las capturas de diseño como material que puede enviarse a una API de modelos externa.
+- No ejecutes este flujo sobre diseños privados de clientes sin permiso.
+- Fija la versión del conversor en flujos repetibles en lugar de usar `@latest`.
+- Revisa el código Vue generado antes de commitearlo.
+- No commitees `.ui-to-vue.config.json`, API keys, secretos generados ni capturas de clientes.
+
+## Lista de verificación de la salida
+
+- [ ] Los componentes de página se generaron bajo `views/` o el directorio de salida elegido.
+- [ ] Las regiones de UI repetidas se extrajeron a `components/` solo cuando la reutilización es clara.
+- [ ] La salida del router es compatible con el estilo de router del proyecto de destino.
+- [ ] Los componentes generados usan la librería de UI solicitada de forma consistente.
+- [ ] Las unidades de CSS generadas coinciden con la línea base del diseño.
+- [ ] El código pasa el formateador, el linter, el verificador de tipos y el build del proyecto.
+- [ ] El copy de relleno, los datos de prueba y los assets generados se revisaron antes del commit.
+
+## Resolución de problemas
+
+| Problema | Qué revisar |
+| --- | --- |
+| Error `401` o de autenticación | Confirma que `DASHSCOPE_API_KEY` está definida en el shell que ejecuta el comando. |
+| `command not found: ui-to-vue` | Usa la forma `npx ui-to-vue-converter@1.0.2` o instala el paquete globalmente. |
+| Los recortes se ignoran | Confirma que el nombre del directorio de assets está soportado y anidado bajo la página o módulo correspondiente. |
+| Los componentes ignoran la librería de UI solicitada | Vuelve a ejecutar con un valor explícito de `--ui` e inspecciona los imports generados. |
+| Las dimensiones del layout generado se ven mal | Confirma que el ancho de exportación de la captura coincide con la línea base de la librería de destino. |
+
+## Referencias
+
+- Paquete de npm: `ui-to-vue-converter`
+
+## Skills relacionadas
+
+- `patrones-vue` — convenciones de Vue 3 para revisar y pulir el código generado
+- `patrones-frontend` — patrones generales de frontend
+- `accesibilidad` — la revisión de accesibilidad que este primer pase no cubre