Skill memory
✓ VerificadoFornece uma camada de conhecimento durável para que agentes possam pesquisar, armazenar e atualizar convenções de projeto e conhecimentos reutilizáveis verificados.
- Estrelas no GitHub
- 1.663
- Arquivos
- 2
- Último commit
- 9 de nov. de 2026
- Licença
- Apache-2.0
- Ferramentas permitidas
- —
O que a skill memory faz?
memory é uma Agent Skill. Fornece uma camada de conhecimento durável para que agentes possam pesquisar, armazenar e atualizar convenções de projeto e conhecimentos reutilizáveis verificados.
Resumo gerado a partir do SKILL.md da skill.
Sobre a skill memory
Manter uma camada de conhecimento durável para projetos de desenvolvimento é o que este SKILL permite para agentes de IA. Ele permite que agentes pesquisem, armazenem e atualizem convenções de projeto verificadas, correções reutilizáveis e regras de arquitetura para evitar a repetição de erros em diferentes sessões. Desenvolvedores utilizam o memory CLI via npx ai-devkit@latest memory para gerenciar essas informações, garantindo que trabalhos complexos sejam precedidos por uma busca de contexto existente.
Agentes devem carregar esta ferramenta ao encontrarem subsistemas complexos, padrões de erro ou restrições específicas de projeto que exijam persistência de longo prazo. A ferramenta produz entradas de conhecimento estruturadas que podem ser limitadas a um nível global, a um projeto específico ou a um único repositório. Ela depende de um banco de dados local, geralmente localizado em ~/.ai-devkit/memory.db, para manter as informações disponíveis. Diferente de simples transcrições de chat, este sistema impõe um filtro de qualidade para excluir segredos, logs brutos e progresso temporário de tarefas, focando apenas em inteligência verificada e reutilizável.
O que um agente pode fazer com ela
- 1Recuperar convenções de projetoPesquise padrões de codificação estabelecidos ou regras arquiteturais antes de iniciar uma nova tarefa de implementação.
- 2Persistir correções técnicas verificadasArmazene um comando específico ou um padrão de depuração que tenha sido confirmado por resultados de testes ou saída de comandos.
- 3Atualizar conhecimentos obsoletosModifique uma entrada de memória existente quando novas evidências do codebase contradigam a informação armazenada.
- 4Organizar conhecimento por escopoAplique restrições técnicas específicas a um único repositório em vez de todo o ambiente global.
Escrito a partir do SKILL.md da skill. Cada caso de uso é verificado com uma citação dele.
Como instalar a skill memory
Cada comando copia a pasta da skill para o diretório de skills do cliente. Reinicie o cliente ou inicie uma nova sessão para carregá-la.Instalar a skill memory no Claude Code
~/.claude/skills/memory/SKILL.md
$ npx degit codeaholicguy/ai-devkit/skills/memory ~/.claude/skills/memoryInstalar a skill memory no Claude Code (project)
.claude/skills/memory/SKILL.md
$ npx degit codeaholicguy/ai-devkit/skills/memory .claude/skills/memoryInstalar a skill memory no Codex
~/.agents/skills/memory/SKILL.md
$ npx degit codeaholicguy/ai-devkit/skills/memory ~/.agents/skills/memoryInstalar a skill memory no Gemini CLI
~/.gemini/skills/memory/SKILL.md
$ npx degit codeaholicguy/ai-devkit/skills/memory ~/.gemini/skills/memoryInstalar a skill memory no Claude.ai
npx degit codeaholicguy/ai-devkit/skills/memory memory && zip -r memory.zip memory # claude.ai → Customize → Skills → + → Create skill → Upload a skill → memory.zip
Verificações automatizadas
Executado em 15 de nov. de 2026Relatório completo →Passou nas nossas verificações automáticas. Não é uma auditoria de segurança: leia os scripts antes de deixar um agente executá-los. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelcodeaholicguy/ai-devkit/skills/memory is public and reachablegithub.com/codeaholicguy/ai-devkit/tree/HEAD/skills/memory ↗Passou
- Licença de código aberto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Passou
- Commit ou release no último anoLast commit 2026-11-09github.com/codeaholicguy/ai-devkit/commits ↗Passou
- Sem baixar e executar nem roubo de credenciais nos scriptsNo scripts in the skill folderPassou
- Sem instruções ocultas no SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/codeaholicguy/ai-devkit/blob/HEAD/skills/memory/S ↗Passou
- Ferramentas pré-aprovadas são restritasNo pre-approved tools; the agent asks before using onegithub.com/codeaholicguy/ai-devkit/blob/HEAD/skills/memory/S ↗Passou
- O SKILL.md segue o formato Agent Skillsthe description does not say when to use the skillgithub.com/codeaholicguy/ai-devkit/blob/HEAD/skills/memory/S ↗Problema encontrado
SKILL.md
Ver no GitHubAI DevKit Memory CLI
Use npx ai-devkit@latest memory ... as the durable knowledge layer.
Workflow
-
For implementation, debugging, review, planning, or documentation tasks, search before deep work unless the task is trivial:
npx ai-devkit@latest memory search --query "<task, subsystem, error, or convention>" --limit 5For broad or risky tasks, search multiple angles: subsystem, error text, framework, command, and task intent.
-
Use results as context:
- Trust repo files, tests, fresh command output, and explicit user instructions over memory.
- If memory conflicts with verified evidence, use the evidence and update the stale memory.
- Mention memory only when it changes the plan or avoids asking the user again.
-
Search before storing:
npx ai-devkit@latest memory search --query "<knowledge to store>" --table -
Store or update only after the quality gate passes.
Quality Gate
Before storing, all must be true:
- Future sessions are likely to reuse it.
- It is verified by code, docs, tests, command output, or explicit user instruction.
- It is not merely a restatement of obvious nearby files unless it prevents repeated agent mistakes.
- It is scoped narrowly enough.
- Existing memory does not already cover it.
- It contains no secrets, credentials, private customer data, personal data, raw logs, or temporary paths.
Store:
- Project conventions, user preferences, durable decisions.
- Reusable fixes, testing patterns, commands, setup gotchas.
- Non-obvious constraints, architecture rules, failure patterns.
Do not store:
- Task progress, transcripts, speculation, generic programming facts.
- Raw errors without diagnosis.
- Anything the user did not intend to persist.
Commands
Search
npx ai-devkit@latest memory search \
--query "<query>" \
--tags "<tags>" \
--scope "<scope>" \
--limit 5
Use --table to get IDs for updates:
npx ai-devkit@latest memory search --query "<query>" --table
Options: --query/-q required; --tags; --scope/-s; --limit/-l from 1-20; --table.
Store
npx ai-devkit@latest memory store \
--title "<actionable title, 10-100 chars>" \
--content "<context, guidance, evidence, exceptions>" \
--tags "<lowercase,tags>" \
--scope "<global|project:name|repo:org/repo>"
Use this content shape when helpful:
Context: Where this applies.
Guidance: What to do.
Evidence: File, command, test, or user instruction.
Exceptions: When not to apply it.
Update
Find the ID with search --table, then update only changed fields:
npx ai-devkit@latest memory update \
--id "<memory-id>" \
--title "<updated title>" \
--content "<updated content>" \
--tags "<replacement,tags>" \
--scope "<updated scope>"
--tags replaces all existing tags.
Scoping
Use the narrowest useful scope:
repo:<org/repo>for one repository.project:<name>for one app, product, or workspace.globalonly for knowledge that applies across unrelated projects.
If unsure, use a narrower scope.
Troubleshooting
- CLI missing: run
npx ai-devkit@latest --version. - Duplicate title: search, then update the existing item if it is the same knowledge.
- Empty results: broaden terms, remove filters, or search symptoms and subsystem names separately.
- Validation error: check title/content lengths, query length, and
--limitrange. - DB path: default is
~/.ai-devkit/memory.db; project config can override it automatically.
Arquivos desta skill
2Perguntas sobre a skill memory
Como instalo a skill memory no Claude Code?
Execute npx degit codeaholicguy/ai-devkit/skills/memory ~/.claude/skills/memory. O Claude Code carrega skills de ~/.claude/skills (todos os projetos) ou .claude/skills (um projeto) e usa uma skill quando a descrição dela corresponde à tarefa.
Quais clientes podem usar a skill memory?
Qualquer cliente que leia o formato Agent Skills: Claude Code, Codex, Gemini CLI e claude.ai (envie como ZIP). Scripts da skill são executados apenas onde o cliente permite execução de código.
O que devo evitar armazenar no memory CLI?
Não armazene progresso de tarefas, transcrições, especulações, fatos genéricos de programação, erros brutos sem diagnóstico ou quaisquer segredos e credenciais.
Quais são as opções de escopo disponíveis para a memória?
Você pode limitar o conhecimento a um repositório específico usando repo:<org/repo>, a um projeto específico usando project:<name>, ou usar global para conhecimentos que se aplicam a todos os projetos.