Jakeschincariol/scheduler

Que fait scheduler ?

Dès que quelqu'un accepte un appel, le Scheduler le place sur les deux calendriers avant que l'occasion ne passe. Un appel réservé vaut plus que dix relances.

${CLAUDE_SKILL_DIR} ci-dessous est le dossier de cette compétence (là où se trouve ce SKILL.md).

python3 "${CLAUDE_SKILL_DIR}/slots.py" parse --text "Désolé, semaine chargée ! Jeudi à 14h ça marche." --today 2026-10-27
python3 "${CLAUDE_SKILL_DIR}/slots.py" free --busy closer/busy.json --from 2026-10-28 --days 3 --length 30
python3 "${CLAUDE_SKILL_DIR}/slots.py" invite --contact dana-harbor-lane --start 2026-10-29T14:00 --minutes 30
python3 "${CLAUDE_SKILL_DIR}/slots.py" book --contact dana-harbor-lane --start 2026-10-29T14:00 \
    --minutes 30 --approval "oui" --busy closer/busy.json

Étapes

1. Quand. slots.py parse avec leur réponse. "à 14h" sans AM ni PM est interprété comme 14h (1 à 7 correspond à l'après-midi, 8 à 12 correspond au matin). Si le script affiche "Aucune heure claire", demandez-leur une heure ; ne devinez jamais un jour. Indiquez la date complète à l'utilisateur : « Jeudi 29 octobre à 14h00, votre heure. C'est bon ? »
2. Conflit. Avec le connecteur de calendrier, lisez les événements de l'utilisateur pour ce jour et écrivez-les dans closer/busy.json sous la forme [{"start": "...", "end": "..."}]. S'ils ont demandé des options à la place, slots.py free liste les créneaux libres pendant les heures ouvrables ; proposez-en deux ou trois.
3. Demander. « Réserver Harbor Lane Dental x Votre Agence, jeudi 29 octobre, 14h00 à 14h30, Google Meet, avec Dana Ortiz invitée ? Répondez oui ou non. »
4. Réserver. Sur un oui, créez l'événement sur le calendrier de l'utilisateur avec le connecteur de calendrier (titre, heure, Google Meet, Dana comme invité). Pas de connecteur de calendrier : slots.py invite écrit un fichier .ics que l'utilisateur peut ouvrir ou joindre.
5. Journaliser. slots.py book --approval "<son oui>". L'affaire passe à l'état « appel réservé » et /suivi s'arrête.
6. Confirmer. Rédigez la réponse avec le modèle de confirmation de /suivi (« Jeudi à 14h ça marche, Dana. J'envoie l'invitation maintenant. »), et envoyez-la uniquement après son propre accord.
7. Préparer. Rappelez à l'utilisateur d'exécuter /chercheur avant l'appel.

Exemple tiré de la démo

Mar 27 oct, 11 h 48 : « Désolé, semaine chargée ! Jeudi à 14h ça marche. » parse donne jeudi 29 octobre, 14h00. L'utilisateur est libre, dit oui, et le calendrier affiche « Harbor Lane Dental x Votre Agence, jeudi 29 octobre, 14h00 à 14h30, Google Meet, invités Dana Ortiz et Vous ». (Illustratif : Dana et Harbor Lane Dental sont fictifs.)

Ce qu'il ne fait jamais

• Ne réserve, ne déplace et n'annule jamais un événement sans l'accord explicite de l'utilisateur pour cet événement précis.
• Ne double-réserve jamais sur un événement déjà présent dans le calendrier de l'utilisateur.
• Ne lit jamais les détails du calendrier au-delà des heures de libre et d'occupé pour trouver un créneau.

Consentement et vérité

• Rien n'est envoyé, réservé ou signé sans l'accord explicite de l'utilisateur pour ce message, cette invitation ou ce document précis. Claude rédige, l'utilisateur dit « oui », puis cela part depuis les propres comptes de l'utilisateur : les invitations de calendrier via son propre calendrier. Un accord par message. Jamais « oui à tout ».
• Arrêtez-vous au premier « non » ou à tout signe de désintérêt. Une demande d'arrêt est honorée pour toujours, dans toutes les compétences.
• N'inventez jamais une heure à laquelle quelqu'un a accepté. Quand ce n'est pas clair, demandez.