Eric Task Master

English | 简体中文

Un sistema de automatización de navegador duradero para agentes de IA.

Versión: 2.1.1

Los agentes de IA pueden razonar, planificar y escribir código, pero la ejecución en el navegador suele ser su punto más débil. Los navegadores integrados de los agentes son convenientes para sesiones cortas, pero con frecuencia pierden el estado de inicio de sesión, la continuidad de las tareas y el contexto de recuperación. Los controladores CDP delgados ofrecen acceso rápido de bajo nivel, pero dejan que cada agente reconstruya la orquestación, el seguimiento de progreso, la limpieza y la recuperación de errores para cada trabajo.

Eric Task Master llena ese vacío. Es un runtime de automatización de navegador basado en Playwright que convierte el trabajo web en trabajos duraderos, aislados y observables. Un agente puede iniciar una tarea, dejarla ejecutándose durante horas, reconectarse más tarde, inspeccionar evidencia, recuperarse desde un punto de control y verificar que el navegador se cerró, sin ocupar el navegador cotidiano del usuario ni gastar tokens repetidamente redescubriendo la misma mecánica de ejecución.

AI agent · browser automation · Playwright · MCP server · web automation · computer use · workflow automation · browser agent · headless browser · multi-agent automation

¿Qué puede construir un agente con esto?

Task Master es una base de ejecución general, no un bot específico de un sitio. Combinado con un agente, una Skill especializada o un Task Pack, puede soportar:

• investigación no supervisada, monitoreo y recopilación web respaldada por fuentes;

• trabajo por lotes de larga duración en cientos de páginas sin mantener abierto un turno de agente;

• flujos de trabajo autenticados de back-office, portales, CMS, CRM y cuentas mediante perfiles persistentes aislados;

• trabajos limpios sin inicio de sesión mediante perfiles efímeros desechables;

• agentes locales paralelos de confianza que comparten un catálogo de perfiles gestionado mientras diferentes perfiles activos se ejecutan de forma independiente; las colas de trabajo del mismo perfil se gestionan de forma segura y los registros de tareas siguen siendo atribuibles;

• flujos de trabajo operativos recurrentes invocados por un agente, un programador o un sistema empresarial;

• QA de navegador, verificación de contenido, procesamiento de formularios, carga/descarga de archivos y captura de evidencia;

• Task Packs de producción para operaciones de leads, operaciones de comercio electrónico, investigación de medios, investigación de proveedores, soporte al cliente, verificaciones de cumplimiento o RPA interno.

Esas son posibilidades componibles, no permisos incluidos ni afirmaciones de que todos los sitios web son compatibles. Task Master proporciona el runtime de navegador confiable; una Skill especializada o un Task Pack proporciona la lógica de negocio, la política del sitio, el análisis, los puntos de control, las salidas y la evidencia de finalización.

Related MCP server: CloakBrowser MCP

¿Por qué no usar simplemente un navegador de agente o un script CDP?

Task Master no reemplaza el razonamiento del agente. Le da a ese razonamiento un par de manos de navegador confiables.

El modelo de tres capas

1. Runtime de Task Master — ejecución pura de Playwright, perfiles persistentes y efímeros, colas, tareas duraderas, progreso, recuperación, evidencia y limpieza.

2. Owner Console — una dirección web local fija gestiona perfiles compartidos, agentes conectados, tareas activas, progreso, comandos e informes legibles por humanos. Los usuarios inician sesión directamente dentro de perfiles persistentes aislados de Playwright.

3. MCP + Skills + Task Packs — los agentes reciben una interfaz de tareas compacta y de alto nivel mientras que las capacidades de dominio reutilizables permanecen independientes del runtime central.

Esta separación mantiene la base universal: mejora un motor de ejecución y luego define muchos trabajadores de automatización especializados encima.

Para agentes de IA: un protocolo de arranque fijo

Si un usuario te da esta URL de GitHub, sigue los pasos a continuación en orden. No inventes otro daemon, puerto, lanzador de navegador, controlador o bucle de reintentos.

El repositorio completo es la fuente de verdad del runtime. En una versión de GitHub, eric-task-master-vX.Y.Z.zip es el proyecto completo ejecutable; eric-task-master-skill-vX.Y.Z.zip es solo el adaptador de instrucciones opcional para agentes y no puede ejecutarse por sí solo. SHA256SUMS verifica ambos archivos. Clona la etiqueta correspondiente o descarga el archivo completo del proyecto; no sustituyas el archivo solo de Skill por el runtime.

1. Autentícate en GitHub si el repositorio es privado y luego clona el repositorio completo.

2. Requiere Node.js 20 o más reciente.

3. Lee skills/eric-task-master/SKILL.md. Instala esa carpeta en el directorio de Skills del host cuando el host admita Skills; de lo contrario, síguela en su lugar.

4. Desde la raíz del repositorio ejecuta exactamente:

   node scripts/taskmaster.mjs connect --json

5. connect instala el runtime fijado por lockfile y el Chromium de Playwright correspondiente, migra de forma segura un Manager anterior inactivo, inicia el Manager de loopback, ejecuta pruebas de aceptación con navegador real y registra los hosts MCP locales compatibles. Si un Manager anterior aún tiene trabajo, la migración se detiene sin interrumpirlo.

6. Sigue el nextAction devuelto. Después de corregir la condición previa nombrada, reintenta el mismo comando como máximo una vez; no te desvíes hacia un controlador de reemplazo especulativo.

7. Abre el enlace de Owner Console devuelto una vez. Establece silenciosamente una sesión local persistente; no hay código que escribir ni flujo de vinculación de agente. Marca http://127.0.0.1:19946/dashboard como favorito para uso posterior.

8. Si un host informa registered_pending_restart, pide al usuario que recargue ese host de agente una vez. Si no puede recargarse durante esta ejecución, usa el CLI con alcance con un ID de agente estable para esta tarea solamente, y luego usa MCP para nuevas tareas después del próximo reinicio.

9. Elige una ruta de operación y mantente en ella para la tarea:

   • si el host cargó el servidor MCP registrado, llama a taskmaster_status y luego a taskmaster_profiles_list;

   • si el host informa needs_adapter, o no puede recargar un registro pendiente durante esta ejecución, usa el CLI fijo desde la raíz del repositorio. Mantén un ID de agente estable y distinto en cada comando con alcance:

     node scripts/taskmaster.mjs status --agent-id STABLE_ID --agent-name AGENT_NAME --json
     node scripts/taskmaster.mjs profiles list --agent-id STABLE_ID --agent-name AGENT_NAME --json

10. Cuando el estado y el descubrimiento de perfiles tengan éxito, pregunta al usuario qué tarea de navegador quiere ejecutar. No mezcles identidades de MCP y CLI durante una misma tarea.

Solicitud copiable para un nuevo agente:

Instala e inicia https://github.com/npcworkspace-cmyk/eric-task-master. Clona el repositorio completo, lee o instala skills/eric-task-master y ejecuta solo node scripts/taskmaster.mjs connect --json. No inventes otro controlador o puerto. Usa la ruta MCP cargada cuando sea compatible; en needs_adapter, sigue la ruta CLI fija de la Skill con un ID de agente estable y distinto. Devuelve el enlace de Owner Console; después de que el estado y el descubrimiento de perfiles tengan éxito, pregunta qué tarea quiero ejecutar.

Uso cotidiano

Después del primer arranque, el usuario debería poder preguntar de forma natural:

Usa Eric Task Master con un perfil efímero y comportamiento adaptativo para investigar estos sitios, informa el progreso, guarda evidencia y cierra cada ventana de tarea al terminar.

El agente entonces usa un bucle duradero: descubre un tipo de tarea, inicia una vez con una clave de idempotencia, conserva el ID de tarea, espera o se reconecta a ese ID, inspecciona los diagnósticos cuando se requiere atención, y acepta la finalización solo después de verificar la evidencia y la limpieza.

Cada inicio de tarea devuelve un enlace de Owner Console en el que se puede hacer clic y centrado en esa tarea. El primer enlace establece silenciosamente la cookie local del Owner; las visitas posteriores pueden usar la dirección fija marcada como favorita. Si el usuario dice "启动任务面板", usa MCP taskmaster_dashboard_open o CLI node scripts/taskmaster.mjs dashboard-open [TASK_ID] --agent-id STABLE_ID --agent-name AGENT_NAME --json, y luego devuelve el enlace. Task Master no abre automáticamente un navegador del sistema operativo.

Perfiles

• persistent — estado reutilizable aislado para trabajo con inicio de sesión y recurrente; ábrelo desde el Dashboard e inicia sesión directamente en su ventana de Playwright;

• ephemeral / 隐身临时 — un navegador limpio no persistente para cada tarea sin inicio de sesión, destruido después de la limpieza.

