O que Memória de Personalização faz?
Transforme traços de interação repetidos em preferências duráveis sem fazer o agente principal parar e perguntar ao usuário sobre cada atualização de memória. Este skill é a camada de escrita para "o sistema se torna mais pessoal com o tempo".
Estrutura do Diretório do Skill
<installed-skill-dir>/
├── SKILL.md
├── references/
│ ├── trajectory-scanner.md
│ └── writeback-policy.md
└── templates/
└── preference-ledger.md
Contrato Principal
- Não pergunte ao usuário apenas para decidir se uma preferência rotineira deve ser lembrada.
- Prefira varreduras sidecar de baixo custo para síntese a partir de logs, trajetórias, diffs, saídas sidecar, pacotes de revisão e memória do projeto.
- Nunca copie conversas privadas brutas, logs brutos, credenciais, caminhos apenas locais ou mensagens de colaboradores para a memória pública do repositório.
- Armazene a menor lição reutilizável, não o episódio inteiro.
- Trate a personalização como uma escada de promoção: observação -> candidato -> preferência -> contrato de projeto -> candidato a regra de skill reutilizável.
- Mudanças em skills públicos exigem o mesmo fluxo normal de validação, commit, push e reinstalação que outras alterações de skill.
Quando Usar
Use este skill quando:
- o usuário disser que um fluxo de trabalho deve se tornar personalizado, automático, memorizado ou aprendido a partir de trajetórias
- o agente notar preferências repetidas como "não me pergunte", "commit/push primeiro", "use compilação Overleaf", "prefira capturas de tela/pacotes de página", "use sidecar para varreduras de baixo risco"
- outro skill concluir um trabalho significativo e houver lições reutilizáveis de fluxo de trabalho, escrita, figuras, LaTeX, Git, revisão ou computação
- logs de trajetória do Codex ou Claude Code devem ser varridos em preferências candidatas
- a memória do projeto precisar separar fatos privados do usuário de contratos de projeto compartilhados e regras públicas de skill
Combine com sidecar-task-runner para a varredura de baixo custo e com research-project-memory quando conclusões aceitas em nível de projeto precisarem atualizar memory/.
Carregamento Progressivo
- Leia
references/writeback-policy.mdantes de decidir onde uma preferência pertence. - Leia
references/trajectory-scanner.mdantes de lançar uma varredura sidecar sobre logs, trajetórias, artefatos sidecar ou histórico do repositório. - Use
templates/preference-ledger.mdquando um projeto não tiver um livro de preferências.
Fluxo de Trabalho
- Colete entradas de artefatos. Prefira artefatos sanitizados:
memory/,git diffrecente,.agent/sidecars/*/decision.md,.agent/code-reviews/*/fix-log.md,.agent/layout-issues/*/manifest.md, estado.agent/de artigo/código e preferências explicitamente declaradas pelo usuário no resumo da tarefa atual. - Execute uma varredura de baixo custo quando útil. Use
sidecar-task-runnercom a predefiniçãopersonalization-scannerpara histórico ou varreduras de trajetória não triviais. O scanner produz candidatos; ele não deve editar diretamente a memória. - Classifique cada candidato. Atribua escopo:
private-user,project,public-skill-candidateoudiscard. Atribua tipo:workflow,writing,layout,figure-style,code-review,git,compute,toolchainoucollaboration. - Aplique portas de confiança. Um episódio observado pode se tornar uma lição. Episódios repetidos ou redação explícita do usuário podem se tornar uma preferência. Contratos de projeto precisam de evidências específicas do projeto. Regras públicas de skill precisam de intenção do mantenedor ou evidências repetidas entre projetos.
- Escreva na camada correta. Use o roteamento de
references/writeback-policy.md. Escreva entradas curtas com data, artefato de origem, confiança e escopo alvo. - Relate apenas o resumo útil. Informe ao usuário o que foi lembrado ou quais candidatos foram adiados. Não peça confirmação, a menos que o próximo passo publique política privada ou voltada ao público.
Destinos Padrão
- Preferências privadas do usuário: área de memória privada do agente atual, como
~/.codex/memories/, especialmente para fatos da estação de trabalho, aliases de ferramentas, caminhos locais, estilo de interação preferido e padrões de fluxo de trabalho pessoal. - Preferências de projeto:
memory/,paper/.agent/,code/.agent/ouslides/.agent/, especialmente para contratos compartilhados por todos os agentes no projeto. - Artefatos de varredura local:
.agent/sidecars/<task-id>/ou.agent/personalization/<run-id>/; mantenha-os não rastreados, a menos que sanitizados e intencionalmente commitados. - Regras públicas reutilizáveis de skill:
skills/<skill-name>/SKILL.mdouskills/<skill-name>/references/apenas durante uma tarefa explícita de manutenção de skill.
Registro de Candidato
Use registros concisos:
- Preferência: <um comportamento reutilizável>
- Escopo: private-user | project | public-skill-candidate | discard
- Tipo: workflow | writing | layout | figure-style | code-review | git | compute | toolchain | collaboration
- Evidência: <caminho do artefato ou declaração resumida do usuário>
- Confiança: observed | repeated | user-stated | inferred
- Alvo: <arquivo de memória ou arquivo de skill>
- Ação: write | defer | promote | reject
Regras de Segurança
- Não armazene texto bruto de trajetória privada quando uma regra derivada for suficiente.
- Não promova comentários específicos de colaboradores, transcrições de voz, capturas de tela ou caminhos de arquivos locais para skills públicos.
- Não permita que um sidecar escreva memória pública final sem revisão do agente principal.
- Se um candidato conflitar com memória existente, marque-o como
candidatee deixe uma breve anotação em vez de sobrescrever a regra mais antiga. - Se uma preferência alterasse o comportamento externo, como push, tag, release, submissão de jobs ou publicação de issues, registre a preferência, mas mantenha a barreira humana existente.