OpenCode oh-my-openagent Nutzungs-Tutorial

Oh My OpenAgent(abgekürzt alsOmO) ist ein Open-Source-Erweiterungs-Plugin für KI-Programmierassistenten, früher genanntoh-my-opencode。

oh-my-openagent läuft auf OpenCode, dem KI-Programmierwerkzeug, auf und verwandelt es in11 professionelle KI-Agenten,die ein Entwicklungsteam bilden.

In einem Satz erklärt:

Du sendest eine Anfrage → OmO orchestriert automatisch mehrere KIs, die parallel arbeiten → Um ein Vielfaches schneller als eine einzelne KI

Verzeichnet derzeit auf GitHub54k+ Stars, es ist das beliebteste OpenCode-Plugin.

Installation

Kopiere den folgenden Prompt und füge ihn in dein LLM-Tool ein (OpenCode, Claude Code, AmpCode, Cursor usw.):

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

Nach der Ausführung installiert es sich selbst. Während der Installation kann es API-Schlüssel-Konfigurationsoptionen geben; du kannst sie konfigurieren oder nicht:


Lerne die 11 KI-Teammitglieder kennen (Agenten)

OmO hat 11 spezialisierte Agenten integriert, jeder mit seiner eigenen Rolle:

Kern-Agenten

Agent Rolle Standardmodell Wann verwenden
Sisyphus Hauptkoordinator, Allround-Entwickler Claude Opus Einstiegspunkt für alle Aufgaben, orchestriert automatisch andere Agenten
Prometheus Strategischer Planer Claude Opus / GPT-5.4 Planung für komplexe Aufgaben
Atlas Todo-Aufgabenverwaltung Kimi K2.5 Fortschritt mehrstufiger Aufgaben verfolgen

Professionelle Agenten

Agent Rolle Standardmodell Spezialisiert auf
Hephaestus Hochgradig autonomer Worker GPT-5.3-codex Lang andauernde, hochintensive unabhängige Coding-Aufgaben
Oracle Architekturberater/Debugging-Experte GPT-5.4 Systemdesign, Auffinden schwieriger Bugs
Momus Hochpräziser Reviewer GPT-5.4 Code-Review, Ausgabeverifizierung
Metis Planüberprüfung Claude Opus Prüfen, ob der Plan von Prometheus Auslassungen enthält

Werkzeug-Agenten (Schnell, kostengünstig)

Agent Rolle Standardmodell Warum günstige Modelle verwenden
Explore Schnelle Codebasis-Suche MiniMax / Grok Code Fast Suchaufgaben erfordern keine hohe Intelligenz; Geschwindigkeit ist wichtiger
Librarian Dokument-/Code-Abruf MiniMax (Kostenlos) Dokumentenabruf erfordert kein tiefgehendes Reasoning
Multimodal Looker Screenshot/visuelle Analyse Kimi K2.5 Kimi ist hervorragend im multimodalen Verständnis

💡 Anfängertipp: Du musst Agenten nicht manuell auswählen. Sisyphus orchestriert automatisch die passende Agent-Kombination basierend auf deinem Aufgabentyp.


Drei Arbeitsmodi

Modus 1: ultrawork (Am einfachsten)

Zum Prompt hinzufügenultraworkoderulw, alles ist automatisiert:

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

Geeignet für: tägliche Entwicklungsaufgaben, Szenarien, in denen Sie möchten, dass die KI alles automatisch erledigt.

Modus 2: Prometheus-Planungsmodus (Am präzisesten)

Drücken SieTab-Taste, um den Prometheus-Modus zu betreten. Die KI versteht zunächst Ihre Anforderungen durch Fragen und Antworten, erstellt einen detaillierten Ausführungsplan und startet die Ausführung, nachdem Sie bestätigt haben.

Workflow:

  1. drückenTabZum Prometheus-Modus wechseln
  2. Beschreiben Sie Ihre Anforderungen; die KI stellt Ihnen einige klärende Fragen
  3. KI generiert einen Ausführungsplan, Sie bestätigen
  4. Enter/start-workum mit der Ausführung zu beginnen

Geeignet für: komplexe Feature-Entwicklung, Architektur-Refactoring und andere Szenarien, die eine präzise Planung erfordern.

Modus 3: Normale Konversation (Am flexibelsten)

Geben Sie Ihre Frage oder Anforderung direkt ein, ohne Schlüsselwörter hinzuzufügen:

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

Geeignet für: leichte Aufgaben wie Fragen stellen, Code-Erklärung und kleine Änderungen.


Details zur Konfigurationsdatei

OmO hat zwei Konfigurationsdateien mit unterschiedlichen Prioritäten:

  • Projektweite Konfiguration (höhere Priorität):.opencode/oh-my-opencode.jsonc
  • Benutzerweite Konfiguration (globale Standardeinstellung):~/.config/opencode/oh-my-opencode.jsonc

Konfigurationsdateien unterstützen Kommentare (JSONC-Format) und JSON-Schema-Autovervollständigung:

{
  "$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"
    }
  }
}

Hinweis für Anfänger: Ändern Sie die Konfiguration nicht direkt nach der Installation; die Standardeinstellungen sind bereits gut.


Kurzreferenz für gängige Befehle

Befehl Beschreibung
opencode OmO starten
bunx oh-my-opencode install Plugin installieren/neu konfigurieren
bunx oh-my-opencode doctor Konfigurationsprobleme diagnostizieren
opencode auth login Beim KI-Anbieterkonto anmelden
opencode models Alle verfügbaren Modelle anzeigen
bunx oh-my-opencode refresh-model-capabilities Cache für Modellfähigkeiten aktualisieren

Innerhalb der Konversationsoberfläche:

Tastenkürzel/Befehl Beschreibung
Tab Zum Prometheus-Planungsmodus wechseln
/start-work Mit der Ausführung des Plans im Prometheus-Modus beginnen
ultrawork / ulw Zum Prompt hinzufügen, um den vollfunktionsfähigen Parallelmodus zu aktivieren

Fehlerbehebung bei häufigen Problemen

F: Nach der Installation, beim Ausführenopencodezeigt keine OmO-Funktionen an

Lösung: Prüfen Sie, ob das Plugin korrekt in der Konfigurationsdatei registriert ist:

cat ~/.config/opencode/opencode.json

BestätigenpluginFeld enthält"oh-my-opencode". Falls nicht, erneut ausführenbunx oh-my-opencode install。

F: Laufzeitwarnung "Using legacy package name"

Lösung: Ändernopencode.jsonden Plugin-Namen in ... von"oh-my-opencode"auf"oh-my-openagent":

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

F: Sisyphus Agent schneidet schlecht ab, fühlt sich an wie normales Claude

Ursache: Möglicherweise wird das Claude Opus-Modell nicht verwendet oder nicht hinzugefügtultrawork。

Lösung:

  1. Bestätigen Sie, dass Sie bei einem Claude Pro/Max-Konto angemeldet sind
  2. AddultraworkSchlüsselwort zum Prompt
  3. Führen Siebunx oh-my-opencode doctorum die Modellkonfiguration zu überprüfen

F: Aufgabe stoppt mittendrin

Lösung: Weiter promptenultrawork 继续之前的任务, Sisyphus setzt den Fortschritt über das Todo-System fort.

F: Möchten Sie anonyme Telemetriedaten deaktivieren

OmO aktiviert standardmäßig anonyme Telemetrie (verwendet PostHog, Daten werden gehasht). Um sie zu deaktivieren:

export OMO_SEND_ANONYMOUS_TELEMETRY=0
# 或
export OMO_DISABLE_POSTHOG=1
Andere Erweiterungen