Captura de Conocimiento
Uso automático
Antes de la respuesta final para cualquier tarea del repositorio, si los archivos cambiaron, las pruebas se ejecutaron o se tomó una decisión/descubrimiento/seguimiento, crea o actualiza exactamente una captura de sesión activa para la sesión/flujo de trabajo actual. Hazlo después de la verificación y antes de solicitar limpieza del backlog o aprobación.
No crees una captura nueva solo porque la habilidad se invoque nuevamente. Si se conoce una ruta de captura activa para este flujo de trabajo, actualiza ese archivo. De lo contrario, lee .ai/raw/active-session.json como un posible puntero activo. Si no existe una captura activa confiable o el flujo de trabajo cambió claramente, crea una nueva captura sin procesar y reemplaza el puntero.
Captura suficientes detalles de la tarea actual para uso posterior. Lee/actualiza solo la captura activa del flujo de trabajo actual; no leas, actualices, dedupliques, combines, sincronices, confirmes, publiques ni promuevas capturas no relacionadas en v0.2.
Una captura no está completa solo porque el asistente escribió un archivo. No dejes "No capturado." en secciones cuyos hechos se conocen, especialmente Solicitud del usuario, Cambios y evidencia, Decisiones y descubrimientos, y Preguntas abiertas y próximos pasos.
Al actualizar una captura activa, escribe la captura completa tal como debería quedar después del paso actual del flujo de trabajo. No agregues solo una nota delta. Usa el contexto de la tarea actual, archivos visibles, diffs, pruebas, resultados de comandos y texto de traspaso como evidencia; si la continuidad no es clara, crea una nueva captura en lugar de inventar contexto faltante.
Mantén la captura alineada con la realidad actual, no con cada pensamiento intermedio. Si una decisión anterior cambió y el trabajo cambió con ella, captura la decisión final/actual y la evidencia. Mantén la decisión reemplazada solo cuando explique código implementado, una reversión, un riesgo no resuelto o una pregunta abierta; omite opciones abandonadas puramente teóricas.
Almacena las capturas como .ai/raw/<carpeta-tipo>/YYYY-MM-DDTHH-mm-ssZ--<tipo>--<slug-tema>.md. Si el nombre de archivo exacto existe, agrega --2, --3, etc., antes de .md.
Tipos: session -> sessions, discussion -> discussions, investigation -> investigations, decision -> decisions, handoff -> handoffs.
Para las capturas de session, mantén .ai/raw/active-session.json como un puntero local a la captura del flujo de trabajo activo. No lo borres después de cada respuesta final; admite reanudación, compactación y traspaso. Reemplázalo cuando comience una nueva captura de flujo de trabajo.
Captura
Trata /capture como crear/actualizar la captura de la sesión actual. Trata /capture <tipo> como ese tipo de captura cuando <tipo> es session, discussion, investigation, decision o handoff.
Antes de la compresión de contexto, compactación o traspaso, captura primero si el trabajo o las decisiones significativas aún no se han capturado.
Si Node está disponible, el asistente sin dependencias puede crear la primera captura, reemplazar la captura activa conocida con --update <ruta> o reemplazar la captura señalada con --update-active. Pasa detalles seccionados enriquecidos a través de --stdin o escribe Markdown directamente. El asistente bloquea las capturas solo de título/resumen de forma predeterminada porque pierden conocimiento útil de la sesión.
node .agents/skills/knowledge-capture/scripts/capture.js --type session --title "arreglo token refresh auth" --summary "Corregido comportamiento de token refresh expirado" --stdin
node .agents/skills/knowledge-capture/scripts/capture.js --type session --title "arreglo token refresh auth" --update .ai/raw/sessions/2026-07-04T18-22-10Z--session--auth-refresh-token-fix.md --stdin
node .agents/skills/knowledge-capture/scripts/capture.js --type session --title "arreglo token refresh auth" --update-active --stdin
Proporciona encabezados Markdown desde references/raw-capture-schema.md en stdin. Si Node o la ejecución de shell no están disponibles, crea o actualiza el Markdown directamente.
Usa este orden para las capturas de sesión activa:
- Si la ruta activa se conoce en el contexto actual, actualiza esa ruta.
- De lo contrario, lee
.ai/raw/active-session.jsoncomo un posible puntero. - Si tanto el puntero como el entorno de ejecución exponen un
agent_session_idy coinciden, actualízalo. - Si el ID de sesión difiere, falta o no está disponible, pero la solicitud del usuario o el traspaso continúa claramente el mismo flujo de trabajo, actualízalo y actualiza el puntero.
- De lo contrario, crea una nueva captura y reemplaza el puntero. Nunca elijas adivinando el nombre de archivo más reciente.
Salvaguardas
- Captura detalles sin procesar útiles, pero evita transcripciones, registros grandes y archivos completos.
- Coloca los archivos modificados, pruebas, comandos y evidencia en
Cambios y evidencia; agrupa los archivos por propósito cuando varios archivos hayan cambiado. - Incluye solo comandos/resultados raros, no obvios o relevantes para la decisión; omite comandos rutinarios que no importen después.
- Reorganiza una captura activa solo para hacerla precisa y útil; no inventes hechos ni mantengas en silencio teoría obsoleta como si todavía fuera cierta.
- Trata
agent_session_idcomo una salvaguarda útil, no la definición de un flujo de trabajo. Una nueva sesión de agente puede continuar el mismo flujo de trabajo. - Usa
--agent-session-idsolo cuando el entorno de ejecución exponga claramente una sesión, conversación, hilo o ID de ejecución actual estable. Si no está disponible, omítelo. Nunca inventes uno. - Excluye secretos, credenciales, claves de API, claves privadas, datos privados del cliente y memoria personal no relacionada.
- Si hay contenido sensible, no crees la captura; primero resume de manera abstracta.
- El estado sin procesar/local solo proviene de la ruta
.ai/raw/y la política de la habilidad, no de los campos de flujo de trabajo por captura. - Trata el asistente de Node como opcional. La creación directa de archivos sigue siendo válida.
Después de guardar, reporta la ruta, el tipo y si se creó o actualizó. Si el asistente bloquea la captura, reporta la advertencia y no guardes el contenido sin procesar.
Referencias
- Lee
references/raw-capture-schema.mdsolo al escribir manualmente o cambiar el esquema. - Lee
references/active-session-example.mdcuando no estés seguro de cómo debería verse una captura de flujo de trabajo actualizada. - Lee
references/agent-portability.mdsolo al adaptar esta habilidad a otro agente.