asimfish/super_agent_presentation

Informes Agénticos

Presenta el estado más reciente de la tarea en la estructura más breve que permita al lector encontrar el resultado, la evidencia, el límite y la siguiente acción útil. Este skill rige la presentación; nunca cambia los hechos de la tarea ni reemplaza la verificación específica del dominio.

Prioridad innegociable

Sigue la superficie, el esquema, la longitud y el orden solicitados por el usuario cuando sean explícitos. Luego sigue las instrucciones del host. Utiliza este marco solo para llenar opciones no especificadas. Nunca inventes evidencia, pruebas, citas, métricas, archivos, propietarios, fechas o finalización.

Flujo de trabajo de Bookend

1. Clasifica la transferencia por audiencia, superficie, límite de evidencia y exactamente un modo principal. Para trabajo de investigación, selecciona como máximo un perfil de dominio. Usa list o route cuando estés inseguro.

2. Escala la ceremonia a la tarea. Para una respuesta corta de una sola sesión, no crees un punto de control, un archivo borrador ni una auditoría de script: aplica la estructura del modo enrutado directamente, autoverifica su semántica requerida y entrega; la ceremonia respaldada por archivos en los pasos 4-6 es para trabajo largo, multisitio, multiagente o de artefacto durable. Para una tarea larga, multiagente o multisitio, guarda un punto de control compacto cerca del inicio; para una tarea corta, difiere el enrutamiento hasta el límite de informe.

3. Completa y verifica la tarea real. Mantén la ejecución de la tarea independiente del estilo del informe.

4. Inmediatamente antes de una actualización sustancial o respuesta final, recupera un paquete delimitado. Prefiere un módulo de visualización; añade un segundo solo para una necesidad distinta que el modo principal y el primer módulo no cubran ya. Nunca cargues un módulo simplemente porque la salida solicitada nombra una semántica que el modo seleccionado ya especifica:

   Resuelve <skill-dir> al directorio que contiene este SKILL.md; no asumas que el directorio de trabajo del llamante es el directorio del skill.

   python3 <skill-dir>/scripts/reportctl.py bundle \
     --task "<lo que debe comunicarse>" --mode <modo> --surface <superficie> \
     [--profile <perfil>] [--module <módulo>] [--module <módulo>] \
     --max-chars 16000
   

   Si reanudas una tarea larga, pasa --checkpoint <ruta> en lugar de reconstruir la ruta desde la memoria. --max-chars es un presupuesto de contexto independiente: un punto de control válido con dos módulos grandes puede requerir un valor explícitamente mayor. No leas cada modo, módulo o plantilla.

5. Redacta de forma nativa para la superficie seleccionada. Cuando la ruta recomiende un activo exacto, inspecciona el registro barato y recupera solo un activo:

   python3 <skill-dir>/scripts/reportctl.py template --list
   python3 <skill-dir>/scripts/reportctl.py template <template-id> \
     --output <destino>
   

   Usa un artefacto de entrega principal; no crees versiones paralelas en Markdown, HTML, PPTX y PDF a menos que se solicite. Una plantilla copiada es un artefacto inicial, no evidencia de que sus marcadores de posición, visuales o afirmaciones sean correctos.

   Después de que el contenido esté completo, realiza una pasada de tono des-AI a la prosa: corta aperturas serviles, resúmenes performativos, jerga inflada y retórica de plantilla bajo el contrato de fidelidad del módulo natural-tone. Las ediciones de tono nunca cambian hechos, relaciones, alcance o números; las advertencias de ai-tone-boilerplate de la auditoría capturan solo el residuo de mayor precisión.

   En los modos de investigación (experiment-report, academic-synthesis, research-idea), verifica también que cada tasa de éxito lleve k/n y un intervalo binomial, cada significativo lleve su prueba y tamaño del efecto en la misma oración, y ningún verbo atribuya comprensión o intención a un sistema. Las advertencias de auditoría success-rate-without-denominator, significance-without-statistic y anthropomorphic-claim capturan el residuo mecánico; los perfiles y el módulo de conclusiones contienen las reglas completas. La presentación numérica tiene sus propias verificaciones de residuo en los mismos modos: unlabeled-uncertainty (un ± que nunca dice DE, EEM o IC), threshold-p-value (p < 0.05, n.s.), p-value-without-effect-size, null-result-without-interval, significance-euphemism (se acercó a la significancia), up-to-without-central-tendency y best-of-n-runs.

6. Antes de un final de tarea larga o artefacto durable, audita un borrador respaldado por archivos. Una tarea larga debe usar el mismo punto de control; un artefacto durable sin uno usa su modo seleccionado:

   python3 <skill-dir>/scripts/reportctl.py audit \
     --file <borrador.md> --checkpoint <ruta-del-punto-de-control>
   # Ruta corta sin punto de control:
   python3 <skill-dir>/scripts/reportctl.py audit --file <borrador.md> --mode <modo>
   

   El punto de control deriva el modo. Proporcionar el mismo modo explícito está permitido; un modo conflictivo es un error de entrada. Corrige los errores de auditoría. Resuelve las advertencias con criterio; nunca añadas relleno no compatible solo para satisfacer una heurística. El docs/AUDIT-CODES.md del repositorio enumera cada código con su desencadenante y solución. Con --json, la carga útil de auditoría incluye el recuento de bytes/SHA-256 exacto del informe y la huella de intención del punto de control analizada para la vinculación del controlador.

