Install
npx skills add WeComTeam/wecom-cli -y -g누구에게 맞나
터미널에서 기업위챗을 다루고 메시지, 메일, 문서, 할 일, 일정, 회의, 위드라이브, 주소록을 덮으며, 사람과 AI Agent가 같은 명령줄을 쓰게 하고 싶을 때 이 스킬을 쓴다. 다른 웹 관리 화면가 아니다. 개방 플랫폼 능력을 터미널에 이어 기업 사무 효율을 올린다. 공식 저장소는:
https://github.com/wecomteam/wecom-cli
전제는 분명하다. 이 기기에 Node.js >= 18과 기업위챗 계정이 있어야 한다. 플랫폼은 macOS (x64/arm64), Linux (x64/arm64), Windows (x64)로 한정된다. 계정이 없거나 버전이 부족하거나 이 플랫폼이 아니면 먼저 설치하지 말 것. 브라우저에서 기업위챗만 누르고 이 기기에 전역 명령을 남길 생각이 없는 사람도 여기서 시작하지 말 것.
원문은 CLI 설치와 CLI Skill 설치를 두 단계로 나누고 Skill은 필수라고 적는다. 먼저 명령줄, 그다음 Agent가 호출을 배우게 한다. 나타나지 않은 설치기를 만들지 말고, 지명하지 않은 스킬 디렉터리를 보태지 말 것. 원문은 「사람과 AI Agent」를 몇몇 제품 독점으로 쓰지 않았다. 클라이언트 명단을 스스로 좁히지 말 것.
3분 만에 첫 시도 끝내기
먼저 셋 확인: Node.js가 18 이상. 기업위챗 계정이 있다. 현재 시스템이 위 플랫폼 안이다. 공식 페이지를 열어 대조한다:
https://github.com/wecomteam/wecom-cli
주 경로는 먼저 CLI, 그다음 필수 CLI Skill. 패키지를 넣으면 이 기기 전역 명령이 바뀐다. 실행 전 이 기기에 @wecom/cli를 남길지 확인한다:
npm install -g @wecom/cli
확인한 뒤 원문이 주는 Skill 설치(필수로 표시)를 실행한다:
npx skills add WeComTeam/wecom-cli -y -g
이 두 단계를 병렬 주 경로로 나누지 말고 매개변수도 바꾸지 말 것. 원문은 스킬 착지 디렉터리를 쓰지 않았다. 경로를 스스로 보태지 말 것.
Agent에서는 처음 검사만 한다. 문서를 새로 만들지 말고 메일을 보내지 말고 일정도 바꾸지 말 것. 아직 자격 증명을 설정하지 않았다면 설정은 부작용이다: 기본은 스캔, --manual로 손 입력. 실행 전 이것이 자기 기업위챗 계정이며 이번 상호작용을 마칠 준비가 되었는지 확인한다:
wecom-cli auth init
설정한 뒤 읽기 전용 명령으로 권한 상태를 본다:
wecom-cli auth show
성공 신호: 명령이 정상 끝나고 현재 권한 상태를 볼 수 있다. 원문은 show의 필드 이름을 주지 않았다. 출력 형식을 만들지 말 것. 처음에는 봇 알림, 문서 쓰기, 회의 예약, 위드라이브 업로드를 하지 말 것. Agent가 「먼저 init, 그다음 show」만 되뇌고 show를 실제로 통과하지 않았다면 이미 권한 성공으로 보지 말 것.
사용 사례
사례 1: 권한만 검사. CLI와 필수 Skill을 넣은 뒤 터미널 또는 같은 명령을 호출할 수 있는 Agent에서 wecom-cli auth show를 실행한다. 권한 상태를 본다. 자격 증명이 아직 있는지 확인할 때 맞다. 실행 전 설정을 겸사 바꾸지 않을 것을 확인한다. 성공 신호는 권한 상태를 보는 것이다. 원문은 미권한 종료 코드를 쓰지 않았다. 실패하면 멈추고 수리 명령을 만들지 말 것. 이번 검사를 메일 보내기나 주소록 읽기로 넓히지 말 것. 그 동작에 대응하는 명령 문장은 없다.
사례 2: 처음 자격 증명 설정. 원문은 자격 증명 설정이 대화형이며 한 번만 필요하고 기본은 스캔, --manual로 손 입력이라고 적는다. 명령은 wecom-cli auth init. 실행 전 이 기기에 기업위챗 자격 증명을 남기고 스캔 또는 손 입력 준비가 되었는지 확인한다. 설정한 뒤 wecom-cli auth show로 대조한다. 원문에 철회나 로그아웃 명령은 없다. 자격 증명 제거 단계를 만들지 말 것. 메시지, 문서, 할 일, 일정, 회의, 위드라이브, 메일, 주소록 등 업무 능력은 기능 이름까지다. 예: 문서 신규와 읽기, 문서 검색, 일정 신규와 관리, 회의 예약과 정보 가져오기, 할 일 신규와 추적, 위드라이브 파일 업로드와 가져오기, 메일 보내기와 가져오기, 주소록 구성원 정보 가져오기, 봇 능동 알림. 그 조작이 필요하면 먼저 공식 저장소로 돌아가고 명령을 스스로 보태지 말 것.
사용 경계
플랫폼, 런타임, 계정 요구는 원문을 따른다: macOS (x64/arm64), Linux (x64/arm64), Windows (x64), Node.js >= 18, 기업위챗 계정. 사람과 AI Agent 모두 터미널에서 조작할 수 있으나 원문은 구체 Agent 제품을 지명하지 않았다. 몇몇 클라이언트 독점으로 쓰지 말 것.
설치 순서는 npm install -g @wecom/cli, 그다음 필수 npx skills add WeComTeam/wecom-cli -y -g. 둘째 마켓이나 나타나지 않은 skills add 변종을 만들지 말 것. 「필수 Skill」을 CLI를 건너뛰어도 된다고 읽지 말 것. 두 단계 모두 원문 순서로 마친다.
자격 증명 설정은 이 기기에 쓴다. 기본은 스캔. --manual을 쓸 수 있다. 원문은 자격 증명 파일 경로, 만료 정책, 철회 방법을 쓰지 않았다. 업무는 메시지, 메일, 문서, 할 일, 일정, 회의, 위드라이브, 주소록을 덮고 봇 능동 알림, 문서 검색, 회의 예약, 위드라이브 업로드를 포함한다. 다만 근거는 능력 기술에서 멈추고 그 하위 명령 문장은 없다. 적히지 않은 매개변수, 권한 범위, 과금을 채우지 말 것. 처음에는 권한만 검증한다. 명령이 없는 사무 동작을 이미 복사 가능한 단계로 보지 말 것. 근거가 쓰지 않은 제거나 업데이트 경로도 스스로 보태지 말 것.