Tutorial de uso de OpenCode oh-my-openagent

Oh My OpenAgent(abreviadoOmO) es un plugin de código abierto que mejora el asistente de programación con IA, anteriormente llamadooh-my-opencode。

oh-my-openagent se ejecuta sobre OpenCode, la herramienta de programación con IA, convirtiéndola en unequipo de 11 agentes de IA especializadosque forman el equipo de desarrollo.

Explicado en una frase:

Envías una solicitud → OmO coordina automáticamente múltiples IAs que trabajan en paralelo → varias veces más rápido que una sola IA

Actualmente tiene en GitHub54k+ Stars, es el plugin más popular de OpenCode.

Instalación

Copia y pega el siguiente prompt en tu herramienta de modelos de IA (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

Después de ejecutarlo, se instalará por sí solo. Durante la instalación puede haber una opción para configurar la API key; puedes configurarla o no:

Conoce a los 11 miembros del equipo de IA (Agentes)

OmO incluye 11 agentes especializados, cada uno con su función:

Agentes principales

Agent Rol Modelo predeterminado Cuándo usar
Sisyphus Coordinador principal, desarrollador integral Claude Opus Punto de entrada de todas las tareas, coordina automáticamente otros agentes
Prometheus Planificador estratégico Claude Opus / GPT-5.4 Elaboración de planes para tareas complejas
Atlas Gestión de tareas pendientes Kimi K2.5 Seguimiento del progreso de tareas de varios pasos

Agentes especializados

Agent Rol Modelo predeterminado En qué se especializa
Hephaestus Trabajador profundamente autónomo GPT-5.3-codex Tareas de codificación independientes de larga duración y alta intensidad
Oracle Consultor de arquitectura / experto en depuración GPT-5.4 Diseño de sistemas, localización de bugs difíciles
Momus Revisor de alta precisión GPT-5.4 Revisión de código, validación de salida
Metis Evaluación de planes Claude Opus Verifica si el plan de Prometheus tiene omisiones

Agentes de herramienta (rápidos y de bajo costo)

Agent Rol Modelo predeterminado Por qué usar modelos económicos
Explore Búsqueda rápida en el repositorio de código MiniMax / Grok Code Fast Las tareas de búsqueda no requieren gran inteligencia; la velocidad es más importante
Librarian Búsqueda de documentos/código MiniMax (gratuito) La búsqueda de documentos no requiere razonamiento profundo
Multimodal Looker Captura de pantalla / análisis visual Kimi K2.5 Kimi se especializa en comprensión multimodal

💡 Consejo para principiantes: No necesitas seleccionar agentes manualmente. Sisyphus coordinará automáticamente la combinación adecuada de agentes según tu tipo de tarea.

Tres modos de trabajo

Modo 1: ultrawork (el más sencillo)

Agrega en el promptultraworkoulw, todo se automatiza:

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

Ideal para: tareas de desarrollo diarias, escenarios donde deseas que la IA lo complete de forma totalmente automática.

Modo 2: modo plan Prometheus (el más preciso)

segúnTecla TabEntra al modo Prometheus. La IA primero comprenderá tus necesidades mediante preguntas y respuestas, generará un plan de ejecución detallado y comenzará a ejecutarlo después de tu confirmación.

Proceso:

  1. segúnTabCambia al modo Prometheus
  2. Describe tus necesidades; la IA te hará preguntas de aclaración
  3. La IA genera el plan de ejecución y tú lo confirmas
  4. Ingresa/start-workComienza la ejecución

Ideal para: desarrollo de funciones complejas, refactorización de arquitectura y otros escenarios que requieren planificación precisa.

Modo 3: conversación normal (la más flexible)

Ingresa directamente tu pregunta o necesidad, sin agregar ninguna palabra clave:

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

Ideal para: tareas ligeras como hacer preguntas, explicar código, realizar modificaciones menores, etc.

Explicación detallada de los archivos de configuración

OmO tiene dos archivos de configuración con diferente prioridad:

  • Configuración a nivel de proyecto (mayor prioridad):.opencode/oh-my-opencode.jsonc
  • Configuración a nivel de usuario (predeterminada global):~/.config/opencode/oh-my-opencode.jsonc

Los archivos de configuración admiten comentarios (formato JSONC) y también autocompletado mediante 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"
    }
  }
}

Recomendación para principiantes: Después de la instalación, no modifiques la configuración; los valores predeterminados ya son muy buenos.

Tabla de referencia rápida de comandos comunes

Comando Descripción
opencode Iniciar OmO
bunx oh-my-opencode install Instalar/reconfigurar el plugin
bunx oh-my-opencode doctor Diagnosticar problemas de configuración
opencode auth login Iniciar sesión en la cuenta del proveedor de IA
opencode models Ver todos los modelos disponibles
bunx oh-my-opencode refresh-model-capabilities Actualizar la caché de capacidades del modelo

Dentro de la interfaz de conversación:

Atajo/Comando Descripción
Tab Cambiar al modo plan Prometheus
/start-work Comenzar a ejecutar el plan en el modo Prometheus
ultrawork / ulw Agrégalo al prompt para activar el modo paralelo de funciones completas

Solución de problemas comunes

P: Después de la instalación, al ejecutaropencodeno se ven las funciones de OmO

Solución: Verifica si el archivo de configuración registró correctamente el plugin:

cat ~/.config/opencode/opencode.json

Verifica quepluginel campo contenga"oh-my-opencode". Si no es así, ejecuta nuevamentebunx oh-my-opencode install。

P: Al ejecutar aparece la advertencia "Using legacy package name"

Solución: Cambiaopencode.jsonel nombre del plugin en ... de"oh-my-opencode"a"oh-my-openagent"：

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

P: El Agente Sisyphus funciona muy mal, se siente igual que un Claude normal

Causa: Es posible que no estés usando el modelo Claude Opus, o que no hayas agregadoultrawork。

Solución：

  1. Confirma que has iniciado sesión en tu cuenta de Claude Pro/Max
  2. Agrega en el promptultraworkla palabra clave
  3. Ejecutabunx oh-my-opencode doctorpara verificar la configuración del modelo

P: La tarea se detiene a mitad de camino

Solución: Sigue indicandoultrawork 继续之前的任务, Sisyphus reanudará el progreso mediante el sistema Todo.

P: Quiero desactivar los datos de telemetría anónima

OmO tiene la telemetría anónima habilitada por defecto (utiliza PostHog; los datos se procesan con hash). Para desactivarla:

export OMO_SEND_ANONYMOUS_TELEMETRY=0
# o 
export OMO_DISABLE_POSTHOG=1
Otras extensiones