reflect
por alirezarezvanireflect é uma skill de reavaliação no meio da conversa para pausar a execução, reler a partir do objetivo original, verificar viés e desvio de rumo, e decidir se vale continuar, mudar de direção ou pausar. Use reflect para Decision Support, planejamento, loops de depuração e trabalho estratégico quando você precisa de uma checagem franca de sanidade, não de mais um resumo.
Esta skill recebe 84/100, o que a torna uma candidata sólida para usuários do diretório que buscam um fluxo reutilizável de reavaliação no meio da conversa, em vez de um prompt genérico de “pensar melhor”. Ela é fácil de acionar, tem uma disciplina de saída bem definida e inclui referências úteis e scripts de validação, embora a adoção fosse mais simples com instruções explícitas de instalação e exemplos de início rápido mais visíveis.
- Superfície de acionamento muito clara: o frontmatter lista frases explícitas como “reflect,” “take a step back,” “sanity check this,” além de gatilhos implícitos, como conversas longas em modo detalhado ou sinais de travamento.
- O fluxo operacional é específico: pausar a execução, reler a conversa, avaliar perspectiva macro, lacunas, investigação reflexiva, viés e alinhamento, e então concluir com uma recomendação de continuar, mudar de rumo ou pausar.
- Bom material de apoio: três referências focadas definem o cânone dos cinco vieses, a prática de reflexão e a disciplina de saída honesta, enquanto scripts ajudam a detectar padrões de viés, gatilhos de profundidade e qualidade das recomendações.
- Não há comando de instalação nem README no caminho da skill, então usuários do diretório podem precisar seguir o padrão de instalação mais amplo do repositório para adotá-la.
- Os scripts de apoio são explicitamente ferramentas heurísticas baseadas em regex/contagem; eles podem revelar sinais, mas não substituem o julgamento exigido pela skill sobre a conversa completa.
Visão geral da reflect skill
O que o reflect faz
reflect é uma reflect skill para Claude voltada a reavaliar uma conversa em andamento: ela pausa a execução, relê a conversa a partir do objetivo original e entrega um julgamento direto sobre a direção tomada. Em vez de continuar se aprofundando nos detalhes, a reflect skill verifica se o caminho atual ainda faz sentido, quais premissas estão conduzindo a discussão, o que pode estar faltando e se o próximo passo deve ser continuar, mudar de rumo ou pausar.
Ela é especialmente útil para Decision Support, planejamento, trabalho de produto, ciclos de debugging, discussões de estratégia e qualquer troca longa em que o avanço tático possa estar escondendo um desvio estratégico.
Usuários e situações em que faz mais sentido
Instale reflect se você costuma pedir ajuda a um assistente de IA em trabalhos com várias etapas e quer um mecanismo confiável de “checagem de sanidade”. Ela combina com usuários que dizem coisas como “vamos dar um passo para trás”, “estamos deixando algo passar?”, “estamos pensando demais nisso?”, “vamos ampliar a visão” ou “ainda estamos no caminho certo?”.
O melhor caso de uso não é resumo. A função real é correção de direção: identificar viés de confirmação, raciocínio de custo afundado, ancoragem, aumento desnecessário de complexidade ou viés de recência antes que a conversa se comprometa com o caminho errado.
O que torna o reflect diferente
A skill foi desenhada para exigir pouca preparação. Se a conversa anterior já contém contexto suficiente, ela deve rodar imediatamente, em vez de pedir uma configuração longa. Se o contexto for fraco demais, ela faz uma única pergunta esclarecedora essencial, sem transformar a reflexão em mais um exercício de planejamento.
As referências de apoio trazem uma disciplina útil: a reflexão deve reler a conversa a partir do objetivo original, evitar inventar problemas só para parecer rigorosa e terminar com uma recomendação concreta. Os scripts incluídos também ajudam equipes que querem testar transcrições ou validar se as respostas de reflexão são específicas o bastante.
Como usar a reflect skill
Instalação da reflect skill e caminho do repositório
Instale a skill a partir do repositório GitHub com:
npx skills add alirezarezvani/claude-skills --skill reflect
O código-fonte fica em:
productivity/reflect/skills/reflect
Leia SKILL.md primeiro; depois, examine estes arquivos para entender o modelo de funcionamento:
references/cognitive_bias_canon.mdreferences/conversation_reflection_practice.mdreferences/honest_output_discipline.mdscripts/bias_pattern_detector.pyscripts/conversation_depth_analyzer.pyscripts/directional_recommendation_validator.py
Esta é uma skill de raciocínio puro. Ela não exige APIs externas, bancos de dados nem ferramentas específicas de fornecedor além de um ambiente compatível com skills.
Como invocar o reflect na prática
Use uma linguagem direta dentro de uma conversa ativa:
- “Reflect on where we are before we continue.”
- “Take a step back. Are we solving the right problem?”
- “Sanity check this plan for bias and drift.”
- “Are we overthinking this, or is the complexity justified?”
- “Use reflect for Decision Support: should we continue, pivot, or pause?”
Um bom prompt para usar o reflect inclui a pressão de decisão, não apenas o tema. Por exemplo, em vez de “reflect on this”, escreva: “Reflect before we implement. Original goal: reduce onboarding friction. Current path: adding a multi-step configuration wizard. Check whether this is still aligned, what assumptions we are making, and whether we should continue, pivot, or pause.”
Entradas que melhoram a qualidade da resposta
A skill funciona melhor quando a conversa já contém o objetivo original, o plano atual, as restrições e as decisões recentes. Se essas informações estiverem espalhadas, recapitule-as brevemente antes de invocar o reflect.
Um padrão útil de entrada:
- Objetivo original: o que sucesso deveria significar
- Direção atual: para o que a conversa está otimizando agora
- Ponto de decisão: com o que você está prestes a se comprometer
- Restrições: prazos, tolerância a risco, necessidades dos usuários, limites técnicos
- Preocupação: desvio, complexidade, viés, falta de evidência ou bloqueio
Isso ajuda a skill a comparar o caminho atual com o enquadramento inicial, em vez de apenas reagir às últimas interações.
Fluxo opcional com apoio de scripts
Os scripts não são obrigatórios, mas são úteis para revisões repetíveis. Salve uma transcrição como texto simples com turnos User: e Assistant:; depois execute:
python scripts/conversation_depth_analyzer.py --conversation /tmp/transcript.txt
Use bias_pattern_detector.py para sinalizar possíveis padrões de viés e, em seguida, deixe a IA aplicar julgamento em vez de tratar ocorrências de regex como prova. Depois de gerar uma reflexão, directional_recommendation_validator.py pode verificar se a resposta termina com uma recomendação específica de continuar, mudar de rumo ou pausar, e se evita reafirmações vagas.
FAQ da reflect skill
O reflect é só um prompt de resumo melhor?
Não. Um resumo comprime o que aconteceu; o reflect julga se a conversa ainda está mirando o resultado certo. A reflect skill deve revelar desvios, evidências ausentes, soluções superdimensionadas, restrições negligenciadas ou impulso injustificado. Se tudo estiver realmente sólido, ela deve dizer isso com evidências, em vez de fabricar objeções.
Quando não devo usar o reflect?
Não use para tarefas simples e pontuais, consultas factuais ou momentos em que não há contexto anterior significativo para reavaliar. Também não é uma boa escolha quando você quer apenas incentivo ou feedback de estilo. A skill foi criada para interromper o impulso da conversa, algo valioso em trabalhos complexos, mas desnecessário para tarefas triviais.
O reflect é amigável para iniciantes?
Sim, porque a invocação pode ser tão simples quanto “reflect” ou “take a step back.” Iniciantes se beneficiam do design de baixa fricção da skill, enquanto usuários avançados conseguem resultados melhores ao fornecer o objetivo original, a decisão atual e o possível modo de falha.
Como o reflect para Decision Support ajuda equipes?
Em Decision Support, o reflect cria uma pausa estruturada antes do comprometimento. Ele é útil antes de escolher uma direção de produto, finalizar um desenho técnico, continuar por um caminho de debugging ou aceitar uma recomendação. Seu valor é maior quando o custo de seguir na direção errada é mais alto do que o custo de pausar para reavaliar.
Como melhorar a reflect skill
Dê ao reflect uma decisão bem delimitada
O resultado fraco mais comum vem de uma invocação vaga. “Reflect on our discussion” pode funcionar, mas “Reflect before we choose option B; check for anchoring, missing counterevidence, and whether we should continue, pivot, or pause” dá à skill um alvo mais claro.
Se você se preocupa com um risco específico, diga qual é. Por exemplo: “I’m worried we are adding features because each one sounds reasonable individually. Check for complexity bias.”
Exija reavaliação baseada em evidências
Uma boa resposta do reflect deve citar evidências concretas da conversa: o objetivo original, o ponto em que o enquadramento mudou, a premissa que passou a dominar ou a decisão que precisa ser validada. Se a resposta parecer genérica, peça: “Redo the reflection using specific evidence from earlier turns and end with a concrete recommendation.”
Isso está alinhado à disciplina de honest-output do repositório: nada de pessimismo vago, nada de tranquilização vaga e nada de problemas inventados.
Fique atento a modos comuns de falha
Falhas comuns do reflect incluem focar apenas nas interações mais recentes, resumir em vez de julgar, encontrar problemas sem evidência ou terminar sem um próximo passo claro. Outra falha é perguntar demais: a skill só deve pedir esclarecimento quando a conversa estiver superficial demais para ser reavaliada.
Você pode corrigir isso dizendo: “Reread from the original goal, not just the recent implementation details. Identify the strongest reason to continue and the strongest reason to pivot.”
Itere depois da primeira recomendação
Trate a primeira reflexão como um ponto de checagem de decisão, não como o fim do trabalho. Se a recomendação for “continue”, pergunte que evidência mudaria essa avaliação. Se for “pivot”, peça a menor mudança de rumo viável. Se for “pause”, pergunte exatamente qual informação ausente precisa ser resolvida antes de continuar.
Isso mantém o reflect prático: o objetivo não é gerar mais análise, e sim escolher uma próxima ação melhor.