RafaelFerSilva/refinement-agent-skills

Transforma transcrições de reuniões em atas auditáveis: decisões e itens de ação com proveniência, acordos presumidos para confirmação assíncrona, itens de ação em JSON e entrada para descoberta.

O que é refinement-agent-skills?

Esta skill transforma transcrições de reuniões em atas estruturadas e auditáveis, garantindo que cada decisão e item de ação seja rastreável à transcrição original. É útil para equipes que precisam de registros precisos e defensáveis, onde suposições são claramente separadas de fatos explícitos. A skill suporta plataformas como Claude Code, Cursor e Codex, e segue regras rígidas de proveniência, usando marcadores como `[DITO]`, `[PRESUMIDO]` e `[A DEFINIR]`. O fluxo de trabalho inclui etapas como metadados, triagem de qualidade da transcrição, extração de decisões com base em regras, escrita de atas seguindo um modelo, auto-auditoria e roteamento de itens abertos para questionários e entradas de descoberta.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/RafaelFerSilva/refinement-agent-skills/tree/HEAD/skills/meeting-minutes

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Atas de reunião

Processe uma transcrição e gere um registro estruturado e auditável. As atas tornam-se fatos: três semanas depois, alguém citará este documento como prova do que foi acordado. Portanto, tudo que você registrar deve ser rastreável até a transcrição, e tudo que você presumir deve permanecer visivelmente separado do que foi explicitamente dito. Registrar é certificar; sua análise nunca deve se disfarçar de fala dos participantes.

Este fluxo de trabalho é síntese sem entrevista: a reunião já ocorreu. Perguntas em aberto são direcionadas aos seus destinatários por meio de questionários, e o conteúdo de requisitos flui para /requirements-discovery.

Transcrição: $ARGUMENTS

Limite de proveniência

Baseado em requirements-rigor, aqui a proveniência assume três formas:

  • [DITO: falante, "paráfrase curta"]: dito na transcrição. Toda ação, decisão e prioridade carrega quem a disse e uma paráfrase de 5 a 15 palavras. Uma paráfrase honesta é suficiente para auditoria.
  • [PRESUMIDO: base]: sua análise inferiu a partir de padrões de conversa: silêncio após uma proposta, "ok" ambíguo, tarefa implícita por uma decisão que ninguém assumiu explicitamente. Itens presumidos nunca entram em Decisões, Tabela de Itens de Ação ou JSON; eles vivem em seções de presunção, com o trecho e quem deve confirmar.
  • [A DEFINIR]: responsável ou prazo não mencionados nem inferíveis. O placeholder é a resposta correta.

Teste rápido: "se um participante ler esta linha e disser 'nunca disse isso', posso apontar para o trecho?" Sim: DITO. "Eles não disseram diretamente, mas deram a entender": PRESUMIDO. Nenhum dos dois: A DEFINIR, ou excluído da ata. Marcadores restantes de requirements-rigor, como [INFERÊNCIA: base], permanecem válidos.

Etapas

  1. Metadados. Leia docs/agents/refinement.md no workspace para identificar o idioma configurado (en-US ou pt-BR, padrão en-US) e o caminho de publicação. As atas, questionários e entradas geradas seguem este idioma. Identifique título, data, duração, participantes com funções, projeto e termos do glossário distorcidos pela transcrição automática. A data é obrigatória: a aritmética de prazos depende dela. Se faltar, pergunte em uma única linha antes de prosseguir. Leia CONTEXT.md para termos do glossário quando presente. Concluído quando: data e participantes estão estabelecidos.

  2. Triagem. INTACTA (áudio contínuo, falantes identificáveis), DEGRADADA (segmentos inaudíveis, falantes mal atribuídos, cortes), INSUFICIENTE (muito curta, ou não é a reunião dos metadados). INSUFICIENTE: indique o motivo e pare; atas de fachada não devem circular como registros oficiais. DEGRADADA: cada lacuna que possa ter contido uma ação ou decisão torna-se uma pergunta em aberto ("segmento inaudível por volta de 12min após proposta de X"); lacunas nunca são reconstruídas. Terminologia distorcida: aplique a grafia do glossário e marque [POSSÍVEL ERRO DE TRANSCRIÇÃO: original -> adotado] na seção 0, usando apenas o termo adotado no corpo do texto. Detalhes pessoais, saúde, família, comentários sobre colegas ausentes: omitir de todas as seções; um compromisso de projeto inserido em contexto pessoal é registrado sem a circunstância. Falante não identificado com compromisso: responsável [A DEFINIR: falante não identificado por volta de Xmin] e pergunta em aberto. Uma nota de que conteúdo pessoal foi omitido pode aparecer na triagem sem detalhes; prazos mencionados apenas dentro de contexto pessoal são mantidos textualmente sem a circunstância pessoal. Concluído quando: a triagem é registrada na seção 0 com os erros de transcrição detectados.

  3. Extrair. Aplique as regras de RULES.md: retratação e substituição, granularidade de itens de ação, prioridade com proveniência, o que conta como decisão. Concluído quando: toda decisão e item de ação carrega proveniência DITO, e presunções vivem estritamente nas seções 4 ou 5.

  4. Escrever atas seguindo TEMPLATE.md. No "modo ações", escreva apenas as seções 3, 6 e 7. Concluído quando: o arquivo existe em .scratch/<projeto>-<YYYY-MM-DD>/minutes.md (ou onde configurado em docs/agents/refinement.md), com aviso final.

  5. Auto-auditoria e relatório em uma única linha na seção 8: toda ação real na tabela tem um objeto JSON correspondente e nenhum objeto JSON existe fora da tabela; toda linha e decisão carrega DITO; nenhum PRESUMIDO vazou para a tabela ou decisões; prioridades correspondem entre tabela e JSON; datas JSON são ISO ou nulas. Concluído quando: a seção 8 indica "Auto-Auditoria: OK" ou detalha correções.

  6. Roteie itens em aberto. Acordos presumidos e perguntas em aberto com destinatários fora da sessão: escreva um questionário por destinatário seguindo QUESTIONNAIRE.md em requirements-rigor, junto com as atas, e vincule cada um à seção geradora. Trechos com conteúdo de requisitos (necessidades declaradas, capacidades, restrições): escreva discovery-input.md junto com as atas seguindo o template no final de TEMPLATE.md, e instrua o usuário que /requirements-discovery começa a partir dele. Concluído quando: cada acordo presumido tem um destinatário e questionário, e a entrada de descoberta existe quando a reunião continha conteúdo de requisitos.

Aviso final

⚠️ Estas atas são um rascunho gerado por IA a partir de uma transcrição. Elas exigem validação dos participantes antes de circular como registro oficial, particularmente os Acordos Presumidos, que não foram explicitamente verbalizados e requerem confirmação.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas