Tutoriel d'utilisation d'OpenCode oh-my-openagent

Oh My OpenAgent(abrégé enOmO) est un plugin d'amélioration d'assistant de programmation IA open source, anciennement appeléoh-my-opencode。

oh-my-openagent s'exécute au-dessus d'OpenCode, l'outil de programmation IA, le transformant en11 agents IA professionnelsformant une équipe de développement.

Expliqué en une phrase :

Vous soumettez une requête → OmO orchestre automatiquement plusieurs IA pour travailler en parallèle → Plusieurs fois plus rapide qu'une seule IA

Actuellement sur GitHub54k+ étoiles, c'est le plugin OpenCode le plus populaire.

Installation

Copiez et collez l'invite suivante dans votre outil LLM (OpenCode, Claude Code, AmpCode, Cursor, etc.) :

按照此链接说明安装并配置 oh-my-opencode:https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

Après exécution, il s'installera automatiquement. Pendant l'installation, il peut y avoir des options de configuration de clé API ; vous pouvez choisir de les configurer ou non :


Découvrez les 11 membres de l'équipe IA (agents)

OmO intègre 11 agents spécialisés, chacun avec son propre rôle :

Agents principaux

Agent Rôle Modèle par défaut Quand l'utiliser
Sisyphus Coordinateur principal, développeur polyvalent Claude Opus Point d'entrée pour toutes les tâches, orchestre automatiquement les autres agents
Prometheus Planificateur stratégique Claude Opus / GPT-5.4 Planification de tâches complexes
Atlas Gestion des tâches à faire Kimi K2.5 Suivi de la progression des tâches multi-étapes

Agents professionnels

Agent Rôle Modèle par défaut Spécialisé dans
Hephaestus Travailleur autonome avancé GPT-5.3-codex Tâches de codage indépendantes de longue durée et de haute intensité
Oracle Consultant en architecture / expert en débogage GPT-5.4 Conception de systèmes, localisation de bogues difficiles
Momus Relecteur de haute précision GPT-5.4 Revue de code, vérification des sorties
Metis Revue du plan Claude Opus Vérifier si le plan de Prometheus comporte des omissions

Agents de type outil (rapides, à faible coût)

Agent Rôle Modèle par défaut Pourquoi utiliser des modèles peu coûteux
Explorer Recherche rapide dans la base de code MiniMax / Grok Code Fast Les tâches de recherche ne nécessitent pas une intelligence élevée ; la vitesse importe davantage
Bibliothécaire Récupération de documents/code MiniMax (Gratuit) La récupération de documents ne nécessite pas de raisonnement approfondi
Observateur multimodal Analyse de captures d'écran/visuelle Kimi K2.5 Kimi excelle dans la compréhension multimodale

💡 Astuce pour débutants: Vous n'avez pas besoin de sélectionner manuellement les Agents. Sisyphus orchestrera automatiquement la combinaison d'Agents appropriée en fonction de votre type de tâche.


Trois modes de travail

Mode 1 : ultrawork (le plus facile)

Ajouter au promptultraworkouulw, tout est automatisé :

ultrawork 帮我把这个 React 组件改成 TypeScript

Convient pour : les tâches de développement quotidiennes, les scénarios où vous souhaitez que l'IA accomplisse tout automatiquement.

Mode 2 : Mode de planification Prometheus (le plus précis)

appuyez sur latouche Tabpour entrer en mode Prometheus. L'IA commencera par comprendre vos besoins via des questions-réponses, générera un plan d'exécution détaillé et lancera l'exécution après votre confirmation.

Flux de travail :

  1. appuyezTabPasser au mode Prometheus
  2. Décrivez vos besoins ; l'IA vous posera quelques questions de clarification
  3. L'IA génère un plan d'exécution, vous confirmez
  4. Entrée/start-workpour lancer l'exécution

Convient pour : le développement de fonctionnalités complexes, la refactorisation d'architecture et d'autres scénarios nécessitant une planification précise.

Mode 3 : Conversation normale (le plus flexible)

Saisissez directement votre question ou besoin sans ajouter de mots-clés :

解释一下 src/auth.ts 里的 JWT 验证逻辑

Convient pour : les tâches légères telles que poser des questions, expliquer du code et effectuer de petites modifications.


Détails du fichier de configuration

OmO dispose de deux fichiers de configuration avec des priorités différentes :

  • Configuration au niveau du projet (priorité plus élevée) :.opencode/oh-my-opencode.jsonc
  • Configuration au niveau de l'utilisateur (valeur globale par défaut) :~/.config/opencode/oh-my-opencode.jsonc

Les fichiers de configuration prennent en charge les commentaires (format JSONC) et l'auto-complétion JSON Schema :

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-opencode.schema.json",
  
  "agents": {
    // 主协调 Agent,建议用 Claude Opus 系列或 Kimi
    "sisyphus": {
      "model": "anthropic/claude-opus-4-6"
    },
    // 架构顾问,建议用 GPT 系列
    "oracle": {
      "model": "openai/gpt-5.4",
      "variant": "high"
    }
  }
}

Conseil aux débutants: Ne modifiez pas la configuration juste après l'installation ; les paramètres par défaut sont déjà bons.


Référence rapide des commandes courantes

Commande Description
opencode Démarrer OmO
bunx oh-my-opencode install Installer/reconfigurer le plugin
bunx oh-my-opencode doctor Diagnostiquer les problèmes de configuration
opencode auth login Se connecter au compte du fournisseur d'IA
opencode models Afficher tous les modèles disponibles
bunx oh-my-opencode refresh-model-capabilities Actualiser le cache des capacités des modèles

Dans l'interface de conversation :

Raccourci/Commande Description
Tab Passer au mode de planification Prometheus
/start-work Commencer l'exécution du plan en mode Prometheus
ultrawork / ulw Ajouter au prompt pour activer le mode parallèle complet

Dépannage des problèmes courants

Q : Après l'installation, l'exécutionopencoden'affiche pas les fonctionnalités OmO

Solution: Vérifiez si le plugin est correctement enregistré dans le fichier de configuration :

cat ~/.config/opencode/opencode.json

Confirmezpluginle champ contient"oh-my-opencode". Si ce n'est pas le cas, réexécutezbunx oh-my-opencode install。

Q : Avertissement d'exécution "Using legacy package name"

Solution: Modifieropencode.jsonle nom du plugin dans ... de"oh-my-opencode"à"oh-my-openagent":

{
  "plugin": ["oh-my-openagent"]
}

Q : L'agent Sisyphus est peu performant, semble identique à Claude standard

Cause: Peut-être que vous n'utilisez pas le modèle Claude Opus, ou que vous n'ajoutez pasultrawork。

Solution:

  1. Confirmez que vous êtes connecté à un compte Claude Pro/Max
  2. Addultraworkmot-clé au prompt
  3. Exécutezbunx oh-my-opencode doctorpour vérifier la configuration du modèle

Q : La tâche s'arrête à mi-chemin

Solution: Continuez à envoyer des promptsultrawork 继续之前的任务, Sisyphus reprendra la progression grâce au système Todo.

Q : Vous souhaitez désactiver les données de télémétrie anonymes

OmO active la télémétrie anonyme par défaut (utilise PostHog, les données sont hachées). Pour la désactiver :

export OMO_SEND_ANONYMOUS_TELEMETRY=0
# 或
export OMO_DISABLE_POSTHOG=1
Autres extensions