Eric Task Master

English | 简体中文

AI 에이전트를 위한 지속 가능한 브라우저 자동화 작업 시스템.

버전: 2.1.1

AI 에이전트는 추론하고, 계획하고, 코드를 작성할 수 있지만, 브라우저 실행은 종종 가장 약한 고리입니다. 내장 에이전트 브라우저는 짧은 세션에는 편리하지만 로그인 상태, 작업 연속성, 복구 컨텍스트를 흔히 잃습니다. 경량 CDP 컨트롤러는 빠른 저수준 접근을 제공하지만, 각 에이전트가 작업마다 오케스트레이션, 진행 추적, 정리, 오류 복구를 다시 구축해야 합니다.

Eric Task Master는 그 격차를 메웁니다. 이는 웹 작업을 지속 가능하고 격리된 관찰 가능한 작업으로 전환하는 Playwright 우선 브라우저 자동화 런타임입니다. 에이전트는 작업을 시작하고, 몇 시간 동안 실행되도록 두고, 나중에 다시 연결하고, 증거를 검사하고, 체크포인트에서 복구하고, 브라우저가 닫혔는지 확인할 수 있습니다. 사용자의 일상 브라우저를 점유하거나 동일한 실행 메커니즘을 재발견하는 데 토큰을 반복적으로 소비하지 않으면서 말입니다.

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

에이전트는 무엇을 만들 수 있나요?

Task Master는 특정 사이트 전용 봇이 아닌 일반 실행 기반입니다. 에이전트, 전문화된 Skill 또는 Task Pack과 결합하여 다음을 지원할 수 있습니다:

• 무인 연구, 모니터링, 소스 기반 웹 수집;

• 에이전트 턴을 열어 두지 않고 수백 개 페이지에 걸친 장기 배치 작업;

• 격리된 영구 프로필을 통한 인증된 백오피스, 포털, CMS, CRM, 계정 워크플로우;

• 일회용 임시 프로필을 통한 깨끗한 로그인 없는 작업;

• 관리되는 프로필 카탈로그를 공유하는 병렬 신뢰 로컬 에이전트가 서로 다른 활성 프로필을 독립적으로 실행; 동일 프로필 작업은 안전하게 대기열에 쌓이고 작업 기록은 귀속성을 유지;

• 에이전트, 스케줄러 또는 비즈니스 시스템에 의해 호출되는 반복 운영 워크플로우;

• 브라우저 QA, 콘텐츠 검증, 양식 처리, 파일 업로드/다운로드, 증거 캡처;

• 리드 운영, 이커머스 운영, 미디어 조사, 공급업체 조사, 고객 지원, 규정 준수 검사 또는 내부 RPA를 위한 프로덕션 Task Pack.

이것들은 구성 가능한 가능성일 뿐, 모든 웹사이트가 지원된다는 번들 권한이나 주장이 아닙니다. Task Master는 신뢰할 수 있는 브라우저 런타임을 제공하고, 전문화된 Skill 또는 Task Pack이 비즈니스 로직, 사이트 정책, 파싱, 체크포인트, 출력, 완료 증거를 제공합니다.

Related MCP server: CloakBrowser MCP

에이전트 브라우저나 CDP 스크립트를 사용하지 않는 이유는 무엇인가요?

Task Master는 에이전트의 추론을 대체하지 않습니다. 그 추론에 신뢰할 수 있는 브라우저 손을 제공합니다.

3계층 모델

1. Task Master 런타임 — 순수 Playwright 실행, 영구 및 임시 프로필, 대기열, 지속 가능한 작업, 진행 상황, 복구, 증거, 정리.

2. Owner Console — 하나의 고정 로컬 웹 주소가 공유 프로필, 연결된 에이전트, 활성 작업, 진행 상황, 명령, 사람이 읽을 수 있는 보고서를 관리합니다. 사용자는 격리된 영구 Playwright 프로필 내에서 직접 로그인합니다.

