스킬

Slack Agent Skill: eve로 Vercel에서 Slack 에이전트 구축하기

Vercel에 Slack 에이전트를 배포하려는 사람에게 맞다. 공식 npx skills add vercel-labs/slack-agent-skill 로 설치하고, Slack 이벤트는 배포 후에야 Connect로 검증된다.

Official source · slack-agent-skill

Install

npx skills add vercel-labs/slack-agent-skill

누구에게 맞나

이 스킬은 Vercel에서 Slack 에이전트를 만들고 배포하려는 사람을 위한 것이다. eve(Vercel의 지속 에이전트 프레임워크)와 Vercel Connect(Slack 자격 증명을 호스팅)와 함께 쓴다. eve 문서는 https://eve.dev/docs Connect 안내는 https://vercel.com/kb/guide/vercel-connect 저장소는 bot token이나 서명 시크릿을 직접 다룰 필요가 없다고 강조한다.

더 잘 맞는 쓰임은 /slack-agent 로 새 프로젝트를 만들거나 기존 프로젝트를 설정하고, 로컬에서 먼저 eve dev 텍스트 UI로 도구·지시·대화를 시험한 뒤 Slack 이벤트는 배포 이후로 미루는 것이다. Slack 서명 시크릿을 직접 보관하고 싶거나, 배포 없이 Slack UI에서 모든 이벤트를 클릭해 끝낼 수 있다고 기대하는 사람에게는 맞지 않는다.

skill을 지원하지 않는 환경에서는 이 설치 명령을 쓰지 마라. ngrok 터널을 필수 단계로 여기지도 마라. 안내에 따르면 Slack 이벤트는 Connect를 통해 배포된 프로젝트로 전달되며 ngrok은 필요 없다.

3분 만에 첫 시도 끝내기

공식 설치 명령은 npx skills add vercel-labs/slack-agent-skill 이다. 저장소 주소는 https://github.com/vercel-labs/slack-agent-skill 이 페이지만 따르라. 문서에 없는 설치기를 만들지 마라.

전제 조건: 현재 어시스턴트가 skill을 지원하고, 버려도 되는 빈 디렉터리나 기존 eve 프로젝트가 있어야 한다. 설치 위치는 어시스턴트의 스킬 디렉터리다. 설치 후 /slack-agent new, /slack-agent configure, /slack-agent deploy, /slack-agent test 가 보이는지 확인하라.

저위험 첫 작업: 먼저 배포하지 마라. 처음부터라면 /slack-agent new 를 먼저 실행한다(eve로 스캐폴드를 만든다). 다만 파일을 쓰기 전에 그 디렉터리가 연습용인지 확인하라. 이미 프로젝트가 있으면 /slack-agent configure 를 쓴다(eve를 자동 감지한다). 성공 신호는 스캐폴드 또는 설정이 끝났고 아직 /slack-agent deploy 를 실행하지 않은 것이다.

로컬 검증은 eve dev TUI로 한다. 도구, 지시, 대화를 시험한다. Slack UI의 이벤트는 배포 후에 Vercel Connect를 통해 프로젝트에 도착한다. Slack 쪽 환경 변수 안내에서 이름이 나온 것은 SLACK_CONNECTOR 뿐이다. 다른 시크릿 자리 표시를 지어내지 마라. /slack-agent test 는 테스트 설정용이며, 로컬 대화가 통한 뒤에 고려하라.

사용 사례

사례 1: 처음부터 스캐폴드. /slack-agent new 는 eve로 새 프로젝트를 만든다. 아직 저장소가 없고 로컬에서 에이전트 구조만 먼저 보고 싶을 때 맞다. 안내에 생성된 파일 목록이 없으므로, 명령이 성공하고 eve 프로젝트가 나타난 것까지만 확인할 수 있다. 쓰기 전에 디렉터리를 확인하라. 대조 페이지는 https://github.com/vercel-labs/slack-agent-skill

사례 2: 기존 프로젝트를 설정하고 로컬/온라인 검증을 나눈다. /slack-agent configure 는 eve를 자동 감지한다. 로컬에서는 eve dev 로 도구, 지시, 대화를 시험하고, Slack 이벤트는 배포 후 Connect로 도착하며 ngrok은 필요 없다. /slack-agent deploy 는 프로덕션에 배포하므로 로컬 TUI를 통과한 뒤에 둔다. Connect가 OAuth, 토큰 로테이션, webhook 검증을 호스팅하며, 이름이 나온 Slack 환경 변수는 SLACK_CONNECTOR 뿐이다. 그 변수의 값 채우기 절차도 프로덕션 롤백도 적혀 있지 않다. Connect 설정이 끝나기 전에 배포하지 마라.

사용 한계

설치 한계: 공식이 적은 것은 npx skills add vercel-labs/slack-agent-skill 뿐이다. 명령 한계: 확인할 수 있는 것은 /slack-agent new, configure, deploy, test 이다. 자격 증명 한계: bot token이나 서명 시크릿을 직접 다룰 필요는 없고, 이름이 나온 Slack 환경 변수는 SLACK_CONNECTOR 뿐이다. 테스트 한계: 로컬 TUI에서 도구, 지시, 대화를 시험하고, Slack 이벤트는 배포 후 Connect로 검증되며 ngrok은 필요 없다. 프레임워크 한계: eve와 Vercel Connect가 명시된 의존성이며 문서는 각각 https://eve.dev/docs 와 https://vercel.com/kb/guide/vercel-connect 이다. 다른 호스팅 플랫폼을 그대로 쓸 수 있다는 보장은 없다.