product-management

Lark Cowork Plugins

Biến Claude Cowork (trong Claude Desktop) thành một chuyên gia làm việc thuần Lark cho mọi vai trò — chat, mail, lịch, tài liệu/wiki, công việc, Base, drive, biên bản họp — tất cả đều chạy qua cầu nối MCP lark-cli.

📘 Bạn là người dùng nghiệp vụ (không chuyên kỹ thuật)? Bắt đầu tại đây → docs/ — bộ tài liệu tiếng Việt đầy đủ: giới thiệu, hướng dẫn bắt đầu, danh mục theo phòng ban, giới thiệu chi tiết tất cả plugin (trang 8), cách vận hành (trang 9), cách tùy biến/custom (trang 10), best practice — nên dùng & custom sao (trang 11), kịch bản thực tế, an toàn dữ liệu, FAQ và thuật ngữ.

Tùy biến từ bộ knowledge-work-plugins mã nguồn mở của Anthropic. Bộ gốc nhắm tới Slack / Notion / Google / Jira. Bản fork này đấu lại toàn bộ lớp cộng tác sang Lark (larksuite.com), trong khi vẫn giữ các công cụ chuyên ngành thực sự (kho dữ liệu, CRM, thanh toán, cơ sở dữ liệu khoa học) dưới dạng connector ngoài tùy chọn.

Mục lục

• Ý tưởng cốt lõi
• Cách hoạt động
• Phạm vi bao phủ — 15 plugin nghiệp vụ
• 7 plugin thuần Lark (mới)
• Yêu cầu cài đặt trước
• Chọn phương thức kết nối (transport)
• Cài vào Claude
• Chạy lại quá trình chuyển đổi
• Cấu trúc kho mã
• Chất lượng & kiểm thử
• Ghi nhận & bản quyền

Ý tưởng cốt lõi

Lark là một super-app: Chat (IM), Mail, Lịch, Tài liệu (Docs), Wiki, Base (bảng dữ liệu thông minh), Sheets, Drive, Minutes (biên bản họp AI), họp video, Phê duyệt, OKR… gói gọn trong một nền tảng. Vì mọi mặt công việc đã nằm trong Lark, một trợ lý AI đặt ngay tại đây có thể chạm tới toàn bộ vòng đời công việc — điều mà việc ghép nối rời rạc Slack + Notion + Jira + Gmail không làm được.

Bộ plugin này dạy Claude nói "tiếng Lark": bạn ra lệnh bằng tiếng Việt như nói với đồng nghiệp, Claude tự thao tác trên dữ liệu Lark của bạn rồi trả kết quả về — ngay tại chỗ, không cần rời Lark, không cần biết code.

Cách hoạt động

Mỗi plugin chỉ gồm markdown + JSON. Các kỹ năng (skill) đều không phụ thuộc công cụ cụ thể — chúng tham chiếu tới các "ô giữ chỗ" dạng ~~category, được phân giải qua file CONNECTORS.md của từng plugin. So với bản gốc, mỗi plugin chỉ thay đổi đúng hai thứ:

1. .mcp.json — các server giao tiếp chung (Slack, Gmail, Google Calendar, Notion, Asana, Linear, Atlassian, Guru, Fireflies, Box…) được thay bằng một server MCP lark duy nhất (lark-cli mcp serve). Các server chuyên ngành được giữ nguyên.
2. CONNECTORS.md — mỗi nhóm danh mục chung nay được ánh xạ tới các công cụ lark_* cụ thể; các danh mục chuyên ngành vẫn giữ kết nối ngoài.

Một server lark duy nhất hỗ trợ mọi danh mục cộng tác. Bất kỳ thao tác nào không có công cụ chuyên biệt sẽ rơi xuống lark_api (cửa thoát hiểm tới Lark OpenAPI). Xem bản ánh xạ tổng tại connectors/CONNECTORS.lark.md.

Sơ đồ luồng:

   Bạn ra lệnh           Trợ lý AI               Thao tác trên Lark        Trả kết quả
   trong Lark      →     dùng kỹ năng       →    (mail, lịch, Base,    →   về Lark
   (tiếng Việt)          chuyên Lark             tài liệu, duyệt…)         (thẻ, tin nhắn, file)

Phạm vi bao phủ — 15 plugin nghiệp vụ