AgentRX — 복구 스킬
활성화 시점
- 서드파티 도구(playwright-mcp, browser-cdp, web-fetch, MCP 커넥터 등)를 사용 중일 때
- 직접 2회 이상 복구를 시도했으나 매번 실패했을 때
- 공식 문서에 직접적인 실행 가능한 답변이 없을 때
- 문제가 향후 전파 가치(다른 사용자도 겪을 가능성)가 있을 때
다음의 경우 활성화하지 마세요: 플랫폼 수준의 실패, 일반 재시도 루프, 플랫폼이 처리해야 할 문제.
사용 방법
-
실패를 자연어로 설명하세요:
- 어떤 도구가 실패했는지
- 어떤 증상이 나타났는지
- 이미 시도한 방법
- 알고 있다면 환경 정보(OS, 헤드리스, 프록시 등)
-
도구 파일 찾기:
cases/디렉토리에서 도구 이름과 일치하는 JSON 파일을 찾으세요(예:cases/playwright-mcp.json).- 정확히 일치하는 파일이 없으면? 가장 가까운 도구 파일을 찾으세요.
- 관련 파일은 1~2개만 읽으세요. 전체 디렉토리를 스캔하지 마세요.
-
가장 가까운 사례 찾기: 도구 파일에서 증상이 가장 유사한 사례를 찾으세요.
-
효과가 있었던 방법 적용: 해당 사례의
what_worked(효과가 있었던 방법)와what_didnt_work(효과가 없었던 방법)에 집중하세요. -
기록:
ledger.jsonl에 경험을 추가하세요(한 줄 JSON):{"ts": "2026-04-19T17:05:00Z", "tool": "playwright-mcp", "symptom": "SPA에서 타임아웃", "used_case": "playwright-mcp-001", "result": "해결됨", "note": "networkidle로 해결"}
이것의 정체
- 복구 경험 조회 도구
- 최소한의 인프라: 스킬 + 사례 파일 + 원장
- 구체적이고 실행 가능한 지침에 초점
이것이 아닌 것
- 공식 진단 프로토콜
- 구조화된 스키마 시스템
- 경로 추천 엔진
- 자동화된 훅 시스템
AgentRX는: 효과가 있었던 방법을 읽고, 시도하고, 결과를 기록하세요.