3. MCP + Skills + Task Packs — 에이전트는 간결한 고수준 작업 인터페이스를 받는 반면, 재사용 가능한 도메인 기능은 핵심 런타임과 독립적으로 유지됩니다.

이 분리는 기반을 보편적으로 유지합니다. 하나의 실행 엔진을 개선한 다음 그 위에 많은 전문화된 자동화 작업자를 정의하십시오.

AI 에이전트를 위한: 하나의 고정 부트스트랩 프로토콜

사용자가 이 GitHub URL을 제공하면 아래 단계를 순서대로 따르십시오. 다른 데몬, 포트, 브라우저 실행기, 컨트롤러 또는 재시도 루프를 만들지 마십시오.

전체 저장소는 런타임의 소스 오브 트루스입니다. GitHub 릴리스에서 eric-task-master-vX.Y.Z.zip은 완전한 실행 가능한 프로젝트이고, eric-task-master-skill-vX.Y.Z.zip은 선택적 에이전트 지침 어댑터일 뿐이며 자체적으로 실행할 수 없습니다. SHA256SUMS는 두 아카이브를 검증합니다. 일치하는 태그를 클론하거나 완전한 프로젝트 아카이브를 다운로드하십시오. Skill 전용 아카이브를 런타임으로 대체하지 마십시오.

1. 저장소가 비공개인 경우 GitHub에 인증한 다음 전체 저장소를 클론하십시오.

2. Node.js 20 이상이 필요합니다.

3. skills/eric-task-master/SKILL.md를 읽으십시오. 호스트가 Skills를 지원하면 해당 폴더를 호스트의 Skill 디렉터리에 설치하고, 그렇지 않으면 그 자리에서 따르십시오.

4. 저장소 루트에서 정확히 다음을 실행하십시오:

   node scripts/taskmaster.mjs connect --json

5. connect는 lockfile로 고정된 런타임과 일치하는 Playwright Chromium을 설치하고, 유휴 상태의 이전 Manager를 안전하게 마이그레이션하며, 루프백 Manager를 시작하고, 실제 브라우저 수락 테스트를 실행하며, 지원되는 로컬 MCP 호스트를 등록합니다. 이전 Manager가 아직 작업 중이면 마이그레이션은 중단하지 않고 중지됩니다.

6. 반환된 nextAction을 따르십시오. 명명된 전제 조건을 수정한 후 동일한 명령을 최대 한 번 재시도하십시오. 추측성 대체 컨트롤러로 분기하지 마십시오.

7. 반환된 Owner Console 링크를 한 번 여십시오. 이는 조용히 영구 로컬 세션을 설정합니다. 입력할 코드나 에이전트 바인딩 흐름이 없습니다. 나중에 사용하기 위해 http://127.0.0.1:19946/dashboard를 북마크하십시오.

8. 호스트가 registered_pending_restart를 보고하면 사용자에게 해당 에이전트 호스트를 한 번 다시 로드하도록 요청하십시오. 이 실행 중에 다시 로드할 수 없으면 이 작업에 대해서만 하나의 안정적인 에이전트 ID로 범위가 지정된 CLI를 사용하고, 다음 재시작 후 새 작업에는 MCP를 사용하십시오.

9. 하나의 운영 경로를 선택하고 작업 동안 유지하십시오:

   • 호스트가 등록된 MCP 서버를 로드한 경우 taskmaster_status를 호출한 다음 taskmaster_profiles_list를 호출하십시오;

   • 호스트가 needs_adapter를 보고하거나 이 실행 중에 보류 중인 등록을 다시 로드할 수 없는 경우 저장소 루트의 고정 CLI를 사용하십시오. 모든 범위 지정 명령에 하나의 안정적이고 고유한 에이전트 ID를 유지하십시오:

     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. 상태 및 프로필 검색이 성공하면 사용자에게 어떤 브라우저 작업을 실행할지 물어보십시오. 하나의 작업 동안 MCP와 CLI ID를 혼합하지 마십시오.

