TL;DR

feishu-cli는 페이시(飞书) 오픈 플랫폼의 문서·지식베이스·스프레드시트·메시지·캘린더·태스크 기능을 명령줄로 감싼 도구로, 핵심은 마크다운과 페이시 문서 사이의 무손실 양방향 변환이다. Mermaid·PlantUML 코드 블록은 캡처 이미지가 아니라 편집 가능한 페이시 화이트보드 벡터 도형으로 자동 변환되고, 세 단계 동시성 파이프라인(순차 블록 생성→다이어그램·표 워커 풀 병렬 처리→실패 항목 코드블록 강등)으로 만 줄 이상·다이어그램 127개짜리 대형 문서도 한 번에 임포트한다. 사람이 직접 커맨드를 치는 것보다 Claude Code 같은 AI 에이전트가 9개 영역별 스킬 파일을 통해 문서 생성, 메시지 발송, 권한 관리를 바로 호출하도록 설계됐고, 명령어 오탈자를 조용히 무시하지 않고 철자 제안까지 내놓는 등 에이전트가 스크립트로 쓰기 좋은 견고성을 갖췄다. 대용량 파일은 20MB 이상부터 자동 분할 업로드하고, OAuth Device Flow로 리다이렉트 URL 화이트리스트 설정 없이 사용자 인증을 받을 수 있다.

핵심 포인트

• Mermaid·PlantUML을 캡처 이미지가 아니라 편집 가능한 페이시 화이트보드 도형으로 변환해, 문서 안의 다이어그램을 나중에 직접 고칠 수 있다.
• 3단계 동시성 파이프라인으로 만 줄·다이어그램 127개·표 170개짜리 대형 문서 임포트를 실측 검증했다.
• 9개 영역별 AI 에이전트 스킬을 함께 제공해, Claude Code 같은 도구가 설정 없이 바로 문서·메시지·권한 조작 명령을 호출할 수 있다.
• 명령 오탈자를 조용히 성공 처리하지 않고 철자를 제안하며, `--dry-run`과 멱등키로 에이전트가 실수로 반복 실행해도 안전하게 만든다.

벤치마크