Los nuevos perfiles persistentes usan por defecto el canal estable local de Chrome y el comportamiento fijo human. Los nuevos perfiles efímeros usan por defecto el Chromium fijado por el proyecto y el comportamiento adaptive, con fast, adaptive o human seleccionables en el perfil. El motor es inmutable y nunca retrocede automáticamente. Las ventanas manuales de perfiles persistentes siempre son visibles; headless afecta solo a las ejecuciones de tareas.

Comportamiento

• fast — una política opcional priorizando la velocidad para perfiles efímeros y trabajo determinista con muchos datos;

• human — cadencia limitada de mouse, escritura, desplazamiento y lectura;

• adaptive — comienza rápido y se vuelve temporalmente cauteloso o a ritmo humano después de señales de páginas dinámicas, oclusión, tiempo de espera, navegación incierta, fallo de acción o limitación de velocidad.

El ritmo humano es una política de confiabilidad, no una promesa de eludir los controles del sitio web o proteger una cuenta de la aplicación de la plataforma. El comportamiento se selecciona en el perfil; el inicio de tareas no acepta una anulación de comportamiento.

Banco de trabajo multiagente

• Los perfiles son compartidos por todos los agentes locales de confianza; no hay un campo sin sentido de "creador de perfil". Un perfil aún tiene un arrendamiento activo, por lo que dos agentes no pueden corromper el mismo estado de inicio de sesión.

• La Owner Console muestra qué agentes están registrados, en línea, fuera de línea, trabajando o revocados, además de sus tareas activas, perfiles y profundidad de cola.

• El banco de trabajo de tareas muestra qué está haciendo Playwright ahora, progreso, límites, estado de recuperación y una línea de tiempo. El Owner puede pausar, reanudar, terminar, revisar la entrada en cola o enviar una instrucción de preguntar/modificar.

• Los comandos son duraderos y verificados por revisión. Un agente activo los recibe inmediatamente a través de su bucle de espera/buzón; un agente fuera de línea los recibe después de reconectarse. Task Master no finge que puede despertar un proceso de host completamente cerrado.

• El trabajo completado se abre en el informe legible por humanos del agente. El código, los registros, las capturas de pantalla, los artefactos y los diagnósticos permanecen disponibles como evidencia secundaria en lugar de convertirse en el "resultado".

Construye trabajadores de producción especializados

Mantén la lógica del sitio y de negocio fuera del núcleo:

node scripts/taskmaster.mjs task-packs scaffold ./my-pack --name my-pack --recipe paginated-list --json
node scripts/taskmaster.mjs task-packs validate ./my-pack --json
node scripts/taskmaster.mjs task-packs install ./my-pack --json

Un Task Pack define tipos de tareas reutilizables. Cinco plantillas de producción—página única, lista paginada, lista/detalle, lote reanudable y flujo de formulario—eliminan la mayor parte del código repetitivo, mientras que la verificación previa valida los módulos antes del registro. Una Skill especializada enseña al agente cuándo usarlos, cómo interpretar los resultados y qué reglas de plataforma se aplican. Ninguna de ellas debe reconstruir el inicio del Manager, el ciclo de vida del navegador, el seguimiento de tareas, los diagnósticos o la limpieza. Publica un nuevo nombre de tipo de tarea, verifícalo y luego deprecia el tipo anterior con un puntero de reemplazo; no sobrescribas lógica de producción divergente en su lugar.

Integración de hosts

El runtime del navegador sigue siendo utilizable a través de su CLI fija y con alcance de agente cuando no hay un adaptador MCP específico del host. Cada comando CLI con alcance requiere un --agent-id estable y distinto para cada agente independiente; todos los agentes comparten el catálogo de perfiles, mientras que reutilizar un ID comparte intencionalmente el libro de tareas y el buzón del Owner de esa identidad. Consulta docs/MCP-HOSTS.md para la ruta completa de comandos sin MCP y su límite local de confianza.

Verificación y apagado

Ejecute la puerta local completa:

npm run check

Cubre límites estáticos, pruebas unitarias/de integración/seguridad, aceptación real con Chromium y cargas de trabajo concurrentes, de fallos y de reinicio. CI de GitHub verifica Windows, macOS y Linux en Node.js 20 y 22. Las versiones se autorizan manualmente, están protegidas por sumas de comprobación y son inmutables.

Detenga el Manager de forma segura:

node scripts/taskmaster.mjs manager stop --json

Comience con skills/eric-task-master/SKILL.md. Los detalles técnicos se encuentran en ARCHITECTURE.md, docs/MCP.md y docs/RELEASE-GATE.md.

Licencia

MIT. Utilice, modifique, distribuya y cree Skills y Task Packs abiertos o propietarios sobre Task Master.