¿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.mddefine los límites del espacio de trabajo, los niveles de inicio y la propiedad de escritura.global/agent-rules/handoff-protocol.mddefine el formato deHandoff.md.global/agent-rules/llm-wiki-protocol.mddefine el esquema de páginasllm-wiki/, evidencia, contradicciones, integración y comprobaciones de salud.global/agent-rules/llm-wiki-format.mddefine 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
- 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 propioHandoff.md. - Gobernanza del baúl o reglas entre baúles ->
Handoff.mdraíz yglobal/llm-wiki/.
- Trabajo bajo
- Leer el
Handoff.mdde la unidad actual antes de afirmar el estado actual del proyecto. Si la unidad no está clara, leer elHandoff.mdraíz como el índice del proyecto activo; si aún no está claro, hacer una pregunta concisa. - Decidir si realmente cambió algo:
- El punto de recuperación cambió -> actualizar el
Handoff.mdde 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é.
- El punto de recuperación cambió -> actualizar el
- 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>.mdcorrespondiente 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
## Triggersenglobal/llm-wiki/index.mden la misma pasada.
- 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
- Escribir solo la capa correcta:
Handoff.mdobtiene 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.mdes 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.
- Si
Handoff.mdtiene## 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. - 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.mdde la unidad objetivo.
Flujo de trabajo:
- Leer el
Handoff.mdde la unidad objetivo. - Leer las secciones
## Evidence Logy## Pending Contradictionsdeglobal/agent-rules/llm-wiki-protocol.md. - Dividir la fuente en bloques numerados
B1,B2,B3, ... en orden de fuente. Mantener las fuentes largas sin procesar ensources/onotes/; poner solo punteros y evidencia concisa enllm-wiki/. - Separar la evidencia de la inferencia. Las afirmaciones de evidencia citan
(src: Bn). Las inferencias nombran los bloques de fuente de los que dependen. - Asignar confianza por conclusión:
high,medium,lowounverified. - 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;## Trackses opcional solo para tracks activos en paralelo. - Si existe
## Tracks, exactamente un track tiene[focus]. ## Last Donetiene como máximo 4 entradas, en orden cronológico inverso, cada una terminando con una fecha.## Next Actionstiene como máximo 3 elementos de casilla de verificación concretos.## Active Filesexplica por qué cada archivo está activo ahora, no qué es el archivo.## Decisionscontiene un wikilink a[[llm-wiki/decisions]]o un ID de bloque de decisión, o diceNone.## Resumele 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.mdlocal. - 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.mdpara 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-freaka 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
| Falla | Correcció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 / 验证于. |