새 에이전트를 위한 복사 가능한 요청:

https://github.com/npcworkspace-cmyk/eric-task-master를 설치하고 시작하십시오. 전체 저장소를 클론하고, skills/eric-task-master를 읽거나 설치하고, node scripts/taskmaster.mjs connect --json만 실행하십시오. 다른 컨트롤러나 포트를 만들지 마십시오. 지원되는 경우 로드된 MCP 경로를 사용하고, needs_adapter에서는 하나의 안정적이고 고유한 에이전트 ID로 Skill의 고정 CLI 경로를 따르십시오. Owner Console 링크를 반환하십시오. 상태 및 프로필 검색이 성공한 후 실행하려는 작업을 물어보십시오.

일상적인 사용

첫 부트스트랩 후 사용자는 자연스럽게 요청할 수 있어야 합니다:

Eric Task Master를 임시 프로필과 적응형 동작으로 사용하여 이 사이트들을 조사하고, 진행 상황을 보고하고, 증거를 저장하고, 완료되면 모든 작업 창을 닫으십시오.

그런 다음 에이전트는 하나의 지속 가능한 루프를 사용합니다: 작업 유형을 발견하고, 멱등성 키로 한 번 시작하고, 작업 ID를 유지하고, 해당 ID에 대기하거나 다시 연결하고, 주의가 필요할 때 진단을 검사하고, 증거와 정리가 검증된 후에만 완료를 수락합니다.

모든 작업 시작은 해당 작업에 초점을 맞춘 클릭 가능한 Owner Console 링크를 반환합니다. 첫 번째 링크는 조용히 로컬 Owner 쿠키를 설정합니다. 이후 방문은 고정된 북마크 주소를 사용할 수 있습니다. 사용자가 “启动任务面板”라고 말하면 MCP taskmaster_dashboard_open 또는 CLI node scripts/taskmaster.mjs dashboard-open [TASK_ID] --agent-id STABLE_ID --agent-name AGENT_NAME --json을 사용한 다음 링크를 반환하십시오. Task Master는 운영 체제 브라우저를 자동으로 열지 않습니다.

프로필

• 영구 — 로그인 및 반복 작업을 위한 격리된 재사용 가능 상태; 대시보드에서 열고 Playwright 창에서 직접 로그인하십시오;

• ephemeral / 隐身临时 — 각 로그인 없는 작업을 위한 깨끗한 비영구 브라우저, 정리 후 파괴됩니다.

새 영구 프로필은 로컬 안정 Chrome 채널과 고정 human 동작을 기본으로 합니다. 새 임시 프로필은 프로젝트에 고정된 Chromium과 adaptive 동작을 기본으로 하며, 프로필에서 fast, adaptive 또는 human을 선택할 수 있습니다. 엔진은 불변이며 자동으로 폴백하지 않습니다. 수동 영구 프로필 창은 항상 표시됩니다. headless는 작업 실행에만 영향을 미칩니다.

동작

• fast — 임시 프로필 및 결정적이고 데이터가 많은 작업을 위한 선택적 속도 우선 정책;

• human — 제한된 마우스, 타이핑, 스크롤, 읽기 속도;

• adaptive — 빠르게 시작하고 동적 페이지 신호, 폐색, 시간 초과, 불확실한 탐색, 작업 실패 또는 속도 제한 후 일시적으로 신중하거나 인간 속도로 전환됩니다.

인간 속도는 신뢰성 정책이지, 웹사이트 제어를 우회하거나 플랫폼 집행으로부터 계정을 보호하겠다는 약속이 아닙니다.

동작은 프로필에서 선택됩니다. 작업 시작은 동작 재정의를 허용하지 않습니다.

다중 에이전트 워크벤치

• 프로필은 모든 신뢰 로컬 에이전트가 공유합니다. 의미 없는 “프로필 생성자” 필드는 없습니다. 프로필에는 여전히 하나의 활성 임대가 있으므로 두 에이전트가 동일한 로그인 상태를 손상시킬 수 없습니다.

• Owner Console은 등록, 온라인, 오프라인, 작업 중 또는 해지된 에이전트와 활성 작업, 프로필, 대기열 깊이를 표시합니다.

• 작업 워크벤치는 Playwright가 현재 수행 중인 작업, 진행 상황, 제한, 복구 상태, 타임라인을 표시합니다. 소유자는 일시 중지, 재개, 종료, 대기 중인 입력 수정 또는 ask/modify 지시를 보낼 수 있습니다.

• 명령은 지속 가능하고 개정 검사됩니다. 활성 에이전트는 대기/받은 편지함 루프를 통해 즉시 수신하고, 오프라인 에이전트는 다시 연결한 후 수신합니다. Task Master는 완전히 닫힌 호스트 프로세스를 깨울 수 있다고 주장하지 않습니다.

• 완료된 작업은 에이전트의 사람이 읽을 수 있는 보고서로 열립니다. 코드, 로그, 스크린샷, 아티팩트, 진단은 “결과”가 아닌 보조 증거로 계속 사용할 수 있습니다.

전문화된 프로덕션 작업자 구축

사이트 및 비즈니스 로직을 핵심 외부에 유지하십시오:

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

Task Pack은 재사용 가능한 작업 유형을 정의합니다. 단일 페이지, 페이지 매김 목록, 목록/상세, 재개 가능한 배치, 양식 워크플로우라는 다섯 가지 프로덕션 스캐폴드가 대부분의 보일러플레이트를 제거하며, 사전 검증은 등록 전에 모듈을 검증합니다. 전문화된 Skill은 에이전트에게 언제 사용할지, 결과를 해석하는 방법, 적용되는 플랫폼 규칙을 가르칩니다. 둘 다 Manager 시작, 브라우저 수명 주기, 작업 추적, 진단 또는 정리를 다시 구축해서는 안 됩니다. 새 작업 유형 이름을 게시하고, 검증한 다음, 대체 포인터로 이전 유형을 더 이상 사용하지 않도록 지정하십시오. 분기된 프로덕션 로직을 그 자리에서 덮어쓰지 마십시오.

호스트 통합

호스트별 MCP 어댑터를 사용할 수 없을 때 브라우저 런타임은 고정된 에이전트 범위 CLI를 통해 계속 사용할 수 있습니다. 모든 범위 지정 CLI 명령은 각 독립 에이전트에 대해 안정적이고 고유한 --agent-id를 요구합니다. 모든 에이전트는 프로필 카탈로그를 공유하지만, ID를 재사용하면 의도적으로 해당 ID의 작업 원장과 Owner 받은 편지함을 공유합니다. 전체 비-MCP 명령 경로와 신뢰 로컬 경계는 docs/MCP-HOSTS.md를 참조하십시오.

검증 및 종료

전체 로컬 게이트를 실행합니다:

npm run check

정적 경계, 단위/통합/보안 테스트, 실제 Chromium 승인 테스트, 동시성/장애/재시작 워크로드를 포함합니다. GitHub CI는 Node.js 20 및 22에서 Windows, macOS, Linux를 검증합니다. 릴리스는 수동으로 승인되며, 체크섬으로 보호되고, 불변입니다.

Manager를 안전하게 중지합니다:

node scripts/taskmaster.mjs manager stop --json

skills/eric-task-master/SKILL.md에서 시작하세요. 기술 세부 사항은 ARCHITECTURE.md, docs/MCP.md, docs/RELEASE-GATE.md에 있습니다.

라이선스

MIT. Task Master 기반으로 오픈 또는 독점 Skills 및 Task Packs를 사용, 수정, 배포, 구축할 수 있습니다.