Adingo001/staffer

agy staffer

Le personnage à usage général : un point d'entrée propre pour les tâches qu'aucun spécialiste ne couvre. Son modèle d'invite est délibérément minimal — le texte de la tâche, l'environnement (cwd, branche, date), les règles de travail partagées et les garde-fous de sécurité, rien d'autre. Pas de cadrage de rôle ou de format de corps fixe : le livrable est défini par la tâche elle-même, et aucun contexte de modèle spécifique au domaine ne peut dérouter l'exécution.

Préférez un spécialiste quand il correspond : researcher pour les enquêtes et les analyses approfondies, reviewer pour un second avis sur du code ou des plans, implementer pour les modifications de l'arborescence de travail, ask pour une question rapide et unique.

staffer est également la voie d'accès aux outils natifs d'agy qu'aucun spécialiste ne couvre — notamment la génération d'image : agy intègre un outil generate_image (vérifié sur v1.1.15 ; un PNG 1024×1024 en ~30s). Indiquez le chemin de sortie dans la tâche, par exemple staffer --prompt "génère un robot mascotte pixel art, sauvegarde-le en tant que assets/mascot.png".

Localisation du compagnon

Ce fichier de skill se trouve dans <racine-du-plugin>/skills/staffer/SKILL.md ; résolvez le chemin du compagnon relatif à ce répertoire de skill :

node "<repertoire-skill>/../../companion/agy-companion.mjs" staffer [drapeaux] --prompt "tâche"

Passez le texte de la tâche de l'utilisateur textuellement via --prompt ; utilisez --prompt-file <chemin> ou --stdin pour les longs textes.

[!IMPORTANT] Exécutez cette commande en mode non isolé — agy a besoin d'un port localhost et de son fichier de jeton OAuth, que les environnements sandbox cachés masquent. Dans Codex, demandez les permissions élevées pour la commande. Détails : ../jobs/references/troubleshooting.md.

Collecte du résultat

La commande renvoie un identifiant de tâche. Lisez ../jobs/SKILL.md pour la collecte et la récupération des résultats : envoi, attente du résultat final, puis validation si nécessaire. N'observez pas proactivement la progression, ne lisez pas les journaux et n'inspectez pas les artefacts intermédiaires pendant l'exécution. N'observez que lorsque l'utilisateur demande explicitement une progression ; diagnostiquez une erreur ou un résultat nécessitant une intervention selon le protocole des tâches.

Drapeaux (tous optionnels)

• --prompt <texte> / --prompt-file <chemin> / --stdin — la tâche, provenant d'exactement une de ces trois sources. Utilisez le fichier/stdin pour les longues tâches au lieu du shell quoting.
• --model <id> ou --effort faible|moyen|élevé — le modèle par défaut est gemini-3.8-flash-medium.
• --restricted / --unrestricted — profil de permission ; staffer utilise par défaut le mode unrestricted comme les autres personnages utilisant des outils, --restricted est le chemin de durcissement optionnel.
• --continue (ou --conversation <id>), --timeout <durée> (par défaut 60 min, limite d'exécution dure maximale de 120 min).

Règles

• Passez la tâche de l'utilisateur textuellement. Parce que le modèle n'impose pas de format de sortie, indiquez le format souhaité dans le texte de la tâche lorsque l'appelant a besoin d'un format spécifique.
• Passez les autorisations explicites de l'utilisateur textuellement. Par défaut, le modèle refuse les effets de bord coûteux ou irréversibles (commits/push, suppression de fichiers en dehors de l'espace de travail, appels réseau avec effets de bord, commandes avec quota payant) ; cette valeur par défaut ne s'ouvre que si la tâche elle-même demande l'opération.
• Une tâche générale peut légitimement modifier des fichiers. Le compagnon signale tout delta de l'arborescence de travail avec le résultat — inspectez-le (git diff) et confirmez qu'il correspond à ce qui était demandé avant de l'utiliser.
• Pour les erreurs et la récupération, suivez ../jobs/SKILL.md.

Pour une conversation existante, --continue / --conversation <id> hérite du modèle et du profil de permission enregistrés, sauf en cas de remplacement explicite. Les valeurs par défaut non restreintes ci-dessus s'appliquent aux nouvelles tâches.