CommunityRedacción y edicióngithub.com

Vault Crystallize

Habilidad para que Claude/agentes registren el progreso en Handoff.md y destilen fuentes en un registro de evidencia citado y con nivel de confianza dentro de un baúl de conocimiento gestionado por el agente.

¿Qué es Vault Crystallize?

Vault Crystallize es una habilidad especializada para agentes de IA (Claude Code, Cursor, Codex, etc.) que establece la autoridad de comportamiento para los comandos `crystallize` y `distill` dentro de un baúl de conocimiento estructurado. El comando `crystallize` guarda el punto de recuperación de la sesión actual y las conclusiones estables a largo plazo solo cuando hay cambios reales, escribiendo en `Handoff.md` (estado del proyecto) y en `llm-wiki/` (conocimiento duradero) en el nivel de granularidad adecuado (proyecto local vs. global). El comando `distill`, activado explícitamente por el usuario, transforma una fuente concreta (archivo, texto, URL, PDF) en entradas de evidencia numeradas y citadas, con niveles de confianza (`high`, `medium`, `low`, `unverified`), separando claramente las afirmaciones de evidencia de las inferencias, y manejando contradicciones pendientes sin sobrescribir silenciosamente. La habilidad incluye listas de verificación de revisión detalladas, modos de fallo comunes con correcciones, y un conjunto de validación de salud de solo lectura. Por defecto, escribe el contenido de `Handoff.md` y `llm-wiki/` en chino, manteniendo los identificadores técnicos estables en inglés, y no debe activarse con frases genéricas como "wrap up" o "整理一下".

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add WIHATN/vault-crystallize

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

¿Qué hace Vault Crystallize?

Esta habilidad es la autoridad de comportamiento para crystallize y distill en un baúl de conocimiento. Los protocolos del baúl son contratos de datos:

  • AGENTS.md define los límites del espacio de trabajo, los niveles de inicio y la propiedad de escritura.
  • global/agent-rules/handoff-protocol.md define el formato de Handoff.md.
  • global/agent-rules/llm-wiki-protocol.md define el esquema de páginas llm-wiki/, evidencia, contradicciones, integración y comprobaciones de salud.
  • global/agent-rules/llm-wiki-format.md define las plantillas de página cuando están presentes.

No busques una sección ## Crystallize en el protocolo. Si existe una en un baúl antiguo, prefiere esta habilidad para el comportamiento y usa el protocolo solo para los contratos de datos.

Límite

Disparadores dedicados:

  • 结晶, 结晶一下, crystallize -> guardar el estado de recuperación y el conocimiento estable a largo plazo solo cuando hayan cambiado.
  • 蒸馏, distill -> convertir una fuente concreta en entradas de evidencia citadas y con nivel de confianza.

No uses esta habilidad para neat-freak, auditorías profundas, limpieza amplia de documentos, sincronización de memoria, o un resumen refinado "结晶版" a menos que el usuario lo solicite explícitamente como una tarea separada. Un simple 收尾, "wrap up", "整理一下" y "sync my notes" no son disparadores de crystallize.

Los agentes que no han instalado esta habilidad son un problema de instalación/actualización, no una razón para duplicar el comportamiento de crystallize de vuelta en los protocolos del baúl. No crees .claude/skills, .agents/skills, enlaces simbólicos o rutas de instalación por agente a menos que el usuario solicite explícitamente trabajo de instalación.

Los envoltorios de comandos nativos viven en commands/ y commands/<agent>/. Las habilidades de alias comunes ordinarias compartidas viven bajo skills/; no agregues archivos SKILL.md de alias duplicados bajo directorios específicos de plataforma porque Codex puede descubrirlos recursivamente dos veces. Trata todos ellos como adaptadores de invocación explícita; mantén SKILL.md como la autoridad de comportamiento al actualizarlos.

Idiomas predeterminados

Escribe el contenido de Handoff.md y llm-wiki/ en chino por defecto. Mantén los identificadores técnicos estables en inglés, incluyendo código, comandos, nombres de variables, rutas, nombres de API, nombres de paquetes y títulos de fuentes cuando sea importante preservar el título original.

Usa otro idioma solo cuando el usuario lo solicite explícitamente, al citar material fuente, o cuando una regla de proyecto existente sea más específica para esa unidad.

