CommunityImagemgithub.com

maorfsdev/reflect-yourself

Sistema de autoaprendizagem que captura correções, descobre padrões de workflow e sincroniza aprendizados para skills e regras. Use ao finalizar uma sessão, após correções ou quando o usuário quiser formalizar aprendizados (v1.1.3).

O que é reflect-yourself?

O **reflect-yourself** é um sistema de autoaprendizagem projetado para o editor Cursor (e compatível com outros agentes de IA) que captura correções e insights durante uma sessão de desenvolvimento e os sincroniza automaticamente no local apropriado: skills ou regras. Ele analisa a sessão atual (ou fila pendente), apresenta os aprendizados em formato de resumo e cartões (cards) e solicita aprovação explícita do usuário antes de aplicar qualquer mudança. O sistema suporta diferentes escopos (sessão atual, fila, descoberta de skills) e modos (revisão completa ou rápida). Ele utiliza comandos como `/reflect-yourself` para acionar a revisão e escreve apenas em diretórios seguros `.cursor/skills/`, `.cursor/rules/` e `~/.cursor/skills/`, garantindo que o agente nunca execute código arbitrário. A fila de pendências fica armazenada em `~/.cursor/reflect-queue.json`, evitando poluir repositórios de projeto. O sistema também pode verificar atualizações via npm e perguntar ao usuário se deseja executar `npx reflect-yourself@latest`. É uma ferramenta útil para desenvolvedores que desejam formalizar aprendizados de forma estruturada e segura, transformando correções pontuais em conhecimento reutilizável.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add maorfsdev/reflect-yourself

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

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

Documentação

O que reflect-yourself faz?

Um sistema de autoaprendizagem para o Cursor que captura correções e as sincroniza no local adequado.

Workflow

Quando invocado:

  1. Analisar a sessão (e, opcionalmente, fazer perguntas esclarecedoras se o escopo não estiver claro)
  2. Apresentar os aprendizados para revisão (resumo primeiro, depois cartões; veja o arquivo de comando)
  3. Capturar ação por meio da ferramenta de agente do Cursor Fazer perguntas (message-question) sempre que possível — oferecer Aplicar tudo / Aplicar selecionados / Pular tudo / Parcial / Outro; consulte Documentação do Cursor → Visão geral do agente → Ferramentas
  4. Aplicar somente após aprovação explícita do usuário (via Q&A ou resposta digitada)

Entradas

EntradaPadrãoDescrição
EscopoConversa atual"esta sessão" / "também fila" / "descobrir skills"
ModoRevisão completa"rápido" (aplicar apenas alta confiança) / "completo"

Comandos

Quando o usuário invocar estes comandos, leia o arquivo correspondente em commands/:

ComandoArquivo
/reflect-yourselfcommands/reflect-yourself.md
/reflect-yourself-skillscommands/reflect-yourself-skills.md
/reflect-yourself-queuecommands/reflect-yourself-queue.md
/reflect-yourself-skipcommands/reflect-yourself-skip.md

Início Rápido

  1. Ao final da sessão, execute /reflect-yourself
  2. Revise os aprendizados capturados (resumo + cartões)
  3. Escolha uma ação via prompt ou resposta (aplicar / editar / pular / redirecionar)
  4. Os aprendizados são aplicados às skills/regras após aprovação

Lógica de Posicionamento

  • Skills do Projeto (.cursor/skills/) → Específicas do código
  • Skills Pessoais (~/.cursor/skills/) → Reutilizáveis entre projetos
  • Regras do Projeto (.cursor/rules/) → Padrões de codificação

Localização da Fila

Aprendizados pendentes: ~/.cursor/reflect-queue.json (localização global, nunca polui repositórios de projeto)

Segurança

  • Modelo de confiança: Instale apenas skills de fontes confiáveis. Skills são carregadas no contexto do agente e podem influenciar o comportamento.
  • Higiene de importação: Prefira repositórios oficiais ou conhecidos; inspecione SKILL.md e os arquivos de comando/regras antes de instalar. Cuidado com skills que instruem o agente a executar código arbitrário ou exfiltrar dados.
  • Esta skill: Instrui o agente apenas a escrever em .cursor/skills/, .cursor/rules/ e ~/.cursor/skills/. O instalador copia arquivos apenas; ele não executa o conteúdo da skill. Após a instalação, revise ~/.cursor/skills/reflect-yourself/ se quiser verificar o conteúdo.

Verificação de Atualização

Quando os comandos principais são executados, o agente pode verificar se há uma versão mais recente do npm. Se houver, o usuário pode ser perguntado (Sim/Não) para executar npx reflect-yourself@latest. Consulte os arquivos de comando para detalhes.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas