AgentHandover – Mac 워크플로우를 AI 실행 가능한 스킬로

무엇인가

AgentHandover 는 macOS 전용 애플리케이션으로, 컴퓨터에서 반복적으로 수행하는 작업을 지켜보고 각 작업을 스킬 (워크플로우, 목적, 결정 로직, 가드레일, 작성 스타일의 구조화된 설명) 로 변환하며, 해당 스킬을 Claude Code, Codex, OpenClaw, Hermes 또는 MCP 프로토콜을 사용하는 모든 도구와 같은 AI 에이전트가 사용할 수 있도록 합니다.

왜 중요한가

• 수제 프롬프트 불필요 – 평소처럼 작업하면 됩니다. 앱이 클릭, 키 입력, 화면 내용을 기록합니다.
• Why 중심 – 생성된 스킬은 단계뿐만 아니라 암묵적으로 사용하는 전략 (선택 기준, 가드레일, 음성) 도 포착합니다.
• 지속적인 개선 – 에이전트가 스킬을 실행한 후 보고합니다. 성공적인 실행은 신뢰도를 높이고, 편차는 질문을 유발하며, 스킬을 승인하거나 수정할 수 있습니다.
• 로컬 우선 및 프라이빗 – 모든 녹화, 임베딩, 지식 기반은 Mac에 남습니다. 에이전트가 저장된 '메모리'를 검색할 수 있는지 여부를 결정하는 것은 오직 사용자뿐입니다.

핵심 개념

개념	기능
스킬	워크플로우를 설명하는 Markdown 문서: 전략, 순서 단계, 선택 기준, 가드레일, 음성, 신뢰도 점수, 미해결 질문.
메모리	본 모든 화면의 개인적이고 검색 가능한 아카이브. 화면은 Google의 EmbeddingGemma 2 (Ollama 경유) 로 임베딩되며 벡터 + 짧은 수정된 설명으로 유지됩니다. 스크린샷은 임베딩 후 삭제됩니다.
Commonplace	사용자 또는 연결된 에이전트가 스킬, 메모리 순간, 일일 요약, 사용자 프로필을 쿼리할 수 있는 통합 검색 UI (및 CLI / REST API).
지식 원장	스킬의 어느 부분이 알려짐, 가설, 알 수 없음인지 추적하고 주간 질문 예산을 추진합니다.
MCP 서버	AgentHandover와 MCP 호환 에이전트 간의 통신을 중재하는 작은 로컬 서버.

작동 방식 – 사용자 흐름

1. 설치 – .pkg 릴리스를 다운로드하고 온보딩 마법사를 실행합니다 (화면 캡처, 접근성 권한 부여, 필요한 Ollama 모델 설치).
2. 작업 기록 – 메뉴 바에서 Record 를 클릭하고 워크플로우를 한 번 수행한 후 녹화를 중지합니다.
3. 최대 3개의 질문에 답변 – 앱이 추론할 수 없었던 것 (예: 시작 조건, 종료 조건, 모호한 단계) 을 묻습니다.
4. 검토 및 승인 – 초안 스킬이 표시됩니다. 단계, 전략, 가드레일을 확인한 후 Approve for Agents 를 클릭합니다.
5. 에이전트 연결 – 한 줄 명령 agenthandover connect claude-code (또는 codex, openclaw, hermes). 에이전트는 MCP를 통해 스킬을 받습니다.
6. 실행 – 에이전트 채팅에서 스킬을 호출합니다 (/reddit-community-marketing 또는 자연스러운 설명). 에이전트가 단계를 실행하고 진행 상황을 보고하며 스킬의 신뢰도가 업데이트됩니다.

예시 스킬 (발췌)

Reddit Community Marketing
Daily engagement workflow – 6 steps – 4 sessions learned

STRATEGY
Browse target subreddits for posts about marketing tools or growth-hacking. Engage with high-signal posts (10+ comments, <48 h old, not promotional). Write authentic replies: acknowledge → share experience → mention product.

STEPS
1. Open Reddit → r/startups
2. Scan posts – skip promotional, skip <10 comments
3. Open high-signal post, read top comments
4. Write reply: acknowledge → experience → mention product
5. Submit, verify not auto-removed
6. Repeat for r/marketing, r/growthacking (max 5/day)

SELECTION CRITERIA   GUARDRAILS
- 10+ comments      - Max 5 replies/day
- Not promotional   - Never identical phrasing
- <48 h old         - Never reply to own posts

VOICE & STYLE
Tone: casual, short punchy sentences, occasional emoji.

스킬에는 신뢰도 (89%) 와 소요 시간 (약 15분) 도 저장됩니다.

메모리 및 검색 (Commonplace)

• 모든 화면은 EmbeddingGemma 2 로 임베딩됩니다 (화면당 약 0.5초).
• 메뉴 바에서 검색하거나 agenthandover memory search "invoice from Acme" 로 검색하거나 에이전트가 쿼리하도록 할 수 있습니다 (agenthandover memory agents on).
• 화면은 작은 암호화된 썸네일로 7일 동안 유지되며, 벡터와 수정된 설명은 1년 동안 유지됩니다.
• 개인 정보 보호 영역을 통해 비밀번호 관리자, 은행 사이트 등을 캡처에서 제외할 수 있습니다.

자동화 사용 사례

• 연구 – 소스를 스캔하고 사실을 추출하며 요약을 작성합니다.
• 커뮤니티 참여 – 매일 Reddit/Discord에 내 목소리로 게시합니다.
• 지원 분류 – 티켓을 읽고 매크로를 선택하며 답변을 작성합니다.
• 데이터 추출 – 대시보드나 스프레드시트에서 구조화된 데이터를 가져옵니다.
• 운영 체크리스트 – 배포, 릴리스, 상태 업데이트.
• 개인 스킬 라이브러리 – 에이전트가 수행하길 원하는 모든 반복 가능한 워크플로우.

설치 및 빠른 시작 (요약)

# 1. GitHub 릴리스 페이지에서 .pkg를 설치합니다
# 2. 작업을 기록합니다
# 3. 자동 생성된 질문에 답변합니다
# 4. 초안 스킬을 승인합니다
# 5. 에이전트를 연결합니다
#    agenthandover connect claude-code
# 6. Claude Code에서 실행합니다: /reddit-community-marketing

CLI는 고급 제어를 위해 agenthandover install, agenthandover memory forget, agenthandover search … 및 list_ready_skills 도 제공합니다.

개인 정보 보호 및 보안

• 모든 데이터는 기기에 남습니다. 에이전트가 메모리를 검색할 수 있는지 여부를 제어하는 것은 사용자뿐입니다.
• 화면은 임베딩 후 삭제됩니다. 썸네일은 키체인에 저장된 키로 암호화됩니다.
• 앱은 macOS 개인 정보 보호 영역을 존중하며 메모리 캡처를 수동으로 잊거나 일시 중지할 수 있습니다.

만든 사람은?

Sandro Andrić (BySandro) 가 만들었습니다. README에 로고와 개인 사이트 링크가 있습니다. 디스코드 커뮤니티에서 지원을 받을 수 있습니다.

---

결론: AgentHandover는 반복 가능한 데스크톱 워크플로우를 구조화된 AI 읽기 가능한 스킬로 변환하고, 작업의 검색 가능한 시각적 메모리를 저장하며, 로컬 AI 에이전트가 해당 스킬을 실행하면서 실행에서 지속적으로 학습할 수 있도록 하는 진정한 macOS 중심 도구입니다. AI 에이전트 자동화 공간에 정확히 위치합니다.