Arlowen/pika-skills

Notificar Finalización en Feishu

Resumen

Envía el mensaje de finalización requerido del bot de la aplicación Feishu después de un turno de chat o cuando se complete un cambio relevante en Codex. Utiliza el script incluido para mantener la consistencia en la obtención de tokens, la forma del mensaje y las llamadas a la API.

Flujo de trabajo

1. Confirma si las reglas activas del proyecto requieren notificación después de cada turno de chat completado. Si es así, envía incluso para turnos solo de preguntas. De lo contrario, envía solo después de completar y enviar (push), o de finalizar, un cambio de código, activos, interfaz de usuario, documentación o proyecto.
2. Determina los campos del mensaje:
   • Proyecto: nombre del repositorio o espacio de trabajo actual. Si es codex, preséntalo como Codex.
   • Chat: título del chat/hilo actual. Si no está disponible, usa el nombre visible del directorio del chat o espacio de trabajo.
   • Sesión: nombre de la tarea o conversación actual. Si no está disponible, usa un nombre conciso derivado de la tarea del usuario.
   • Hora: hora local de finalización.
3. Ejecuta el script scripts/send_feishu_completion.py desde esta habilidad con los parámetros explícitos --project, --chat y --session cuando los conozcas.
4. Si el script informa que faltan variables de entorno de Feishu, dile al usuario que la notificación no pudo enviarse por esa razón concreta. No recurras a Slack.
5. Si Feishu devuelve un error de API, reintenta una sola vez solo cuando el fallo parezca transitorio. De lo contrario, informa del fallo y continúa con la respuesta final.

Uso del Script

Usa:

python3 /Users/pika/.codex/skills/notify-feishu-completion/scripts/send_feishu_completion.py \
  --project "NombreDelProyecto" \
  --chat "NombreDelChat" \
  --session "NombreDeLaSesión"

Usa --dry-run para validar el mensaje generado sin llamar a Feishu:

python3 /Users/pika/.codex/skills/notify-feishu-completion/scripts/send_feishu_completion.py \
  --project "Codex" \
  --chat "nuevo-chat" \
  --session "Crear habilidad de notificación Feishu" \
  --dry-run

El script envía esta forma exacta del mensaje:

【项目名】【chat 名称】【会话名】变更已完成，【完成时间】

El script lee estas variables de entorno cuando no está en modo simulado:

FEISHU_APP_ID
FEISHU_APP_SECRET
FEISHU_RECEIVE_ID_TYPE
FEISHU_RECEIVE_ID

Notas

• Envía solo a través de Feishu; nunca uses Slack para esta notificación de finalización.
• Mantén clara la respuesta final al usuario si la notificación se envió o no pudo enviarse.
• Prefiere pasar valores explícitos de los campos en lugar de confiar en la inferencia del script cuando se conozcan los nombres del chat y la sesión actuales.