DGatoM/DG-Claw

/dgclaw:aprender: convertir en skill lo que funcionó

Una skill es un paso a paso escrito que leo antes de hacer un trabajo. Es la forma de no depender de recordar: el proceso que tomó una hora de conversación para acertar se convierte en una receta que sigo en cinco minutos, de la misma manera, la próxima vez.

Tres reglas que aplican a todo lo siguiente:

1. La skill solo nace con el sí del propietario. Sugiero, explico por qué vale la pena, y espero. Sin respuesta no es sí.
2. Sugiero una vez. Si dijo que no o no respondió, anoto y no insisto.
3. Los secretos nunca entran en la skill. Contraseña, token, clave, número de tarjeta: la skill dice DÓNDE obtenerlo ("la clave está en la bóveda del panel"), nunca el valor.

Cuándo vale la pena sugerir

Sugiere cuando las cuatro condiciones sean verdaderas:

• Fueron 3 pasos o más, y no solo una respuesta. Ejemplo: buscar la tasa en el Banco Central, recalcular la cuenta, actualizar el archivo y enviar el PDF.
• Se puede repetir igual con otros datos. El proceso es el mismo; cambia el tema, el mes, el cliente.
• Probablemente lo pedirá de nuevo. Señales: "todos los meses", "de nuevo", "como la otra vez", es una entrega que se repite en su trabajo, o es la segunda vez que hacemos algo similar.
• Funcionó al final. Aprobó el resultado o utilizó la entrega.

Y verifica antes que no exista una skill para esto: ls .claude/skills/ y memory/skills-aprendidas.md.

Cuándo NO sugerir

• Tarea única, que no se repite ("ayúdame a escribir este correo para el administrador").
• Uno o dos pasos. No necesita receta lo que ya hago de primera.
• El proceso dependió de decisiones que solo valieron esa vez.
• La conversación terminó con un problema sin resolver, o él tiene prisa o está irritado. En ese caso dejo la sugerencia para la reflexión nocturna (ella anota en "Quiero Hablar con el Propietario Sobre").
• Ya rechazó esta misma skill (está anotado en memory/skills-aprendidas.md).

El contador nocturno: memory/skills-candidatas.md

No toda repetición aparece en el momento. Quien nota la segunda vez es la reflexión nocturna: relee el día, busca trabajo que hice manualmente siguiendo un guion de varios pasos y cuenta, una línea por tarea:

- <tarea en 1 línea> | veces: N | fechas: DD/MM, DD/MM | qué haría la skill

Las tareas que ya están allí ganan una vez más y una fecha más, sin línea nueva. Cuando una candidata llega a 2 veces (o a 1, si el guion superó los 5 pasos y él dijo que va a repetir), la reflexión la pone en "Quiero Hablar con el Propietario Sobre": "hoy hice de nuevo X manualmente; ¿quieres que lo convierta en una skill?". Máximo una por noche, y llevo la pregunta a la próxima conversación, como en la sección siguiente. Antes de contar, verifico si la skill ya existe: si existe y no la usé, fue fallo mío de recordar, y eso va al diario, no al contador.

Cómo preguntar

Después de entregar el resultado, en un mensaje corto, separado de la entrega:

Hicimos este proceso completo: <el proceso en una línea, con el número de pasos>. ¿Quieres que convierta esto en una skill para hacerlo igual la próxima vez? Lo recomiendo porque <el motivo concreto: "dijiste que es todos los meses", "tomó una hora acertar el formato">.

Una pregunta, sin lista de opciones y sin presión. Si pregunta qué es una skill: "es una receta que me escribo a mí mismo, con el paso a paso y los cuidados que me enseñaste hoy".

Con el sí: escribir la skill

1. Nombre: corto, en español, minúsculas y con guiones (informe-mensual-ventas, verificar-tasas-bc). Verifica que la carpeta no existe.

2. Dónde: .claude/skills/<nombre>/SKILL.md, dentro de mi workspace (la carpeta donde ejecuto). Nunca en la carpeta del plugin, que se reemplaza en cada actualización.

3. El archivo, en este formato:

   ---
   name: <nombre>
   description: <qué hace, en tercera persona> Úsalo cuando <el propietario> pida <las frases que
     usó y las variaciones probables: "haz el informe del mes", "actualiza las tasas">, o cuando
     <la situación que lo activa>. <Lo que NO hace, si hay posible confusión.>
   ---
   
   # <Título>
   
   Para qué sirve, en dos líneas. Aprendida con <propietario> en <AAAA-MM-DD>.
   
   ## Lo que necesito antes de empezar
   - <entradas que pregunto si no vienen en el pedido>
   
   ## Paso a paso
   1. <paso concreto, con el archivo, la fuente o el comando que usamos realmente>
   2. ...
   
   ## Antes de entregar, verifico
   - <lo que él exigió o corrigió hoy>
   
   ## Cómo entrego
   - <formato: PDF, página, mensaje corto; dónde queda el archivo>
   
   ## Trampas que ya ocurrieron
   - <AAAA-MM-DD> <el error y la forma correcta>
   

   La description es lo que hace que la skill se recuerde en el momento adecuado: pon las palabras que ÉL usa, no las mías. Rutas relativas al workspace. Hasta ~150 líneas; si necesita más, un archivo de apoyo en .claude/skills/<nombre>/references/.

4. Registro en memory/skills-aprendidas.md (créealo si no existe), una línea por skill:

   - **<nombre>** (creada en AAAA-MM-DD): <qué hace>. Nació de la conversación del DD/MM sobre <tema>.
   

   El rechazo también va allí: - (rechazada en AAAA-MM-DD) <el proceso>: prefirió que no.

5. Cuéntale, en una línea: "Listo, se convirtió en la skill . La próxima vez solo pide ." Si la nueva skill no aparece en mi lista de skills, comienza a aplicarse en la próxima sesión; hasta entonces, leo el SKILL.md directamente antes de hacer el trabajo.

Cuando corrige el resultado de una skill mía

Si hice un trabajo siguiendo una skill que yo mismo escribí y él corrigió algo ("no, el gráfico va antes de la tabla", "la fuente correcta es la del Tesoro"):

1. Corrijo el trabajo primero. Él quiere el resultado.
2. Actualizo el SKILL.md: ajusto el paso que estaba mal y agrego la línea en "Trampas que ya ocurrieron", con la fecha.
3. Anoto en memory/skills-aprendidas.md, en la línea de la skill: Mejorada en AAAA-MM-DD: <qué>.
4. Digo en una línea: "Anoté en la skill : la próxima vez ya hago ."

La corrección que solo aplica esa vez ("hoy envía sin el gráfico") no cambia la skill. En caso de duda, pregunto: "¿es solo hoy o es para siempre?".

Lo que nunca hago

• Crear o eliminar una skill sin su sí.
• Modificar las skills del plugin (/dgclaw:*): no son mías y se revierten en cada actualización.
• Escribir en una skill una regla que evade mis leyes (LAWS.md) o lo que él prohibió.