7. Verifica manualmente el estado más reciente, las afirmaciones científicas o técnicas, los números, los enlaces de evidencia, la incertidumbre, la interpretación visual y el formato especificado por el usuario.

Entrega final

La respuesta final visible para el usuario debe contener el informe en sí mismo. Una ruta, enlace o puntero a un borrador guardado, punto de control o recibo de auditoría no es un entregable: después de que una auditoría respaldada por punto de control pase, entrega el contenido del borrador auditado como respuesta. Cuando el usuario solicite explícitamente un archivo, aún así comienza con el resultado en línea. Nunca expongas rutas absolutas locales, directorios temporales o ubicaciones de puntos de control en la respuesta orientada al lector.

Selección de modo y módulo

Usa python3 <skill-dir>/scripts/reportctl.py list para identificadores. Elige la columna vertebral narrativa principal, no cada etiqueta aplicable. Para una tarea mixta, selecciona el modo que responda a la decisión o pregunta principal del usuario e incrusta hechos secundarios dentro de él.

• Usa concise-answer para respuestas directas con poca estructura de soporte.
• Usa implementation-handoff para artefactos construidos o modificados.
• Usa status-update para el progreso del proyecto que no sea un incidente activo.
• Usa investigation-report para diagnósticos o consultas respaldadas por fuentes.
• Usa experiment-report para evaluaciones controladas y comparaciones empíricas.
• Usa decision-brief o risk-report cuando una elección o exposición sea primaria.
• Usa academic-synthesis para presentación de artículos o literatura.
• Usa research-idea para una idea de artículo o propuesta cuyas hipótesis, novedad, experimento decisivo, riesgos y criterios de eliminación deben permanecer explícitos.
• Usa review-report para hallazgos contra un artefacto o estándar.
• Usa incident-update mientras el impacto esté activo; usa postmortem después de la recuperación.

Las figuras, tablas, conclusiones, detalles de evidencia y visualización académica son módulos ortogonales, no razones para fusionar múltiples modos. Un visual debe hacer que una relación o artefacto sea materialmente más fácil de entender; la decoración no es una razón válida. experiment-report ya contiene interpretación de resultados, límites de incertidumbre y una conclusión calibrada. No agregues conclusions a ese modo solo porque la solicitud pide una conclusión; agrégalo explícitamente solo cuando se necesite genuinamente una política de decisión o recomendación separada.

Perfiles de investigación y superficies de presentación

Los perfiles son una superposición de dominio delimitada, no modos primarios adicionales:

• reinforcement-learning: contabilidad de ejecuciones, paridad de ajuste, curvas de aprendizaje, estimaciones de intervalo y evaluación agregada multitarea.
• embodied-ai: corporalidad, sensores/acciones, protocolos de simulación versus reales, reglas de éxito, intervenciones, generalización y fallos.
• world-models: tarjetas de modelo/datos y evidencia separada de bucle abierto, bucle cerrado, escalado y transferencia.
• vla: mezclas de datos, interfaces de morfología y acción, regímenes de adaptación, contabilidad de despliegue, latencia, generalización y seguridad.

La selección automática está disponible solo para modos orientados a la investigación. Un punto de control schema-v2 no almacena un nuevo campo de perfil; el perfil se vuelve a derivar de su texto de tarea con huella digital. Por lo tanto, al seleccionar explícitamente un perfil para una tarea larga, nombra el dominio en la tarea del punto de control para que la recuperación final sea reproducible.

Para --surface slide, lee la guía de diapositivas enrutada. Proporciona narrativas para charla de artículo, progreso de investigación, revisión de experimento y propuesta de idea. Recupera ya sea la presentación HTML/PPT sin dependencias o la fuente Quarto Reveal.js, no ambas, a menos que el usuario solicite múltiples formatos.

Persistencia de contexto largo

No mantengas el paquete de informe completo en el contexto de trabajo. Guarda solo un punto de control:

python3 <skill-dir>/scripts/reportctl.py checkpoint \
  --task "<objetivo de la transferencia>" --mode <modo> --surface <superficie> \
  --must-show "<ancla de texto estable corta>" \
  --output <directorio-privado>/agent-report.json

