Que fait superset-handoff-flow ?
Ensemble de compétences Codex : remettre une implémentation à l'échelle du référentiel à un agent Codex via Superset, avec examen de clôture et fusion sécurisée de l'arborescence de travail.
Aperçu
Ce skill permet à un développeur de déléguer une implémentation complète du référentiel à un agent Codex (tel que Claude Code, Cursor, ou Codex CLI) en utilisant Superset. Le flux comprend les étapes suivantes :
- Préparation : Le développeur prépare le contexte de l'implémentation (par exemple, un fichier de spécifications ou des notes) et l'envoie à Superset.
- Implémentation : L'agent Codex reçoit le contexte et exécute l'implémentation dans une arborescence de travail dédiée.
- Examen : Le développeur examine les modifications via Superset, vérifie les conflits et approuve la fusion.
- Fusion : L'arborescence de travail est fusionnée en toute sécurité dans la branche principale.
Prérequis
- Superset – Outil basé sur MCP pour la gestion des aperçus et des journaux.
- Git – Version 2.30 ou ultérieure.
- Codex – Agent compatible (par exemple, Claude Code, Cursor, Codex CLI).
- Node.js – Version 18 ou ultérieure (pour les scripts d'assistance).
Installation
# Cloner le dépôt du skill
gh repo clone kei-prog/superset-handoff-flow
# Installer les dépendances
npm install
# Configurer Superset (via MCP)
superset config set --key SKILL_HANDOFF_TOKEN --value <votre_token>
Utilisation
1. Préparer l'implémentation
Créez un fichier de spécifications (par exemple, spec.md) décrivant l'implémentation à réaliser. Exemple :
# Spécification d'implémentation
- **Module** : `src/processing/`
- **Tâche** : Ajouter une file d'attente de traitement asynchrone
- **Critères d'acceptation** :
- Les tâches sont mises en file d'attente avec une priorité
- Le traitement s'exécute en arrière-plan
- Tests unitaires couvrant > 80 %
2. Envoyer à Superset
superset handoff create --spec spec.md --output .handoff/
3. L'agent Codex exécute l'implémentation
# Exemple avec Claude Code
claude code --skill kei-prog/superset-handoff-flow --handoff .handoff/
4. Examiner et fusionner
# Vérifier l'état
superset handoff status
# Examiner les modifications (diff)
superset handoff diff
# Approuver et fusionner
superset handoff merge --branch main
Scripts d'assistance
| Commande | Description |
|---|---|
npm run analyze | Analyser les modifications du référentiel et générer un rapport |
npm run check-merge | Vérifier les conflits de fusion potentiels |
npm run export | Exporter les artefacts de l'implémentation vers un répertoire de sortie |
Structure du projet
.
├── .handoff/ # Artefacts de l'implémentation
│ ├── spec.md # Fichier de spécifications
│ ├── status.json # État actuel
│ └── diff/ # Fichiers de différences
├── scripts/ # Scripts d'assistance
│ ├── analyze.js
│ ├── check-merge.js
│ └── export.js
├── package.json
└── README.md # Ce fichier
Dépannage
- Erreur de token Superset : Vérifiez que
SKILL_HANDOFF_TOKENest correctement configuré. - Conflits Git : Utilisez
npm run check-mergeavant de fusionner. - Agent Codex non trouvé : Assurez-vous que l'agent est installé et disponible dans le PATH.
Licence
MIT