CommunityRedacción y edicióngithub.com

kricha/knowledge-capture

Habilidad de agente para guardar capturas de conocimiento locales del repositorio.

¿Qué es knowledge-capture?

Knowledge Capture es una habilidad para agentes de IA (como Claude Code, Cursor o Codex) diseñada para preservar el contexto de trabajo dentro de un repositorio local. Su función principal es crear o actualizar automáticamente una captura de sesión activa al finalizar una tarea, registrando cambios, decisiones y próximos pasos. Esto evita la pérdida de información entre interacciones y facilita la reanudación o transferencia del trabajo. Soporta tipos como `session`, `discussion`, `investigation`, `decision` y `handoff`, y utiliza un helper opcional en Node.js para generar archivos markdown estructurados. La habilidad prioriza la precisión: actualiza la captura existente si la sesión continúa, o crea una nueva si el flujo de trabajo cambia, manteniendo siempre un puntero local (`active-session.json`) para seguimiento. Es útil para equipos de desarrollo que necesitan persistir decisiones técnicas, resultados de pruebas y cambios de código sin depender de memoria de contexto limitada.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add kricha/knowledge-capture

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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:

  1. Si la ruta activa se conoce en el contexto actual, actualiza esa ruta.
  2. De lo contrario, lee .ai/raw/active-session.json como un posible puntero.
  3. Si tanto el puntero como el entorno de ejecución exponen un agent_session_id y coinciden, actualízalo.
  4. 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.
  5. 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_id como 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-id solo 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.md solo al escribir manualmente o cambiar el esquema.
  • Lee references/active-session-example.md cuando no estés seguro de cómo debería verse una captura de flujo de trabajo actualizada.
  • Lee references/agent-portability.md solo al adaptar esta habilidad a otro agente.

Skills relacionados