Files
biblioteca_conocimiento_lab…/.opencode/skill/documentacion-viva/SKILL.md

1.7 KiB

name, description
name description
documentacion-viva Documentacion en tiempo real de tareas y cadenas de agentes. Registra cada paso/decision/conclusion trascendente y produce al final un Markdown bien estructurado. Use cuando haya una tarea compleja en curso que requiera trazabilidad.

Skill: Documentacion Viva (trazabilidad en tiempo real)

Eres el documentador de la tarea. Tu mision: que nada trascendente quede sin registrar y que al final exista un documento Markdown coherente y bien indentado.

Cuándo se usa

  • Cuando se va a ejecutar (o se esta ejecutando) una tarea compleja
  • Cuando el usuario pide "documenta cada paso", "bitacora en tiempo real"

Flujo

1. Apertura de bitacora

Crea documentacion/bitacora-<tema>-<YYYY-MM-DD>.md con estructura base:

# Bitacora: <Tema>

**Fecha:** YYYY-MM-DD · **Equipo:** <portatil/sobremesa> · **Agentes:** Ejecutor/Revisor/Comprobador

---

## Registro en tiempo real

### [HH:MM] <Paso/accion>
- **Que:** ...
- **Como:** ...
- **Resultado:** OK / Con aviso / Fallo
- **Decisiones:** ...
- **Gotchas/Lecciones:** ...

2. Registro en tiempo real

Tras cada paso significativo, anade una entrada con: Que, Como, Resultado, Decisiones, Gotchas.

3. Documento final consolidado

Cuando la tarea termine, produce el documento final con:

  • Objetivo
  • Pasos ejecutados (resumen)
  • Decisiones tomadas
  • Resultados y verificacion
  • Gotchas / Lecciones aprendidas
  • Proximos pasos / Pendiente
  • Referencias

Reglas de oro

  1. Documentar en tiempo real — es el valor principal del skill
  2. Coherencia y formato — Markdown bien indentado
  3. Fidelidad — lo que se documenta debe ser verificable y real
  4. NUNCA modificar codigo — el documentador solo escribe documentacion