lark-contact
contact (v1)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理
Shortcuts（推荐优先使用）
Shortcut 是对常用操作的高级封装（lark-cli contact +<verb> [flags]）。有 Shortcut 的操作优先使用。
| Shortcut | 说明 |
|---|---|
+search-user |
Search users (results sorted by relevance) |
+get-user |
Get user info (omit user_id for self; provide user_id for specific user) |
Known Limitations
External tenant users are not searchable via API
+search-user, +get-user, and GET /contact/v3/users only return users within the same tenant.
Users from other organizations (external Lark accounts) will not appear in search results and their open_id / user_id cannot be retrieved via the contact API — even with a tenant access token (bot identity).
Workaround options:
| Scenario | Solution |
|---|---|
| Add external user to Wiki/Doc | Invite as guest via admin console → use open_id returned after invitation |
| Share document with external user | Use open_sharing: anyone_readable (link-based, no Lark account required) |
Obtain external user's open_id |
Ask the user to look up their own open_id in Lark profile settings |
# After admin-console invitation, use openid directly:
lark-cli wiki members create \
--params '{"space_id":"<space_id>"}' \
--data '{"member_id":"ou_XXXXXX","member_type":"openid","member_role":"member"}'
More from shunsukehayashi/lark-harness
lark-im
飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员时使用。
1lark-approval
飞书审批 API：审批实例、审批任务管理。
1lark-vc
飞书视频会议：查询会议记录、获取会议纪要产物（总结、待办、章节、逐字稿）。1. 查询已经结束的会议数量或详情时使用本技能(如昨天 | 上周 | 今天已经开过的会议等场景)，查询未开始的会议日程使用 lark-calendar 技能。2. 支持通过关键词、时间范围、组织者、参与者、会议室等筛选条件搜索会议记录。3. 获取或整理会议纪要时使用本技能。
1lark-doc
飞书云文档：创建和编辑飞书文档。从 Markdown 创建文档、获取文档内容、更新文档（追加/覆盖/替换/插入/删除）、上传和下载文档中的图片和文件、搜索云空间文档。当用户需要创建或编辑飞书文档、读取文档内容、在文档中插入图片、搜索云空间文档时使用；如果用户是想按名称或关键词先定位电子表格、报表等云空间对象，也优先使用本 skill 的 docs +search 做资源发现。
1lark-sheets
飞书电子表格：创建和操作电子表格。创建表格并写入表头和数据、读取和写入单元格、追加行数据、在已知电子表格中查找单元格内容、导出表格文件。当用户需要创建电子表格、批量读写数据、在已知表格中查找内容、导出或下载表格时使用。若用户是想按名称或关键词搜索云空间里的表格文件，请改用 lark-doc 的 docs +search 先定位资源。
1lark-drive
飞书云空间：管理云空间中的文件和文件夹。上传和下载文件、创建文件夹、复制/移动/删除文件、查看文件元数据、管理文档评论、管理文档权限、订阅用户评论变更事件；也负责把本地 Word/Markdown/Excel/CSV 导入为飞书在线云文档（docx、sheet、bitable）。当用户需要上传或下载文件、整理云空间目录、查看文件详情、管理评论、管理文档权限、订阅用户评论变更事件，或要把本地文件导入成新版文档、电子表格、多维表格/Base 时使用。
1