O que Vault Crystallize faz?
Esta habilidade é a autoridade comportamental para crystallize e distill em um vault de conhecimento. Os protocolos do vault são contratos de dados:
AGENTS.mddefine limites do espaço de trabalho, tiers de inicialização e propriedade de escrita.global/agent-rules/handoff-protocol.mddefine o formatoHandoff.md.global/agent-rules/llm-wiki-protocol.mddefine o esquema de páginasllm-wiki/, evidências, contradições, integração e verificações de saúde.global/agent-rules/llm-wiki-format.mddefine modelos de página quando presentes.
Não procure uma seção ## Crystallize no protocolo. Se existir em um vault antigo, prefira esta habilidade para o comportamento e use o protocolo apenas para contratos de dados.
Limite
Gatilhos dedicados:
结晶,结晶一下,crystallize-> checkpoint do estado de recuperação e conhecimento estável de longo prazo apenas quando houve alteração.蒸馏,distill-> transformar uma fonte concreta em entradas de evidência citadas e com nível de confiança.
Não use esta habilidade para neat-freak, auditorias profundas, limpeza ampla de documentos, sincronização de memória ou um resumo polido "结晶版" a menos que o usuário peça explicitamente essa tarefa separada. Apenas 收尾, "wrap up", "整理一下" e "sync my notes" não são gatilhos de crystallize.
Agentes que não instalaram esta habilidade são uma preocupação de instalação/atualização, não um motivo para duplicar o comportamento crystallize de volta nos protocolos do vault. Não crie .claude/skills, .agents/skills, junções ou caminhos de instalação por agente a menos que o usuário peça explicitamente por trabalho de instalação.
Wrappers de comando nativos residem em commands/ e commands/<agent>/. Habilidades de alias comuns compartilhadas residem em skills/; não adicione arquivos SKILL.md de alias duplicados em diretórios específicos de plataforma porque o Codex pode descobri-los recursivamente duas vezes. Trate todos eles como adaptadores de invocação explícita; mantenha SKILL.md como a autoridade comportamental ao atualizá-los.
Padrões de Idioma
Escreva o conteúdo de Handoff.md e llm-wiki/ em chinês por padrão. Mantenha identificadores técnicos estáveis em inglês, incluindo código, comandos, nomes de variáveis, caminhos, nomes de API, nomes de pacotes e títulos de fontes quando preservar o título original for importante.
Use outro idioma apenas quando o usuário pedir explicitamente, ao citar material de origem ou quando uma regra de projeto existente for mais específica para aquela unidade.
Comando: crystallize
- Identifique a unidade atual:
- Trabalho sob
projects/<name>/-> esse projeto. - Trabalho sob
research/<name>/-> esse domínio de pesquisa, a menos que um submódulo tenha seu próprioHandoff.md. - Governança do vault ou regras entre vaults ->
Handoff.mdraiz eglobal/llm-wiki/.
- Trabalho sob
- Leia o
Handoff.mdda unidade atual antes de afirmar o estado atual do projeto. Se a unidade não estiver clara, leia oHandoff.mdraiz como índice de projeto ativo; se ainda não estiver claro, faça uma pergunta concisa. - Decida se algo realmente mudou:
- Ponto de recuperação mudou -> atualize o
Handoff.mdda unidade atual. - Conclusão estável que outra thread deve saber a longo prazo -> atualize a página
llm-wiki/correspondente existente. - Nenhuma recuperação ou mudança de longo prazo -> não escreva nada e diga o porquê.
- Ponto de recuperação mudou -> atualize o
- Roteie cada conclusão estável por escopo de reutilização antes de escrever:
- Pergunte: essa conclusão permaneceria verdadeira e útil em um projeto diferente fazendo uma tarefa semelhante amanhã? Sim -> escreva o fato geral para a página
global/llm-wiki/<tópico>.mdcorrespondente e mantenha apenas detalhes de aplicação específicos do projeto mais um ponteiro de wikilink no wiki do projeto. Não tem certeza -> mantenha no nível do projeto (padrão reduzido). - Regra dos dois: se esta sessão usou ou reescreveu uma conclusão que reside no wiki de outro projeto, promova-a para uma página de tópico global agora.
- Leia antes de escrever: leia a página de tópico de destino primeiro e mescle em uma entrada existente do mesmo assunto quando houver uma; nunca anexe às cegas. Crie uma nova página de tópico apenas quando nenhum tópico existente se encaixar e atualize
## Triggersemglobal/llm-wiki/index.mdna mesma passada.
- Pergunte: essa conclusão permaneceria verdadeira e útil em um projeto diferente fazendo uma tarefa semelhante amanhã? Sim -> escreva o fato geral para a página
- Escreva apenas a camada correta:
Handoff.mdrecebe status atual, arquivos ativos, perguntas em aberto, próximas ações e contexto de retomada.llm-wiki/recebe decisões estáveis, métodos, armadilhas, memória, entidade/conceito ou entradas de evidência.log.mdé apenas para operações de conhecimento genuinamente importantes, não para crystallize de rotina.- Memória privada da ferramenta, replay de processo e caches do agente nunca se tornam autoridade do vault.
- Se
Handoff.mdtiver## Tracks, varra todas as tracks ativas antes de finalizar. Preserve tracks não focais a menos que o trabalho as tenha fechado explicitamente. - Execute a lista de verificação de revisão abaixo antes de relatar a conclusão.
Comando: distill
Use apenas quando o usuário disser explicitamente distill, 蒸馏 ou pedir para transformar uma fonte concreta em evidência rastreada.
Entradas:
- Fonte: um caminho de arquivo, texto colado, conteúdo de URL buscado, nota, PDF ou trecho de conversa.
- Unidade alvo: inferir do caminho da fonte ou da tarefa atual; se ambíguo, faça uma pergunta concisa.
- Destino:
llm-wiki/evidence-log.mdda unidade alvo.
Fluxo de trabalho:
- Leia o
Handoff.mdda unidade alvo. - Leia as seções
## Evidence Loge## Pending Contradictionsdeglobal/agent-rules/llm-wiki-protocol.md. - Divida a fonte em blocos numerados
B1,B2,B3, ... na ordem da fonte. Mantenha fontes longas brutas emsources/ounotes/; coloque apenas ponteiros e evidências concisas emllm-wiki/. - Separe evidência de inferência. Afirmações de evidência citam
(src: Bn). Inferências nomeiam os blocos de origem dos quais dependem. - Atribua confiança por conclusão:
high,medium,lowouunverified. - Se novas evidências contradizem
llm-wiki/existente, siga## Pending Contradictions; não sobrescreva silenciosamente.
Formato da entrada de evidência:
### AAAA-MM-DD · <título da fonte>
- **来源:** [[relative/source-or-note]]
- **原文块:**
- B1: <localizador curto da fonte ou resumo do trecho>
- B2: <localizador curto da fonte ou resumo do trecho>
- **证据结论:**
- <afirmação> (src: B1) - confidence: <high|medium|low|unverified>
- **推断:**
- <inferência> (from: B1+B2) - confidence: <high|medium|low|unverified>
- **待验证:** <necessidade específica de verificação, ou `无`>
Lista de Verificação de Revisão
Revisão Handoff:
- Exatamente as seções necessárias de
handoff-protocol.md;## Tracksé opcional apenas para tracks paralelas ativas. - Se
## Tracksexistir, exatamente uma track tem[focus]. ## Last Donetem no máximo 4 entradas, em ordem cronológica reversa, cada uma terminando com uma data.## Next Actionstem no máximo 3 itens de checkbox concretos.## Active Filesexplica por que cada arquivo está ativo agora, não o que o arquivo é.## Decisionscontém um wikilink para[[llm-wiki/decisions]]ou um ID de bloco de decisão, ou dizNone.## Resumediz ao próximo agente o que ler e qual modelo mental manter.
Revisão LLM wiki:
- Páginas novas ou significativamente alteradas têm frontmatter exigido por
llm-wiki-protocol.md. - O tipo de página corresponde ao conteúdo: decisão, método, armadilha, memória, evidência, entidade, conceito, glossário ou log de operação.
- Páginas novas estão vinculadas a partir do
llm-wiki/index.mdlocal. - Afirmações têm confiança; afirmações de evidência apontam para fontes.
- Contradições não resolvidas são registradas no local designado em vez de ocultas.
- Conclusões reutilizáveis entre projetos são roteadas para páginas de tópico
global/llm-wiki/; nenhum fato é duplicado entre camadas (projeto mantém detalhes de aplicação mais um ponteiro). - Cabeçalhos de entrada e conjuntos de campos correspondem ao modelo
llm-wiki-format.mdpara o tipo de página: páginas de afirmação (método/armadilha/tópico) chaveiam por nome de assunto estável, páginas de evento (decisões/evidências/log) chaveiam por data. - Nenhum wikilink com alias aparece dentro de tabelas Markdown.
Revisão de comportamento:
- Não execute ou invoque
neat-freaka menos que explicitamente solicitado. - Não amplie para limpeza de documentos, sincronização de memória ou rotatividade de formatação.
- Não gerencie instalação de habilidade local do agente a menos que explicitamente solicitado.
- Não escreva se nada mudou; relatar "nada mudou" é um resultado válido.
Validação
Quando arquivos foram criados, movidos, renomeados ou o usuário está trocando de thread/agente, execute o conjunto de verificação de saúde somente leitura a partir da raiz do vault:
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 edições apenas de conteúdo, execute a menor verificação relevante e relate o que foi ignorado.
Modos Comuns de Falha
| Falha | Correção |
|---|---|
| "Outros agentes sem a habilidade não farão crystallize." | Instalação/atualização de distribuição resolve isso. Não duplique o comportamento nos protocolos. |
Lê llm-wiki-protocol.md ## Crystallize. | Pare; esta habilidade é a dona do comportamento crystallize. Protocolos definem apenas formatos e verificações de saúde. |
Trata 收尾 ou "cleanup docs" como crystallize. | Não dispare a menos que palavras dedicadas ou intenção explícita de evidência apareçam. |
Escreve logs de processo em llm-wiki/. | Apenas conclusões estáveis pertencem lá. |
| Anexa a listas Handoff desatualizadas. | Reescreva janelas deslizantes dentro dos limites documentados. |
| Anexa uma nova entrada datada a uma página de afirmação (métodos/armadilhas/tópico) em vez de mesclar. | Páginas de afirmação chaveiam por assunto: localize a entrada existente, reescreva-a no lugar, atualize updated / 验证于. |