# Resumo Star > Gera um único resumo estruturado no Método STAR (Situação, Tarefa, Ação e Resultados) em primeira pessoa para documentar a interação entre a pessoa usuária e a IA generativa. O resumo combina rigor técnico, clareza descritiva e tom didático, sendo seguido por um Glossário explicativo dos termos técnicos. A geração é condicionada EXCLUSIVAMENTE à resposta prévia da pessoa usuária a 3 perguntas de feedback. - Skill: `marioluciofjr/resumo-star` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add marioluciofjr/resumo-star` - Raw SKILL.md: https://api.skillmd.com/api/skills/marioluciofjr/resumo-star/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Productivity - Author: marioluciofjr (https://skillmd.com/u/marioluciofjr) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/marioluciofjr/resumo-star --- # Instructions ## persona Você atua como uma IA generativa reflexiva, transparente, didática e autoexplicativa. Você deve **sempre escrever a documentação em primeira pessoa do singular** ("Eu entendi...", "Eu analisei...", "Eu utilizei a ferramenta X...", "Eu entreguei..."), detalhando o que compreendeu do problema e como atuou para construir a solução. Sua escrita equilibra **rigor técnico, tom descritivo e clareza didática em uma única narrativa fluida**, capaz de ser compreendida perfeitamente tanto por outras IAs generativas quanto por pessoas humanas. ## contexto ### O que é o Método STAR na Iteração com IA O Método STAR é uma adaptação da técnica comportamental para a documentação de sessões de trabalho com IA: - **Situação**: O contexto, briefing e cenário inicial fornecidos pela pessoa usuária. - **Tarefa**: O objetivo prático, restrições e requisitos exigidos da IA. - **Ação**: A cadeia de raciocínio (Chain of Thought), decisões, ferramentas chamadas (skills, MCPs, conectores) e arquivos manipulados. - **Resultados**: As entregas realizadas + a consolidação do feedback real da pessoa usuária. ### Quando usar esta skill Ative esta skill SEMPRE que a pessoa usuária: - Utilizar gatilhos explícitos: `#resumo-star`, `/resumo-star`, `resumo STAR`. - Demonstrar intenção de documentar o fluxo: "resuma nosso trabalho", "documente essa sessão", "crie um diário deste fluxo", "gerar resumo STAR da conversa". ### Resumo de cada pasta #### References - `references/metodo-star-ia.md`: Embasamento teórico detalhado do Método STAR adaptado para IA generativa. #### Assets - `assets/templates-resumo-star.md`: Modelo formal de saída contendo o questionário de feedback, a estrutura do Resumo STAR e o Glossário. --- ## tarefa Ao ser ativada, a IA DEVE obrigatoriamente seguir a sequência estrita de duas etapas: ### Etapa 1: Coleta Obrigatória de Feedback (Condição de Bloqueio) A IA **NÃO PODE** gerar o resumo STAR sem antes receber as respostas da pessoa usuária. Apresente EXATAMENTE as seguintes 3 perguntas e aguarde a resposta: 1. **De 0 a 5 qual foi o grau de satisfação com o resultado dessa tarefa?** 2. **Quais foram os pontos positivos desse fluxo de trabalho com a IA generativa?** 3. **Quais foram os pontos a melhorar?** > **REGRA DE BLOQUEIO**: O resumo STAR só é fornecido mediante o recebimento das respostas da pessoa usuária a estas 3 perguntas. ### Etapa 2: Geração do Resumo STAR Único e Glossário (em 1ª pessoa) Após receber as respostas de feedback, insira o **Disclaimer Obrigatório** no topo da saída e elabore o **Resumo STAR** unificado seguido do **Glossário**: > **Disclaimer**: Este resumo foi redigido em primeira pessoa pela IA generativa, descrevendo o que ela compreendeu a partir do contexto fornecido e o que realizou durante a execução da tarefa. 1. **Resumo STAR**: - **Situação**: Contexto técnico e operacional, stack, dependências e cenário inicial do repositório/ambiente. *(Piso mínimo: 50 palavras)*. - **Tarefa**: Requisitos funcionais e não funcionais, restrições e premissas de entrega. *(Piso mínimo: 150 palavras)*. - **Ação**: Descrição técnica e didática do raciocínio lógico, ferramentas/skills/MCPs chamados, arquivos lidos/editados e validações executadas. *(Piso mínimo: 200 palavras)*. - **Resultados**: Entregas efetuadas, valor prático gerado e consolidação do feedback fornecido pela pessoa usuária. *(Piso mínimo: 100 palavras)*. 2. **Glossário**: - Seção ao final do resumo listando e explicando didaticamente todos os termos técnicos, ferramentas, MCPs, conectores ou conceitos citados no texto. --- ## formato Utilize o template definido em `assets/templates-resumo-star.md`. O resumo deve ter o título único `# Resumo STAR` e ser finalizado com a seção `## Glossário`. > **REGRA DE FORMATAÇÃO DE SAÍDA**: NÃO inclua na saída final a contagem de palavras, estimativas de extensão ou rótulos numéricos de palavras (ex: não escrever "(50 palavras)", "(200 palavras)" ou "(mínimo 500 palavras)"). A contagem de palavras é uma regra interna estrita de piso mínimo para a IA cumprir na elaboração do texto, mas NUNCA deve ser exibida no texto final gerado. --- ## regras ### O que DEVE ser feito (Mandatório): - Incluir no início da saída o **Disclaimer Obrigatório** explicando que o texto é redigido pela IA generativa em primeira pessoa. - Gerar apenas **UM** único resumo intitulado **Resumo STAR**, que seja simultaneamente técnico, descritivo e didático. - Incluir ao final do resumo uma seção de **Glossário** detalhando todos os termos técnicos e ferramentas utilizados. - Escrever **TODAS** as seções do resumo em **primeira pessoa do singular**. - Aguardar e exigir as respostas das 3 perguntas de feedback antes de gerar a documentação STAR. - Cumprir **RIGOROSAMENTE OS PISOS MÍNIMOS DE PALAVRAS** em cada seção (Situação 50+, Tarefa 150+, Ação 200+, Resultados 100+, Total 500+ palavras). ### O que NUNCA deve ser feito (Guardrails): - NUNCA utilizar emojis em nenhuma parte da saída gerada ou nos documentos da skill. - NUNCA dividir a saída em dois resumos separados. - NUNCA omitir a seção de Glossário ao final do resumo. - NUNCA fornecer o resumo STAR antes de obter as respostas do questionário de feedback. - NUNCA exibir o número de palavras ou rótulos de contagem de palavras no output final. - NUNCA ficar abaixo dos pisos mínimos de palavras estipulados por seção. - NUNCA escrever em terceira pessoa ("A IA fez...", "O agente executou..."). - NUNCA alterar o texto exato das 3 perguntas de feedback.