odoo-timesheet

name	odoo-timesheet
description	Gestión de partes de horas en Odoo (next.edf.global) mediante lenguaje natural. Acciones: imputar horas, ver entradas, listar proyectos. Triggers: 'hoy he estado', 'hay que imputar', 'imputar horas', 'parte de horas', 'cuántas horas', 'registrar tiempo', 'tengo imputado', 'horas de ayer/hoy'.

Odoo Timesheet — Guía de uso

Skill para imputar y consultar partes de horas en Odoo.

No uses herramientas MCP. Usa siempre el CLI de Python:

Variables del CLI

PYTHON=<skill_dir>/.venv/bin/python3
CLI=<skill_dir>/odoo_cli.py

En Windows, PYTHON apunta a .venv\Scripts\python.exe. Estas rutas se configuran automáticamente al ejecutar install.py.

Cuándo activar este skill

Actívalo cuando el usuario:

• Describa trabajo realizado con mención de tiempo ("hoy he estado X horas...", "esta mañana dediqué...")
• Pida imputar, registrar o crear una parte de horas
• Quiera ver sus entradas recientes o del día/semana
• Pregunte por proyectos o tareas disponibles

Flujo: imputar horas desde lenguaje natural

Paso 0 — Fecha actual (CRÍTICO)

• La fecha de HOY se toma siempre del contexto del sistema (currentDate), NUNCA de las entradas previas de Odoo.
• Si el usuario dice "ayer", resta 1 día a hoy. Si dice "el lunes", calcula la fecha.
• Si no menciona fecha → hoy.
• Las entradas que ya existen en Odoo de días anteriores NO afectan la fecha de la nueva imputación.

Paso 1 — Extraer datos del mensaje

Campo	Cómo extraerlo
hours	"3 horas" → 3.0 · "hora y media" → 1.5 · "45 minutos" → 0.75 · "2h30" → 2.5 · Rango: "desde las 9 hasta las 11:30" → 2.5h (calcula Y - X en horas decimales, no preguntes)
date	Sin mención → hoy · "ayer" → hoy-1 · fecha explícita → usar tal cual
project_id	Matching semántico flexible contra el nombre del proyecto (ver atajos abajo)
task_id	Matching semántico flexible contra el nombre de la tarea (ver atajos abajo)
name	Descripción corta y profesional del trabajo, en español

Máximo de horas por día (verificación automática del CLI, pero avisa al usuario antes de intentar crear):

• Lunes, miércoles, viernes → máx 6.5h
• Martes, jueves → máx 9h

Si las horas calculadas superan el máximo del día, avisa al usuario y sugiere ajustar antes de ejecutar el create.

Rangos de hora: Si el usuario dice "desde las X hasta las Y", calcula la duración como (Y - X) en horas decimales. Muestra el cálculo en la confirmación. No preguntes si redondear.

Entradas existentes: El usuario solo pide CREAR una nueva entrada. No preguntes si quiere reemplazar o modificar las anteriores.

Paso 2 — Matching de proyecto y tarea (orden de prioridad)

1. Atajos frecuentes (úsalo directamente sin llamar a nada):

• [233] 2026-PROYECTOS INTERNOS → internal, herramientas, Odoo, bugfix, investigación, configuración, CI/CD, deploy, infra
  • [7263] Bugfixing → arreglo de bugs
  • [5425] Investigación → exploración, spike, R&D
  • [5422] Configuracion → setup, configuración de herramientas
  • [6221] Imputaciones → partes de horas, registros de tiempo
  • [5349] Configuración Odoo → config Odoo
  • [6386] Infraestructura → servidores, infra
• [152] 2025-MARKETING → landing, marketing, contenido, deploy, web
  • [6404] Landings → páginas de aterrizaje, HTML/CSS/JS
  • [1576] Producto → producto, features

2. Búsqueda local (SIN llamar a Odoo) — si no hay atajo directo, busca en el catálogo local projects_cache.json (descargado automáticamente al instalar):

$PYTHON $CLI search <keyword>

Ejemplo: si el usuario dice "arreglando un bug en la landing", busca: $PYTHON $CLI search landing

3. Sincronización con Odoo — solo si search no devuelve resultados o el usuario pide ver todos los proyectos:

$PYTHON $CLI list-projects --refresh

Paso 3 — Mostrar confirmación antes de crear

SIEMPRE muestra un resumen antes de crear:

┌─ Parte de horas ────────────────────────────────────────────────
│  Descripción : <name>
│  Fecha       : <date>
│  Horas       : <hours>
│  Proyecto    : [<id>] <nombre>
│  Tarea       : [<id>] <nombre>
└─────────────────────────────────────────────────────────────────
¿Crear? [S/n]

Solo crea la entrada tras confirmación explícita del usuario ("s", "sí", "dale", "ok", "créalo", "venga").

Paso 4 — Crear la entrada

Ejecuta:

$PYTHON $CLI create --name "<name>" --date <YYYY-MM-DD> --hours <float> --project <id> --task <id>

Paso 5 — Confirmar creación

El CLI ya muestra:

✓ Entrada creada (ID <id>)
  Ver en Odoo: https://next.edf.global/web#model=account.analytic.line&id=<id>

Comandos del CLI

Acción	Comando
Buscar localmente	$PYTHON $CLI search <keyword> (sin red, instantáneo)
Obtener catálogo	$PYTHON $CLI list-projects
Forzar refresco	$PYTHON $CLI list-projects --refresh
Ver horas de hoy	$PYTHON $CLI list-timesheets --today
Ver horas de un rango	$PYTHON $CLI list-timesheets --from 2026-05-19 --to 2026-05-21
Crear entrada	$PYTHON $CLI create --name "..." --date 2026-05-21 --hours 3.5 --project 152 --task 6404

Ejemplos de uso

Imputar horas:

"hay que imputar desde las 9 hasta ahora (11:30) configurando el CI pipeline" → Fecha: hoy · Horas: 2.5 · Proyecto: [233] PROYECTOS INTERNOS · Tarea: [5422] Configuracion

"Hoy he estado 3h arreglando el admin page de Flashcards" → Fecha: hoy · Horas: 3.0 · Proyecto: [222] Flashcards RoadMap · Tarea: [5049] Admin Refactor

"Ayer, hora y media investigando RAG" → Fecha: ayer · Horas: 1.5 · Proyecto: [233] PROYECTOS INTERNOS · Tarea: [5425] Investigación

Ver entradas:

"¿Cuántas horas llevo hoy?" → $PYTHON $CLI list-timesheets --today "Muéstrame mis partes de esta semana" → $PYTHON $CLI list-timesheets --from <lunes> --to <hoy>

Listar proyectos:

"¿En qué proyectos puedo imputar?" → $PYTHON $CLI list-projects