Azkae/agent-shell

Créer un nouvel agent-shell

Lancer un nouvel agent-shell lorsque l'utilisateur le demande. Le nouvel agent s'exécute dans Emacs via agent-shell et travaille sur un worktree git isolé.

Étapes

1. Déterminer les paramètres

• Sujet : Sur quelle tâche le nouvel agent doit-il travailler ? Demander à l'utilisateur si ce n'est pas clair.
• Nom : Un nom court en kebab-case basé sur la tâche (ex. refactor-auth, fix-login-bug, add-dark-mode).
• Agent : Quel agent utiliser (ex. claude, codex, opencode). Utiliser le même agent que celui qui exécute actuellement cette compétence, sauf si l'utilisateur spécifie autrement.

2. Créer le worktree

Créer un worktree git dans .agent-shell/worktrees/ au sein du dépôt courant, sur une nouvelle branche nommée agent/<name> :

git worktree add -b "agent/<name>" ".agent-shell/worktrees/<name>"

3. Exécuter la configuration du dépôt

Vérifier la présence de fichiers de configuration dans le worktree et les exécuter. Rechercher :

• CLAUDE.md, AGENTS.md, README.md — commandes de configuration/construction/installation
• Makefile — make setup ou make install
• package.json — npm install / npm ci / pnpm install / yarn install
• pyproject.toml / requirements.txt — uv sync / pip install -e .
• Gemfile — bundle install
• Cargo.toml — cargo fetch
• .env.example — copier vers .env

Exécuter les commandes de configuration dans le répertoire du worktree :

cd ".agent-shell/worktrees/<name>" && <commande-de-configuration>

4. Lancer l'agent dans Emacs

Appeler emacsclient pour démarrer le nouvel agent shell :

emacsclient -e '(my/agent-shell-make
   :prompt "<description de la tâche>"
   :name "<nom-du-worktree>"
   :agent "<agent>"
   :directory "<chemin-absolu-vers-le-worktree>")'

Exemple :

emacsclient -e '(my/agent-shell-make
   :prompt "Refactoriser l'authentification pour utiliser async/await. Voir @..."
   :name "refactor-auth"
   :agent "claude"
   :directory "/Users/me/projects/my-app/.agent-shell/worktrees/refactor-auth")'

Utiliser le chemin absolu pour :directory.

5. Informer l'utilisateur

Dire à l'utilisateur :

• Le chemin du worktree et le nom de la branche
• Quelle configuration a été exécutée (ou qu'aucune configuration n'était nécessaire)
• Que le nouvel agent a été lancé dans Emacs

Règles

• Toujours créer le worktree dans .agent-shell/worktrees/ au sein du dépôt courant.
• Toujours créer une nouvelle branche nommée agent/<name> pour le worktree.
• Toujours utiliser des chemins absolus pour :directory.
• Utiliser le même :agent que celui qui exécute actuellement cette compétence, sauf si l'utilisateur spécifie autrement.
• Exécuter toutes les commandes via l'outil Bash.
• Si Emacs n'est pas en cours d'exécution ou si emacsclient échoue, signaler l'erreur à l'utilisateur avec la commande manuelle à exécuter.