wecomcli-contact
何时用:仅当用户明确指向企业微信(查企微通讯录、给企微同事发消息前找人)时使用;泛指找人默认走本地联系人,不要误用。按姓名、拼音、英文名或别名搜索企微通讯录人员,返回 userid、部门和职务;适用于区分同名人员、获取 userid、列出全部同名人员。
git clone --depth 1 https://github.com/Pinvou/pinvou-agent /tmp/wecomcli-contact && cp -r /tmp/wecomcli-contact/pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-contact ~/.claude/skills/wecomcli-contactSKILL.md
# 企业微信联系人搜索 > 执行任何 `wecom-cli` 命令前，必须先读取并完成 `wecomcli-shared` 技能的公共前置检查。 使用 `wecom-cli` 按关键词搜索企业微信通讯录中的人员。 ## 接口 按关键词批量模糊搜索人员，一次最多 10 个关键词，返回命中 `users` 数组（姓名 / 英文名 / 职务 / 部门）。关键词可匹配的字段包括：姓名（用户名）、姓名拼音、英文名、别名，而不仅限于中文名和别名。 ### 命令 ```bash wecom-cli contact users search --json '<JSON 参数>' ``` ### 参数 | 字段 | 类型 | 必填 | 默认值 | 语义 | |---|---|---|---|---| | `keywords` | string[] | 是 | — | 搜索关键词列表，可按姓名（用户名）/ 拼音 / 英文名 / 别名匹配，最多 10 个；多个关键词之间是 OR 关系 | | `search_mode` | string | 否 | — | 搜索模式，默认不传该参数；仅当需要拿到完整人员名单时，才显式传 `"list"` | - 默认（不传 `search_mode`）：返回最相关的候选结果，用于常规按名 / 拼音等查单个人的场景，绝大多数场景走此分支。 - 传 `search_mode = "list"`：返回全量命中列表。仅当用户明确要"完整名单"时才传，典型话术如"一共有几个张三 / 所有叫李四的人 / 列出全部同名 / 全部同名人员"等清点、穷举意图；此时不受"前 5 位"展示上限约束。 ### 返回 | 字段 | 类型 | 说明 | |---|---|--| | `users` | array | 命中的用户列表 | | `users[].userid` | string | 用户唯一标识 | | `users[].name` | string | 中文姓名 | | `users[].alias` | string | 英文名 / 别名（可能为空） | | `users[].email` | string | 邮箱（可能为空） | | `users[].position` | string | 管理职务（如"负责人"），**不是**"职位"（可能为空） | | `users[].matched_keywords` | string[] | 本条 user 命中的请求关键词| | `users[].departments` | string[] | 所在部门路径列表（从大到小），主部门靠前 | | `hint` | string | 结果限制提示（可能为空）：当某个关键词的命中结果因限制未完整返回时，接口会在此字段给出说明 | | `users_count` | integer | `users` 数组元素数量 | ### 使用规则 - 歧义展示上限：同一关键词下候选超过 5 位时，只展示前 5 位（附姓名 / 英文名 / 职务等区分信息），告知用户"若目标不在其中可要求『查看更多』"，仅在用户明确要求时再展开下一批； - 展示顺序：必须严格按照接口返回 `users` 数组的原始顺序展示，不得自行随机排序、重排或打乱次序。 - 结果限制提示：当返回中 hint 字段非空时，必须在回复中告知用户"当前返回内容有限，仅返回了部分结果"，并可结合 hint 内容说明受限原因。 ## 缺少参数 > 必填参数缺失（未提供搜索关键词）且上下文无法推断时，用简洁自然语言向用户追问缺失信息，不得猜测默认值。
直出好看的网页/落地页/banner/海报/产品介绍页/数据报告/简历/作品集等视觉物料——套一套设计系统，模型自由写自包含 HTML，颜值由规则锁死、不靠模板。用户说"做个网页/页面/落地页/banner/海报/报告页/作品集/简历"或"把这份内容做成网页版"时使用。⚠️ 不含信息检索：查天气/查行情/查股价/查数据请走对应连接器，不是本技能。
【何时用:仅当用户明确指向钉钉/DingTalk(钉钉文档、钉钉日程等)时使用;泛指做文档/表格/待办/审批默认走本地工具,不要误用钉钉】用 dws CLI 管理钉钉:AI表格/AI搜问(找人首选)/目标管理(Agoal)/组织大脑/日历/通讯录/群聊与机器人消息/待办/审批/考勤/日志(日报周报)/DING消息/钉钉文档/云盘/Markdown文件/AI听记/邮箱/在线电子表格(axls)/知识库/白板/开放平台文档/个人IM与OA事件订阅。用户要求操作上述钉钉产品时使用。
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式（BaseApp/AppMode 页面与组件）、Workspace 目录、workflow、角色权限；遇到 Base/多维表格/bitable、BaseApp/AppMode 或 /app/ 链接时使用。BaseApp 不走 lark-apps；文件导入转 lark-drive，认证/授权转 lark-shared。
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书日历:管理日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。不负责:查询视频会议记录(本 skill 只覆盖日程;lark-vc 技能未随包收录,可 CLI 直连,见意图路由)、待办任务(走 lark-task)。
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书云文档(Docx/Wiki)与思维笔记内容操作:读取、创建、编辑文档,插入或下载图片附件,查询或回滚历史版本。用户给出文档 URL/token(含 doubao.com 的 /docx/、/wiki/)时使用,按 URL 路径/token 而非域名路由;内嵌表格、多维表格、画板先提取 token 再切对应 skill。文档评论走 lark-drive;表格或 Base 内部数据操作不在本 skill。
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书云空间:管理 Drive 文件/文件夹,上传下载、复制移动删除、评论、权限、密级标签、版本、改标题,导入 Word/Markdown/Excel/CSV/PPTX/.base 为在线文档;doubao.com 云空间 URL 同走本 skill,不回退 WebFetch。不负责:文档内容编辑(lark-doc)、表格/Base 表内数据(lark-sheets/lark-base)、知识库节点(lark-wiki)。
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive Card）与卡片按钮回调（card.action.trigger）。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索或创建群聊/话题群、管理标记数据、Feed 置顶与标签数据、处理卡片回调时使用。
【何时用:仅在其他 lark-* 技能遇到认证/授权/身份/配置问题时,或首次使用 lark-cli 时;泛指需求默认走本地工具】lark-cli 共享规则:首次配置(config init)、认证登录(auth login --domain/--scope,split-flow)、登录态查询与撤销(auth status/logout/whoami)、--as user/bot 身份切换、权限不足与 missing_scope 处理、JSON 输出契约与 _notice、update 更新、高风险操作审批(exit 10)。