자연어로 기업위챗 사무를 조작하기

누구에게 맞나

이미 에이전트에서 기업 사무를 다루며 자연어로 기업위챗의 메시지, 메일, 문서, 할 일, 일정, 회의, 미반 또는 주소록에 닿아야 하면 이 스킬이 맞다. 공식은 이를 기업위챗 CLI 스위트로 쓰며 기업 사무 효율을 올리기 위한 것이지 또 하나의 독립 콘솔을 여는 것이 아니다.

WorkBuddy, CodeBuddy, MiniMax Code, Kimi Work, Codex, Cursor 등 플랫폼을 지명하고 한 줄 명령으로 이 기기에 설치된 플랫폼을 자동 감지한 뒤 설치를 마친다. 그 환경에 설치할 수 있다는 뜻일 뿐, 그 이름 안에서만 일한다는 뜻이 아니며 다른 환경이 제외된다고도 쓰지 않았다.

동시에 만족해야 한다. 이 기기는 macOS（x64/arm64）, Linux（x64/arm64） 또는 Windows（x64）이고, Node.js는 18 이상이며, 기업위챗 계정이 있다. 계정이 없으면 최초 자격 증명 설정을 끝낼 수 없다. Node 버전이 부족하면 설치 전제조차 성립하지 않는다.

더 맞는 사람은 위 플랫폼 중 하나에서 이미 작업을 낼 수 있고, 먼저 읽기 전용 동작으로 기업위챗 측이 데이터를 돌려주는지 확인하고 싶은 사람이다. 바로 단체 메시지이나 일정 변경이 아니다. 공식 설명은

https://github.com/wecomteam/wecom-unified

3분 만에 첫 시도 마치기

공식 설치 경로는 이것만 쓰고 다른 설치기를 병렬로 시도하지 마라.

npx skills add WecomTeam/wecom-unified -y -g

먼저 터미널에서 Node.js가 18 이상인지, 이 기기에 쓸 수 있는 기업위챗 계정이 있는지 확인하라. 그다음 이미 설치된 지원 플랫폼 환경에서 위 명령을 실행하라. 공식 설명은 한 줄 명령이 설치된 플랫폼을 자동 감지하고 설치를 마친다는 것이다.

설치 위치는 그 명령이 감지한 플랫폼에 따라 쓴다. 페이지에 손으로 복사할 디렉터리는 없다. 설치 후 에이전트는 기업위챗 조작 능력을 자동으로 얻는다. 첫 사용 때 스킬은 필요한 CLI 도구를 자동 검사해 설치하고 자격 증명 설정을 안내한다. 보내기, 새로 만들기, 업로드 전에 그 안내를 끝내고 설정 성공을 확인하라.

첫 작업은 위험이 낮고 대조할 수 있는 읽기로 골라라. 지원되는 에이전트에서 자연어로 주소록 구성원 정보를 요청하거나 기존 문서를 읽거나 문서 검색을 하라. 먼저 봇 능동 알림, 메일 보내기, 할 일 생성, 미반 파일 업로드를 하지 마라.

관찰 가능한 성공 신호는 두 층이다. 첫째: 스킬이 CLI 부족이나 미완료 자격 증명에서 멈추지 않는다. 둘째: 에이전트가 주소록 구성원 정보, 또는 기존 문서 내용이나 검색 결과를 돌려주고 미설치·미설정·권한 없음을 보고하지 않는다.

사용 사례

사례 1: 먼저 문서를 보고 새로 만들지 결정한다.

공식은 문서 생성과 읽기, 문서 검색을 지원한다고 쓴다. 첫 시도는 읽기 또는 검색에 눌러라. 에이전트에게 아는 문서를 열게 하거나 키워드로 문서를 검색하게 하고, 돌아온 제목과 본문 조각이 기업위챗에서 보는 것과 비슷한지 대조하라. 이 단계가 안정된 뒤에만 문서 생성을 고려하라. 페이지에 문서 번호, 공간 이름, 명령줄 스위치는 없다. 확인할 수 있는 범위는 이 문서 동작이 자연어로 트리거될 수 있다는 것까지다.

사례 2: 먼저 회의 정보를 가져온 뒤 예약을 고려한다.

공식은 일정 생성과 관리, 예약, 회의 정보 가져오기를 지원한다고 쓴다. 첫 시도는 회의 정보 가져오기 또는 기존 일정 보기만 하라. 돌아온 시간과 주제를 확인한 뒤에 일정 생성이나 회의 예약을 이야기하라. 마찬가지로 페이지는 회의 필드 템플릿이나 예약 인자를 쓰지 않았다. 근거는 이 일정·회의 동작이 존재한다는 것까지이며 구체 폼까지는 덮지 않는다.

두 사례 모두 같은 설치 경로와 최초 자격 증명 안내 위에 있다. 메일 보내기, 할 일 후속, 미반 파일 업로드도 능력 인벤토리에 있지만 기업 측 데이터를 바꾸므로 첫 시도로 맞지 않다.

사용 경계

실행 면은 macOS（x64/arm64）, Linux（x64/arm64）, Windows（x64）만 쓰고 Node.js 18 이상과 기업위챗 계정을 요구한다. 하나라도 없으면 설치 또는 최초 자격 증명이 멈출 수 있다.

능력은 메시지, 메일, 문서, 할 일, 일정, 회의, 미반, 주소록을 덮고 봇 능동 알림, 미반 파일 업로드와 가져오기, 메일 보내기와 가져오기, 주소록 구성원 정보 가져오기를 지명한다. 쓰기 계열(보내기, 생성, 예약, 업로드, 후속)은 기업위챗 데이터를 바꾼다. 먼저 읽기 계열로 권한을 확인하라.

페이지는 호출 할당량, 가시 범위, 다중 기업 전환을 쓰지 않았고 기업위챗 계정이 없을 때의 대체 경로도 쓰지 않았다. 공식이 보장하는 것은 설치와 자격 증명 후 에이전트가 기업위챗 조작 능력을 얻는다는 것뿐이다. 그 밖의 실패 이유는 로컬 로그와 계정 권한에서 대조해야 한다.