CommunityEscrita e Ediçãogithub.com

Vault Crystallize

Habilidade para Claude/agente que gerencia checkpoint de progresso em Handoff.md e destila fontes em um registro de evidências citadas e com nível de confiança, dentro de um cofre de conhecimento gerenciado pelo agente.

O que é Vault Crystallize?

O Vault Crystallize é uma habilidade especializada para agentes de IA (como Claude, Cursor, Codex) que implementa os comandos `crystallize` e `distill` em um vault de conhecimento. O objetivo principal é permitir que o agente faça checkpoint do estado de recuperação do trabalho em `Handoff.md` e destile conclusões estáveis de fontes concretas em um registro de evidências citadas e com nível de confiança (`evidence-log.md`), evitando duplicação e mantendo a autoridade do comportamento centralizado no skill. A habilidade define gatilhos dedicados (como 'crystallize', 'distill', '结晶') e delimita claramente seu escopo: não deve ser usada para limpeza geral de documentos, sincronização de memória ou audits profundos, a menos que explicitamente solicitado. Ela suporta roteamento inteligente de conclusões: pergunta se o conhecimento é reutilizável entre projetos e, em caso positivo, promove-o para um tópico global em `global/llm-wiki/`, mantendo apenas detalhes específicos do projeto com um wikilink. A habilidade também inclui checklists de revisão detalhados e validações de saúde do vault (via scripts PowerShell). O conteúdo de saída padrão deve ser em chinês, com identificadores técnicos em inglês. Em suma, é uma ferramenta essencial para equipes que usam agentes de IA para pesquisa e desenvolvimento, garantindo que o conhecimento seja capturado de forma estruturada, rastreável e livre de contradições.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add WIHATN/vault-crystallize

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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.md define limites do espaço de trabalho, tiers de inicialização e propriedade de escrita.
  • global/agent-rules/handoff-protocol.md define o formato Handoff.md.
  • global/agent-rules/llm-wiki-protocol.md define o esquema de páginas llm-wiki/, evidências, contradições, integração e verificações de saúde.
  • global/agent-rules/llm-wiki-format.md define 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

  1. 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óprio Handoff.md.
    • Governança do vault ou regras entre vaults -> Handoff.md raiz e global/llm-wiki/.
  2. Leia o Handoff.md da unidade atual antes de afirmar o estado atual do projeto. Se a unidade não estiver clara, leia o Handoff.md raiz como índice de projeto ativo; se ainda não estiver claro, faça uma pergunta concisa.
  3. Decida se algo realmente mudou:
    • Ponto de recuperação mudou -> atualize o Handoff.md da 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ê.
  4. 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>.md correspondente 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 ## Triggers em global/llm-wiki/index.md na mesma passada.
  5. Escreva apenas a camada correta:
    • Handoff.md recebe 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.
  6. Se Handoff.md tiver ## Tracks, varra todas as tracks ativas antes de finalizar. Preserve tracks não focais a menos que o trabalho as tenha fechado explicitamente.
  7. 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.md da unidade alvo.

Fluxo de trabalho:

  1. Leia o Handoff.md da unidade alvo.
  2. Leia as seções ## Evidence Log e ## Pending Contradictions de global/agent-rules/llm-wiki-protocol.md.
  3. Divida a fonte em blocos numerados B1, B2, B3, ... na ordem da fonte. Mantenha fontes longas brutas em sources/ ou notes/; coloque apenas ponteiros e evidências concisas em llm-wiki/.
  4. Separe evidência de inferência. Afirmações de evidência citam (src: Bn). Inferências nomeiam os blocos de origem dos quais dependem.
  5. Atribua confiança por conclusão: high, medium, low ou unverified.
  6. 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 ## Tracks existir, exatamente uma track tem [focus].
  • ## Last Done tem no máximo 4 entradas, em ordem cronológica reversa, cada uma terminando com uma data.
  • ## Next Actions tem no máximo 3 itens de checkbox concretos.
  • ## Active Files explica por que cada arquivo está ativo agora, não o que o arquivo é.
  • ## Decisions contém um wikilink para [[llm-wiki/decisions]] ou um ID de bloco de decisão, ou diz None.
  • ## Resume diz 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.md local.
  • 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.md para 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-freak a 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

FalhaCorreçã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 / 验证于.

Habilidades Relacionadas