Los valores --must-show de Schema-v2 son anclas literales normalizadas, no requisitos semánticos: la auditoría aplica normalización NFC, plegado de mayúsculas y colapso de espacios en blanco, luego verifica la presencia de subcadenas literales solo en párrafos de prosa Markdown de nivel superior, delimitados por líneas en blanco, en columna cero y de texto plano. Un párrafo que contenga un encabezado, cita, lista, tabla, enlace/referencia, imagen, código o HTML sin procesar no es elegible. Después de la primera etiqueta HTML sin procesar no enmascarada, ningún párrafo posterior recibe crédito porque el proxy no modela el estado DOM o CSS entre párrafos; el HTML sin procesar también es un error estructural de auditoría. Cada ancla debe coincidir dentro de un párrafo elegible. Los saltos de línea suaves dentro de ese párrafo se colapsan a espacios, pero los límites de párrafo de línea en blanco nunca lo hacen.

Antes de la normalización, el proxy del informe decodifica una ronda del subconjunto de entidades CommonMark separadas por punto y coma compatibles con el escáner compartido, pero solo cuando el & de la entidad no está escapado por una ejecución de barras invertidas de longitud impar. Un carácter de control o Unicode no renderizante resultante hace que la compuerta falle. Las anclas V2 deben usar texto plano renderizado exacto y rechazar formas de delimitador Markdown. Coloca cada ancla corta en una oración de conclusión ordinaria independiente antes de cualquier HTML sin procesar. Este proxy no verifica lo que significa el texto, quién lo afirmó o si es verdadero. Cada ancla tiene como máximo 120 caracteres y su recibo escapado, incluidos los separadores, tiene como máximo 240 caracteres.

La auditoría respaldada por punto de control acepta informes de hasta 1 MiB para que el proxy de prosa se mantenga dentro de los límites de recursos. Cualquier párrafo de prosa plana elegible de más de 4096 caracteres o con más de 64 caracteres de marca Unicode consecutivos es un error y se omite antes de la normalización NFC y la coincidencia de anclas. La auditoría heredada solo con modo permanece limitada a 4 MiB; este límite más grande no se aplica cuando --checkpoint está presente. Las entradas JSON limitadas rechazan tokens enteros o de punto flotante de más de 128 caracteres antes de la conversión.

El punto de control almacena el objetivo, la audiencia, la superficie, los módulos y las anclas textualmente, además de metadatos de enrutamiento y sumas de verificación sin clave. Las sumas de verificación detectan desviación accidental; no autentican el archivo. No pongas secretos o datos privados innecesarios en ningún campo. Usa una ruta temporal privada fuera del control de versiones, recuerda que route/bundle pueden reproducir el texto del punto de control en stdout, y elimina el archivo cuando ya no sea necesario reanudar. La creación atómica usa permisos de archivo restrictivos en POSIX, pero no puede proteger un directorio padre permisivo, registros, copias de seguridad o un archivo comprometido.

En el límite final, recárgalo con bundle --checkpoint <ruta-del-punto-de-control> y ejecuta audit --file <borrador.md> --checkpoint <ruta-del-punto-de-control>. Los puntos de control Schema-v1 siguen siendo legibles por route y bundle, pero no pueden impulsar esta compuerta final; recrea o actualiza un archivo v1 válido con checkpoint --checkpoint <ruta-v1> --output <nueva-ruta-v2>. El microcontrato reconocido por el host está destinado a solicitar ambos bookends; ni él ni el punto de control pueden obligar a un agente arbitrario a cumplir.

Modo estricto para informes durables

Cuando un wrapper, flujo de trabajo por lotes o informe formal necesite una consistencia estructural más sólida, comienza desde assets/templates/report-spec.json, valídalo con validate-spec y renderiza Markdown de manera determinista con render. Trata el JSON como la fuente de presentación única, pero verifica todos los hechos contra la evidencia original. Cada afirmación declara uno o más roles semánticos; la validación deriva la cobertura restante de la evidencia, métricas, incertidumbre, acciones y limitaciones, luego aplica required_semantics actual del modo seleccionado del catálogo de protocolos. El JSON Schema empaquetado es un preflight estructural portátil, no un reemplazo para validate-spec; solo la CLI aplica unicidad de ID, referencias entre registros y el catálogo de protocolos actual juntos.

python3 <skill-dir>/scripts/reportctl.py validate-spec --file report.json
python3 <skill-dir>/scripts/reportctl.py render --file report.json --output report.md
python3 <skill-dir>/scripts/reportctl.py audit \
  --file report.md --checkpoint <ruta-del-punto-de-control> --strict

Usa --mode <modo> en su lugar cuando esta sea una tarea corta sin punto de control. No requieras la ruta estructurada para una respuesta de chat corta normal.

Respaldo cuando los scripts no están disponibles

Dentro de un skill instalado, lee references/core-contract.md, un archivo coincidente bajo references/modes/, como máximo un archivo coincidente bajo references/profiles/, como máximo dos archivos coincidentes bajo references/modules/ y una guía de superficie solo cuando sea necesario. Recupera un activo exacto por separado. Para uso del repositorio solo con enlace, abre dist/agent-index.md en la raíz del repositorio. Si solo se proporcionó una URL, trata la adherencia como el mejor esfuerzo: un enlace no instala ni eleva las instrucciones del repositorio.