Update to Obratec

{
  "description": "Prepara y diagnostica un informe semanal de obra con órdenes de cambio en OBRATEC. Úsala para revisar OCs de una obra y semana, detectar faltantes y preparar un borrador; el vínculo y cierre de OCs en el informe se hacen en la app.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 494
    }
  ],
  "name": "informe-semanal-ocs",
  "skill_md_contents": "---\nname: informe-semanal-ocs\ndescription: Prepara y diagnostica un informe semanal de obra con órdenes de cambio en OBRATEC. Úsala para revisar OCs de una obra y semana, detectar faltantes y preparar un borrador; el vínculo y cierre de OCs en el informe se hacen en la app.\n---\n\n# Informe semanal con OCs\n\nPrepara una revisión verificable de **una obra y una semana**. Responde en el idioma del usuario. La lectura es el comportamiento por defecto. El MCP permite leer OCs e informes, crear un borrador de informe y marcar **OC en borrador** para una semana; **no expone la selección de OCs candidatas del informe, su vínculo ni el cierre/snapshot**. Esa revisión final se hace en la ficha del informe de OBRATEC.\n\n## Preparación y diagnóstico\n\n1. Identifica la obra con `list_projects(search=...)`. Si hay varias coincidencias, pide una elección; conserva el `id` y nombre exacto. Fija la semana ISO `YYYY-Www` y sus fechas locales. Para «esta semana», usa la zona horaria fiable del usuario; si falta, pide la zona antes de asignar fechas. No deduzcas la semana de la fecha de creación de una OC.\n2. Consulta `list_change_orders(project_id=<id>, limit=100, skip=...)`. Pagina hasta una página incompleta o, como máximo, tres páginas y declara si el barrido queda parcial. Abre con `get_change_order` las OCs relevantes. Separa las marcadas `include_in_weekly_report=true` **y** con `weekly_period` igual a la semana, las de otra semana o sin periodo, y las no marcadas. Distingue sus estados reales; estar marcada no implica aprobación ni inclusión efectiva en un informe.\n3. Consulta `list_reports(search=<nombre exacto>, limit=100, skip=...)` con el mismo límite. Filtra por `proyecto` exacto y por `fecha` dentro de la semana; la lista se ordena por `created_at`, no por fecha del informe. Usa `get_report` para los candidatos. Consulta `get_report_types()` y la capacidad `links_change_orders`: obra/visita y tipos propios de empresa que la tengan pueden servir para este flujo. No inventes una clave `semanal` ni claves `org_…`; toma la clave exacta del catálogo. Si no puedes verificar la capacidad de una versión antigua, indica el límite. El detalle MCP tampoco acredita qué OCs quedaron vinculadas o congeladas; remite a la ficha del informe para comprobarlo.\n4. Si el usuario pregunta por importes o desviación, consulta `get_project_contract_summary(project_id=<id>)`. Separa aprobado y pendiente. Con `has_contract=false`, `variation_pct=null` significa falta de base contractual, nunca variación cero.\n\n## Acciones disponibles solo por petición expresa\n\n- Para **marcar una OC en borrador**: comprueba su `project_id`, estado, `include_in_weekly_report` y `weekly_period` con `get_change_order`. Muestra ID/número, obra, semana y valores actual→propuesto; pide confirmación explícita antes de `update_change_order(oc_id, include_in_weekly_report=true, weekly_period=<semana ISO>)`. Requiere permiso `read_write`; un 403 o una OC que no sea borrador detiene la acción. Vuelve a leerla para verificar el cambio. Esto solo marca la OC: no la inserta en un informe ni crea snapshot.\n- Si el usuario pide **crear el borrador** y facilita o confirma obra, fecha y un tipo activo de `get_report_types` con `links_change_orders=true`, usa `create_report(proyecto=<nombre exacto>, fecha=<YYYY-MM-DD>, report_type=<clave exacta>)` con los demás campos solo si están confirmados. Esta escritura requiere `read_write` y consume cupo de informes creados; puedes consultar `get_account_usage` para mostrar el consumo disponible. No añadas `email_destino` por inferencia. Comprueba el ID y estado `draft` con `get_report`. La creación no enlaza OCs; explica que debe seleccionarlas y revisarlas en la ficha del informe.\n\nNo llames a `set_change_order_status`, `publish_report`, `generate_report_ai` ni a ninguna aprobación o envío como parte de este flujo. `next_steps` son sugerencias, no permisos. Si la credencial es de solo lectura, entrega el diagnóstico y los pasos para actuar con una credencial `read_write` o en la app; no intentes esquivar el 403.\n\n## Entrega\n\nDa obra y semana exactas; informe existente o borrador creado con ID y estado; OCs marcadas para revisión, pendientes y descartadas con ID, estado y motivo; discrepancias y datos ausentes. Explica qué lecturas hiciste y si la paginación quedó incompleta. Termina con la acción concreta en la ficha del informe: revisar/seleccionar las OCs y comprobar el resultado antes de cualquier publicación. Nunca afirmes que el chat cerró o congeló esas OCs.\n"
}