Comando: crystallize

  1. Identificar la unidad actual:
    • Trabajo bajo projects/<name>/ -> ese proyecto.
    • Trabajo bajo research/<name>/ -> ese dominio de investigación, a menos que un submódulo tenga su propio Handoff.md.
    • Gobernanza del baúl o reglas entre baúles -> Handoff.md raíz y global/llm-wiki/.
  2. Leer el Handoff.md de la unidad actual antes de afirmar el estado actual del proyecto. Si la unidad no está clara, leer el Handoff.md raíz como el índice del proyecto activo; si aún no está claro, hacer una pregunta concisa.
  3. Decidir si realmente cambió algo:
    • El punto de recuperación cambió -> actualizar el Handoff.md de la unidad actual.
    • Conclusión estable que otro hilo debería conocer a largo plazo -> actualizar la página existente de llm-wiki/ correspondiente.
    • Sin cambio de recuperación o a largo plazo -> no escribir nada y decir por qué.
  4. Enrutar cada conclusión estable por alcance de reutilización antes de escribir:
    • Preguntar: ¿seguiría siendo verdadera y útil esta conclusión en un proyecto diferente que haga una tarea similar mañana? Sí -> escribir el hecho general en la página global/llm-wiki/<topic>.md correspondiente y mantener solo los detalles de aplicación específicos del proyecto más un puntero de wikilink en la wiki del proyecto. No seguro -> mantenerlo a nivel de proyecto (por defecto, hacia abajo).
    • Regla de dos: si esta sesión usó o reescribió una conclusión que vive en la wiki de otro proyecto, promoverla a una página de tema global ahora.
    • Leer antes de escribir: leer la página de tema objetivo primero y fusionar en una entrada existente del mismo tema cuando exista; nunca agregar a ciegas. Crear una nueva página de tema solo cuando ningún tema existente encaje, y actualizar ## Triggers en global/llm-wiki/index.md en la misma pasada.
  5. Escribir solo la capa correcta:
    • Handoff.md obtiene el estado actual, archivos activos, preguntas abiertas, próximas acciones y contexto de reanudación.
    • llm-wiki/ obtiene decisiones estables, métodos, dificultades, memoria, entidades/conceptos o entradas de evidencia.
    • log.md es solo para operaciones de conocimiento genuinamente importantes, no para crystallize rutinario.
    • La memoria privada de la herramienta, la repetición de procesos y los cachés de agente nunca se convierten en autoridad del baúl.
  6. Si Handoff.md tiene ## Tracks, barrer todos los tracks activos antes de finalizar. Preservar los tracks que no son de enfoque a menos que el trabajo los haya cerrado explícitamente.
  7. Ejecutar la lista de verificación de revisión a continuación antes de informar la finalización.

Comando: distill

Usar solo cuando el usuario diga explícitamente distill, 蒸馏, o pida convertir una fuente concreta en evidencia rastreada.

Entradas:

  • Fuente: una ruta de archivo, texto pegado, contenido de URL recuperado, nota, PDF o extracto de conversación.
  • Unidad objetivo: inferir de la ruta de la fuente o la tarea actual; si es ambiguo, hacer una pregunta concisa.
  • Destino: llm-wiki/evidence-log.md de la unidad objetivo.

Flujo de trabajo:

  1. Leer el Handoff.md de la unidad objetivo.
  2. Leer las secciones ## Evidence Log y ## Pending Contradictions de global/agent-rules/llm-wiki-protocol.md.
  3. Dividir la fuente en bloques numerados B1, B2, B3, ... en orden de fuente. Mantener las fuentes largas sin procesar en sources/ o notes/; poner solo punteros y evidencia concisa en llm-wiki/.
  4. Separar la evidencia de la inferencia. Las afirmaciones de evidencia citan (src: Bn). Las inferencias nombran los bloques de fuente de los que dependen.
  5. Asignar confianza por conclusión: high, medium, low o unverified.
  6. Si la nueva evidencia contradice el llm-wiki/ existente, seguir ## Pending Contradictions; no sobrescribir silenciosamente.

Forma de la entrada de evidencia:

### YYYY-MM-DD · <título de la fuente>
- **来源:** [[relative/source-or-note]]
- **原文块:**
  - B1: <localizador corto de fuente o resumen del extracto>
  - B2: <localizador corto de fuente o resumen del extracto>
- **证据结论:**
  - <afirmación> (src: B1) - confidence: <high|medium|low|unverified>
- **推断:**
  - <inferencia> (from: B1+B2) - confidence: <high|medium|low|unverified>
- **待验证:** <necesidad de verificación específica, o `无`>

Lista de verificación de revisión

Revisión de Handoff:

  • Exactamente las secciones requeridas de handoff-protocol.md; ## Tracks es opcional solo para tracks activos en paralelo.
  • Si existe ## Tracks, exactamente un track tiene [focus].
  • ## Last Done tiene como máximo 4 entradas, en orden cronológico inverso, cada una terminando con una fecha.
  • ## Next Actions tiene como máximo 3 elementos de casilla de verificación concretos.
  • ## Active Files explica por qué cada archivo está activo ahora, no qué es el archivo.
  • ## Decisions contiene un wikilink a [[llm-wiki/decisions]] o un ID de bloque de decisión, o dice None.
  • ## Resume le dice al próximo agente qué leer y qué modelo mental mantener.

Revisión de LLM wiki:

  • Las páginas nuevas o significativamente modificadas tienen el frontmatter requerido por llm-wiki-protocol.md.
  • El tipo de página coincide con el contenido: decisión, método, dificultad, memoria, evidencia, entidad, concepto, glosario o registro de operaciones.
  • Las páginas nuevas están enlazadas desde el llm-wiki/index.md local.
  • Las afirmaciones tienen confianza; las afirmaciones de evidencia apuntan a fuentes.
  • Las contradicciones no resueltas se registran en el lugar designado en lugar de ocultarse.
  • Las conclusiones reutilizables entre proyectos se enrutan a las páginas de tema global/llm-wiki/; ningún hecho se duplica entre capas (el proyecto mantiene los detalles de la aplicación más un puntero).
  • Los encabezados de entrada y los conjuntos de campos coinciden con la plantilla llm-wiki-format.md para el tipo de página: las páginas de afirmación (método / dificultad / tema) se indexan por nombre de sujeto estable, las páginas de eventos (decisiones / evidencia / registro) se indexan por fecha.
  • No aparecen wikilinks con alias dentro de las tablas de Markdown.

Revisión de comportamiento:

  • No ejecutar ni invocar neat-freak a menos que se solicite explícitamente.
  • No ampliar a limpieza de documentos, sincronización de memoria o cambio de formato.
  • No gestionar la instalación de habilidades locales del agente a menos que se solicite explícitamente.
  • No escribir si nada cambió; informar "nada cambió" es un resultado válido.

Validación

Cuando se crearon, movieron, renombraron archivos, o el usuario está cambiando de hilos/agentes, ejecutar el conjunto de salud de solo lectura desde la raíz del baúl:

pwsh -NoProfile -File global/tools/vault-health.ps1
pwsh -NoProfile -File global/tools/vault-meta.ps1 -Audit
pwsh -NoProfile -File global/tools/vault-links.ps1

Para ediciones solo de contenido, ejecutar la verificación relevante más pequeña e informar qué se omitió.

Modos de fallo comunes

FallaCorrección
"Otros agentes sin la habilidad no crystallizarán."La instalación/actualización de la distribución soluciona eso. No duplicar el comportamiento en los protocolos.
Lee llm-wiki-protocol.md ## Crystallize.Detenerse; esta habilidad posee el comportamiento de crystallize. Los protocolos definen solo formatos y comprobaciones de salud.
Trata 收尾 o "cleanup docs" como crystallize.No activar a menos que aparezcan palabras dedicadas o intención explícita de evidencia.
Escribe registros de proceso en llm-wiki/.Solo las conclusiones estables pertenecen allí.
Anexa a listas de Handoff desactualizadas.Reescribir ventanas deslizantes dentro de los límites documentados.
Anexa una nueva entrada fechada a una página de afirmación (métodos / dificultades / tema) en lugar de fusionar.Las páginas de afirmación se indexan por tema: localizar la entrada existente, reescribirla en su lugar, actualizar updated / 验证于.

Skills relacionados