RafaelFerSilva/refinement-agent-skills

Transforma una transcripción de reunión en actas auditables: decisiones y elementos de acción con procedencia, acuerdos presuntos para confirmación asíncrona, elementos de acción en JSON y entrada de descubrimiento.

¿Qué es refinement-agent-skills?

Esta habilidad para agentes de IA toma una transcripción de reunión y la convierte en actas estructuradas, auditables y accionables. Es útil para equipos de desarrollo de software que necesitan un registro formal y rastreable de lo discutido, asegurando que cada decisión y elemento de acción esté vinculado a quién lo dijo y en qué momento. Soporta plataformas como Claude Code, Cursor y Codex, y se integra con un flujo de trabajo de refinamiento de requisitos. La habilidad distingue rigurosamente entre lo que se dijo explícitamente (STATED), lo que se infirió del contexto (ASSUMED) y lo que queda pendiente de definir (TO BE DEFINED), generando actas en formato markdown, elementos de acción en JSON, cuestionarios para confirmación asíncrona y un archivo de entrada para descubrimiento de requisitos. El proceso incluye metadatos, triaje de la calidad de la transcripción, extracción de decisiones y tareas, redacción de actas, auto-auditoría y enrutamiento de elementos abiertos.

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

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Minutas de reunión

Procesa una transcripción y genera un registro estructurado y auditable. Las minutas se convierten en hechos: tres semanas después alguien citará este documento como prueba de lo que se acordó. Por lo tanto, todo lo que registres debe ser rastreable hasta la transcripción, y todo lo que presumas debe permanecer visiblemente separado de lo que se declaró explícitamente. Registrar es certificar; tu análisis nunca debe disfrazarse como discurso de los asistentes.

Este flujo de trabajo es síntesis sin entrevista: la reunión ya ocurrió. Las preguntas abiertas se dirigen a sus destinatarios mediante cuestionarios, y el contenido de requisitos fluye hacia /requirements-discovery.

Transcripción: $ARGUMENTS

Límite de procedencia

Basado en requirements-rigor, aquí la procedencia asume tres formas:

  • [STATED: hablante, "paráfrasis corta"] (pt-BR: [DITO: falante, "paráfrase curta"]): declarado en la transcripción. Cada acción, decisión y prioridad lleva quién lo declaró y una paráfrasis de 5 a 15 palabras. Una paráfrasis honesta es suficiente para auditoría.
  • [ASSUMED: base] (pt-BR: [PRESUMIDO: base]): tu análisis infirió a partir de patrones de conversación: silencio después de una propuesta, "ok" ambiguo, tarea implícita en una decisión que nadie asumió explícitamente. Los elementos presuntos nunca entran en Decisiones, Tabla de Elementos de Acción o JSON; viven en secciones de presunción, con el extracto y quién debe confirmar.
  • [TO BE DEFINED] (pt-BR: [A DEFINIR]): responsable o fecha límite ni mencionados ni inferibles. El marcador de posición es la respuesta correcta.

Prueba rápida: "si un asistente lee esta línea y dice 'yo nunca dije eso', ¿puedo señalar el extracto?" Sí: STATED. "No lo dijeron directamente, pero lo implicaron": ASSUMED. Ninguno: TO BE DEFINED, o excluido de las minutas. Los marcadores restantes de requirements-rigor, como [INFERENCE: base], siguen siendo válidos.

Pasos

  1. Metadatos. Lee docs/agents/refinement.md en el espacio de trabajo para identificar el idioma configurado (en-US o pt-BR, predeterminado en-US) y la ruta de publicación. Las minutas, cuestionarios y entradas generadas siguen este idioma. Identifica título, fecha, duración, asistentes con roles, proyecto y términos del glosario distorsionados por la transcripción automática. La fecha es obligatoria: la aritmética de plazos depende de ella. Si falta, pregunta en una sola línea antes de continuar. Lee CONTEXT.md para términos del glosario cuando esté presente. Completado cuando: la fecha y los asistentes están establecidos.

  2. Triaje. INTACTA (audio continuo, hablantes identificables), DEGRADADA (segmentos inaudibles, hablantes mal asignados, cortes), INSUFICIENTE (demasiado breve, o no es la reunión de los metadatos). INSUFICIENTE: indica la razón y detente; las minutas falsas no deben circular como registros oficiales. DEGRADADA: cada vacío que podría haber contenido una acción o decisión se convierte en una pregunta abierta ("segmento inaudible aproximadamente a los ~12min después de una propuesta de X"); los vacíos nunca se reconstruyen. Terminología distorsionada: aplica la ortografía del glosario y marca [POSIBLE ERROR DE TRANSCRIPCIÓN: original -> adoptado] en la sección 0, usando solo el término adoptado en todo el cuerpo. Detalles personales, salud, familia, comentarios sobre colegas ausentes: omite de todas las secciones; un compromiso del proyecto incrustado en un contexto personal se registra sin la circunstancia. Hablante no identificado con compromiso: responsable [TO BE DEFINED: hablante no identificado aproximadamente a los ~Xmin] y pregunta abierta. Puede aparecer una nota de que se omitió contenido personal en el triaje sin detalles; los plazos mencionados solo dentro de un contexto personal se mantienen textualmente sin la circunstancia personal. Completado cuando: el triaje está registrado en la sección 0 con los errores de transcripción detectados.

  3. Extrae. Aplica las reglas de RULES.md: retractación y superposición, granularidad de los elementos de acción, prioridad con procedencia, qué cuenta como decisión. Completado cuando: cada decisión y elemento de acción lleva procedencia STATED, y las presunciones viven estrictamente en las secciones 4 o 5.

  4. Escribe las minutas siguiendo TEMPLATE.md. En "modo acciones", escribe solo las secciones 3, 6 y 7. Completado cuando: el archivo existe en .scratch/<proyecto>-<AAAA-MM-DD>/minutes.md (o donde esté configurado en docs/agents/refinement.md), con el descargo de responsabilidad final.

  5. Auto-auditoría e informa en una sola línea en la sección 8: cada acción real en la tabla tiene un objeto JSON coincidente y no existe ningún objeto JSON fuera de la tabla; cada fila y decisión lleva STATED; ningún ASSUMED se filtró a la tabla o decisiones; las prioridades coinciden entre la tabla y JSON; las fechas JSON son ISO o nulas. Completado cuando: la sección 8 indica "Self-Audit: OK" o detalla correcciones.

  6. Enruta elementos abiertos. Acuerdos presuntos y preguntas abiertas con destinatarios fuera de la sesión: escribe un cuestionario por destinatario siguiendo QUESTIONNAIRE.md en requirements-rigor, junto a las minutas, y enlaza cada uno desde la sección que lo generó. Extractos con contenido de requisitos (necesidades, capacidades, restricciones declaradas): escribe discovery-input.md junto a las minutas siguiendo la plantilla al final de TEMPLATE.md, e instruye al usuario que /requirements-discovery comienza a partir de él. Completado cuando: cada acuerdo presunto tiene un destinatario y un cuestionario, y existe una entrada de descubrimiento cuando la reunión contenía contenido de requisitos.

Aviso final

⚠️ Estas minutas son un borrador generado por IA a partir de una transcripción. Requieren validación por parte de los asistentes antes de circular como un registro oficial, particularmente los Acuerdos Presuntos, que no fueron verbalizados explícitamente y requieren confirmación.

Individual skills in this repo

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

Skills relacionados