通讯录成员查询技能基于 wecom-cli 命令行程序，所有操作通过执行 wecom-cli 命令完成。其用途是获取当前用户可见范围内的通讯录成员，并在本地按姓名或别名进行筛选匹配，常用于查询人员信息、为其他功能提供 userid 转换，以及批量查询多个人员。
主要能力包括：一是获取全量通讯录成员，调用 wecom-cli contact get_userlist '{}' 获取当前用户可见范围内的所有企业成员信息，返回格式为 JSON，包含 errcode、errmsg 和 userlist 字段；userlist 数组中的每个成员包含 userid（用户唯一 ID）、name（用户姓名）和 alias（用户别名，可能为空）三个字段。二是按姓名或别名搜索人员，在 get_userlist 返回全量成员后于本地对结果进行筛选，支持精确匹配（name 或 alias 与关键词完全一致）、模糊匹配（name 或 alias 包含关键词）以及无结果时的提示。
使用方式上，典型工作流包括三种：工作流一为查询人员信息，先调用 get_userlist 获取全量成员列表，再在结果中筛选匹配成员，若找到唯一匹配则直接展示结果，若找到多个匹配则展示候选列表请用户确认；工作流二为为其他功能提供 userid 转换，先获取全量成员，筛选确认 userid 后将其传递给消息发送等接口；工作流三为批量查询多个人员，只需调用一次 get_userlist，在本地对结果进行多次筛选并汇总展示。
适用场景为可见范围较小的通讯录查询场景，需注意 get_userlist 返回的是当前用户可见范围内的成员，需经过可见性规则过滤，不一定是全公司所有人员。限制方面，若 userlist 返回成员数量超过 10 人，视为异常，应立即停止处理并向用户说明，本技能仅适用于可见范围较小的场景，无法在大范围通讯录中使用，建议缩小可见范围后重试或通过其他方式查询。此外，alias 字段可能为空字符串，搜索时需做空值判断；若搜索结果有多个同名人员，需将所有候选人展示给用户选择，不得自行决定；若 errcode 不为 0，说明接口调用失败，需告知用户错误信息 errmsg。