kei-prog/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.

Qu'est-ce que superset-handoff-flow ?

Ce skill définit un flux de travail structuré pour qu'un développeur humain puisse confier une implémentation à l'échelle du référentiel à un agent Codex (par exemple, via Claude Code ou Cursor), puis en effectuer l'examen de clôture et fusionner en toute sécurité l'arborescence de travail (worktree) dans la branche principale. Il s'appuie sur Superset, un outil basé sur MCP (Model Context Protocol), pour gérer les aperçus, les journaux et le suivi des tâches. Le flux comprend des scripts automatisés pour l'analyse des modifications du référentiel, la vérification des conflits de fusion et l'exportation d'artefacts, ce qui permet de maintenir un historique clair et de réduire les risques lors de la reprise de grands changements. Compatible avec les environnements Codex, ce skill est conçu pour les développeurs utilisant des agents IA dans leurs workflows Git et de développement.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add kei-prog/superset-handoff-flow

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 :

  1. 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.
  2. Implémentation : L'agent Codex reçoit le contexte et exécute l'implémentation dans une arborescence de travail dédiée.
  3. Examen : Le développeur examine les modifications via Superset, vérifie les conflits et approuve la fusion.
  4. 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

CommandeDescription
npm run analyzeAnalyser les modifications du référentiel et générer un rapport
npm run check-mergeVérifier les conflits de fusion potentiels
npm run exportExporter 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_TOKEN est correctement configuré.
  • Conflits Git : Utilisez npm run check-merge avant de fusionner.
  • Agent Codex non trouvé : Assurez-vous que l'agent est installé et disponible dans le PATH.

Licence

MIT

Skills associés