# Ticket Driver > ticket-driver - Skill: `blue-b-code/ticket-driver` (Agent Skill, multi-file: 7 files) - Install (CLI): `npx skillmds@latest add blue-b-code/ticket-driver` - Raw SKILL.md: https://api.skillmd.com/api/skills/blue-b-code/ticket-driver/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: Blue-B-code (https://skillmd.com/u/blue-b-code) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/blue-b-code/ticket-driver --- # ticket-driver ## Objectif Traiter un ticket Redmine (fix de revue OU feature) de la prise en main jusqu'à la recette, selon le **mode** du projet (`auto`, `propose`, `signal`). Respecter la convention du projet et sa gate de validation. ## Modes (par projet, dans `state/config.json` → `projects..mode`) - **auto** : corriger + valider + push + report + journal Redmine, sans validation humaine. - **propose** (défaut) : **préparer la proposition** (worktree + fix + gate + `state/proposals/_.md`), **envoyer l'approbation Telegram** (2 boutons ✅/❌), **NE PAS pousser/reporter** tant que non approuvé. - **signal** : **notifier seulement** (message info Telegram, pas de fix ni de bouton). ## Routage projet (OBLIGATOIRE — à faire en premier) - `/home/y-note/openimis*` → skill **openimis** - `/home/y-note/OrangeMoney/MobileInvoice` → skill **mi** - `/home/y-note/flownote` → skill **flownote** - Autre → lire `CLAUDE.md` / convention du repo. ## Workflow (mode propose — cœur) 1. **Contexte** : le `fetch` détecte la revue (MR/PR/ticket) ; le retour porte `body`, `url`, `title`, `discussion_id`, `key`, `sub`, `sub_id`. 2. **`propose.py`(déterministe, rapide)** : écrit `state/proposals/_.md` (PROJECT, MR, TITLE, URL, DISCUSSION, MARK_KEY, MARK_SUB, MARK_ID, SUMMARY) et envoie l'**approbation Telegram** (`tg.py send-approval`, boutons ✅/❌). Marque l'item `proposed`. **N'implémente pas, ne pousse pas, ne reporte pas.** 3. **Approbation** (humain sur Telegram) : - ✅ → `scripts/ticket-driver-approve.sh ` : lance `codex exec` qui **implémente** le fix (worktree de la branche source), **valide** (gate du projet), **pousse**, puis **reply + résolution + synthèse** et **journal Redmine** ; marque (mark-key). Statut `approved`. - ❌ → statut `rejected`, aucune action. 4. **Marquer** : `mark-key --project

--key --sub --id ` (dédup). 5. **Escalade** : retour non-actionnable/ambigu/risqué → ne pas répondre/résoudre ; le résumer, le marquer comme traité. ## Fichiers d'état - `state/projects.json` : curseurs des notes/journaux traités (dédup). - `state/approvals.json` : statut `proposed`/`approved`/`rejected`/`signaled` par item. - `state/proposals/_.md` : proposition en attente d'approbation. ## Commandes utiles - Fetch : `scripts/rfbot.py fetch --project

--out /tmp/items.json --pretty` - Telegram : `scripts/tg.py send-approval|send-info|poll` - Approbation : `scripts/ticket-driver-approve.sh ` - Report : `scripts/rfbot.py report --project

--target --action ` - Modes : `scripts/rfbot.py modes` (lister) ; `scripts/rfbot.py set-mode --project

