Configuration personnalisée pour Opencode : agents (system prompts définissant un rôle), skills (fichiers d'instructions chargés sur demande) et un snippet de configuration. Cela encode mon propre workflow. Publié tel quel.
Comment installer
Demandez à Opencode de l'installer :
Install https://coulon-jm.fr/opencode/agents.md
L'agent télécharge les fichiers dans ~/.config/opencode/, fusionne le snippet de configuration, et recharge la configuration.
Comment mettre à jour
Demandez à Opencode de le mettre à jour :
Update https://coulon-jm.fr/opencode/agents.md
Si vous demandez à opencode de "mettre à jour ses agents et skills", il devrait faire la bonne chose de façon autonome, mais fournir l'URL est toujours plus clair.
Comportement général
Les agents vont se comporter pour des opérations moins autonomes, ils vont se comporter plus comme un pair avec qui vous travaillez. Les agents utiliseront les fichiers locaux dans votre répertoire actuel pour suivre les tâches : cela améliorera l'efficacité des LLM de faible complexité.
Si vous avez besoin d'un agent simple et direct : utilisez Actions. Le mode Actions exécute les prompts de façon simple et directe sans mécanique cachée, mais il est limité à 12 rounds pour éviter les longues opérations non surveillées.
Si vous avez construit une liste TODO propre, vous pouvez demander à l'agent Code de travailler en autonomie : il exécutera les tâches une par une et s'arrêtera si quelque chose semble erroné. Tous les agents sont faits avec soin et prudence, ils n'itéreront pas de façon incontrôlée.
Agents
Sept fichiers d'agents remplacent les deux agents intégrés. Les agents primaires sont sélectionnés par l'utilisateur. Les subagents sont lancés par un autre agent pour décharger le travail.
| Agent | Mode | Rôle |
|---|---|---|
| Project | primary | Écrit les plans et les spécifications, gère les listes TODO, écrit la documentation. |
| Code | primary | Écrit le code à partir des specs et des fichiers de plan. Signale les problèmes trouvés pendant la mise en œuvre. |
| Actions | primary | Effectue des actions isolées sur cet ordinateur ou sur le web, via l'extension Firefox FoxPilot. |
| Research | primary | Recherche autonome sur un sujet. Recherche en ligne et écrit un rapport. |
| Brainstorm | primary | Discussion interactive pour concevoir les choses étape par étape, un sujet à la fois. Enregistre les sujets en attente dans un fichier. |
| Subresearch | subagent | Fait le travail de recherche réel pour l'agent Research. |
| Subagent | subagent | Exécute des tâches simples mais ennuyeuses, comme la recherche dans une base de code ou un site de documentation. |
Skills
Les skills sont chargés sur demande au lieu de dormir dans chaque prompt.
| Skill | Objectif |
|---|---|
| speccing | Écrit et modifie les fichiers de spécifications. |
| spec-implementation | Met en œuvre un projet à partir de ses spécifications. |
| planning | Écrit et modifie les fichiers de plan. |
| plan-implementation | Commence la mise en œuvre d'un fichier de plan. |
| item-list | Gère un fichier qui tient une seule liste suivie : todo, problèmes, contournements, étapes. |
| session-history | Lit ou recherche un transcript de session antérieure pour récupérer le contexte perdu. |
Choix importants
Ces choix correspondent à mes propres préférences et ne conviendront pas à tout le monde.
- L'outil Question est désactivé : il casse le flux et pollue l'esprit de l'utilisateur.
- Les agents intégrés sont désactivés : cela jette les system prompts spécifiques au modèle.
- Le style d'expression est imposé : langage plus simple, opposition plutôt que conformité, efficacité plutôt que qualité du langage.
- Les modèles des subagents sont votre choix : l'installateur demande quel modèle les subagents free utilisent, et quel modèle les subagents non-free utilisent. La liste free commence avec Big Pickle (opencode/big-pickle).
- Les permissions sont restreintes par agent : Project écrit du markdown seulement, Brainstorm garde ses notes dans deux fichiers, Research peut seulement dispatcher vers Subresearch, Subresearch ne peut pas modifier les fichiers.
Workflow typique
Brainstorm
Utilisez l'agent Brainstorm pour explorer une idée. Bon au démarrage d'un nouveau projet, d'une nouvelle fonctionnalité, avant la création de specs.
- Passer à l'agent Brainstorm.
- Annoncer le sujet principal.
- L'agent pose des questions et vous guide, en se concentrant sur chaque sujet un par un.
- Si de nouvelles idées viennent à votre esprit pendant le processus, annoncez-les : l'agent les ajoutera à la liste pour ne pas les oublier.
Spécifications
Utilisez l'agent Project pour écrire les spécifications du système cible. Les spécifications décriront comment le système devrait fonctionner une fois terminé.
- Passer à l'agent Project.
- Dites que vous voulez démarrer une spécification et quelle partie vous voulez spécifier.
- Si vous avez fait un Brainstorm avant, mentionnez les décisions du Brainstorm pour guider l'agent.
- L'agent construira la spécification progressivement, en suivant la discussion.
- Soit vous vérifiez la spec manuellement, soit vous prenez la voie du "full vibe" et vous posez des questions sur la spec pour la contester.
Planification
Utilisez l'agent Project pour écrire un plan de mise en œuvre. Écrire une spécification ou faire un Brainstorm d'abord est optionnel.
- Passer à l'agent Project.
- Dites que vous voulez démarrer un plan mais que vous ne voulez pas que l'agent écrive le plan pour l'instant. Si vous avez des specs ou un Brainstorm, dites-le pour guider l'agent.
- Faire une première description.
- Poursuivez l'explication et la discussion avec l'agent.
- Une fois un premier accord trouvé, demandez à l'agent d'écrire le plan.
- Ajustez le plan, vérifiez les problèmes.
Mise en œuvre des choses
Quand vous avez un plan, vous pouvez commencer sa mise en œuvre.
- Si vous n'avez pas de liste TODO, passez à l'agent Project et demandez à l'agent de produire une liste TODO. Les agents travaillent mieux avec une liste de suivi.
- Passer à l'agent Code.
- Demandez de mettre en œuvre le plan. Par défaut, il mettra en œuvre étape par étape, en demandant une intervention manuelle.
- Si votre plan est très clair ou si vous pratiquez le test-driven, vous pouvez demander "implementer en autonomie". L'opération autonome fait des revues de code automatisées, elle peut donc interrompre avant la fin en cas de gros problème.
Vibe coding
Passez en mode Code et promptez simplement. Parfois, l'agent déclenchera des revues de code pour éviter les dérives.