Jiale077/meeting-minutes-skill

¿Qué hace meeting-minutes-skill?

🎙️ Habilidad de Claude Code / Codex: transcripción de grabaciones de reuniones con un solo clic → actas formales y estructuradas en chino → exportación a Word (ASR de Tongyi Tingwu + separación de hablantes)

Descripción

Esta habilidad permite convertir grabaciones de audio de reuniones en actas formales en chino, listas para exportar a Word. Utiliza el servicio ASR de Tongyi Tingwu para la transcripción y la separación de hablantes, y luego estructura el contenido en un formato de acta profesional.

Plataformas Compatibles

• Claude Code: Funciona como una habilidad de Claude Code, utilizando reglas personalizadas.
• Codex: También compatible con Codex, siguiendo un flujo de trabajo similar.

Cómo Funciona

1. Entrada: Proporcione la ruta a un archivo de audio (por ejemplo, reunion.mp3).
2. Transcripción: La habilidad envía el audio al servicio ASR de Tongyi Tingwu, que devuelve una transcripción con marcas de tiempo y etiquetas de hablante.
3. Post-procesamiento: La transcripción se procesa para generar un acta estructurada que incluye:
   • Título de la reunión
   • Fecha y hora
   • Lista de asistentes (extraída de los hablantes)
   • Resumen de puntos clave
   • Decisiones tomadas
   • Próximos pasos y responsables
4. Exportación: El acta se formatea y se exporta como un documento de Word (.docx).

Requisitos

• API de Tongyi Tingwu: Necesita una clave API válida para el servicio de transcripción.
• Dependencias: Python 3.8+ con las bibliotecas requests, python-docx, y json.

Uso

1. Clone este repositorio en su máquina local.
2. Configure las variables de entorno:
   • TONGYI_API_KEY: Su clave API de Tongyi Tingwu.
   • TONGYI_APP_ID: Su ID de aplicación (opcional).
3. Ejecute el script principal:

   python transcribe_and_make_minutes.py <ruta_al_audio>
   

4. El documento Word se generará en el mismo directorio con el nombre acta_reunion.docx.

Ejemplo de Entrada y Salida

Entrada: grabacion_reunion.mp3 Salida: acta_reunion.docx con el siguiente formato:

Acta de Reunión
Fecha: 2025-03-15
Asistentes: Juan Pérez, María López...

Puntos Tratados:
- Revisión del plan de ventas Q1
- Discusión sobre la nueva estrategia de marketing

Decisiones:
- Aprobar el presupuesto de marketing de $50,000

Próximos Pasos:
- Juan: Preparar informe de ventas para el viernes
- María: Enviar propuesta de campaña antes del lunes

Personalización

Puede modificar la plantilla del acta editando el archivo template.docx o ajustando los parámetros en config.json. Las opciones incluyen:

• Idioma del acta (por defecto: chino)
• Estilo de formato (formal/informal)
• Incluir o excluir marcas de tiempo

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo LICENSE para más detalles.