--mode ` (changer). - Config : `state/config.json` (`projects..mode`, `telegram.*`, `redmine.*`). ## Sprint (nouveaux tickets Redmine assignés) - **Détection** : `rfbot.py fetch` ajoute une source `sprint_ticket` : version **sprint courant** = `DH-OpenIMIS` **ouverte** avec la `due_date` la plus proche ≥ aujourd'hui (dédupliquée par `version.id`), puis issues `assigned_to_id=redmine.me_id` dans cette version (projets routés via `redmine.sprint_routes` : `199→openimis`, `170→mi`, `209→flownote`). - **Item** : `kind=sprint_ticket`, `key=sprint_ticket_`, `sub=processed_tickets`, `sub_id=ticket_id`, portant `subject`, `body`, `tracker`, `url`, `redmine_project_id`. - **Propose** : pour un `sprint_ticket`, le modèle rédige un **plan d'implémentation clair** (contexte, étapes, fichiers, PR attendue, tests) et l'envoie sur Telegram ; la proposition est écrite dans `state/proposals/_.md`. - **Approbation** : ✅ → le skill projet implémente la feature (worktree `feature-`, validation, push, PR, journal Redmine recette) ; ❌ → rejeté. ## Validation - La gate de validation est celle du **skill projet** (`mi` / `openimis` / `flownote`) : lire ce skill et appliquer **sa** validation (conteneur MI, uv/pytest flownote, phing/vitest openimis…). - Appliquer de façon **ciblée** (fichiers touchés) et **fail-fast** (`timeout` via config `validation.timeout_seconds`, défaut 900 s) : si l'environnement est cassé (conteneur instable, donnée DB absente), **rapporter la cause et s'arrêter** — pas de retry, pas de hang, pas de push en masse. ## Fichiers d'état - `state/projects.json` : curseurs des notes/journaux traités (dédup). - `state/approvals.json` : statut `proposed`/`approved`/`rejected`/`signaled` par item. - `state/proposals/_.md` : proposition en attente d'approbation. ## Commandes utiles - Fetch : `scripts/rfbot.py fetch --project

--out /tmp/items.json --pretty` - Telegram : `scripts/tg.py send-approval|send-info|poll` - Approbation : `scripts/ticket-driver-approve.sh ` - Report : `scripts/rfbot.py report --project

--target --action ` - Modes : `scripts/rfbot.py modes` (lister) ; `scripts/rfbot.py set-mode --project

--mode ` (changer). - Config : `state/config.json` (`projects..mode`, `telegram.*`, `redmine.*`). ## Sprint (nouveaux tickets Redmine assignés) - **Détection** : `rfbot.py fetch` ajoute une source `sprint_ticket` : version **sprint courant** = `DH-OpenIMIS` **ouverte** avec la `due_date` la plus proche ≥ aujourd'hui (dédupliquée par `version.id`), puis issues `assigned_to_id=redmine.me_id` dans cette version (projets routés via `redmine.sprint_routes` : `199→openimis`, `170→mi`, `209→flownote`). - **Item** : `kind=sprint_ticket`, `key=sprint_ticket_`, `sub=processed_tickets`, `sub_id=ticket_id`, portant `subject`, `body`, `tracker`, `url`, `redmine_project_id`. - **Propose** : pour un `sprint_ticket`, le modèle rédige un **plan d'implémentation clair** (contexte, étapes, fichiers, PR attendue, tests) et l'envoie sur Telegram ; la proposition est écrite dans `state/proposals/_.md`. - **Approbation** : ✅ → le skill projet implémente la feature (worktree `feature-`, validation, push, PR, journal Redmine recette) ; ❌ → rejeté. ## Validation (ciblée + fail-fast) - **Ciblée** : n'exécuter que les tests/analyses des **fichiers touchés** (test PHP/phpcs/phpstan pour le contrôleur modifié ; vitest/tsc/lint pour le frontend) — ne PAS lancer `phing full-build` complet (lent). Les commandes sont dans `state/config.json` → `projects..validation`. - **Fail-fast** : `timeout` global (config `validation.timeout_seconds`, défaut 900 s) sur les runs `codex exec`. Si conteneur instable ou donnée DB absente (ex. `PaiementMethod 'MTNMoney'`), **rapporter la cause exacte et s'arrêter** — pas de retry, pas de hang, pas de push en masse.