企业微信套件
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @tencent-adm/wecom-unified。
技能介绍
问题背景
企业微信作为广泛使用的办公协作平台,其许多操作依赖于网页或移动端界面,缺少原生的命令行接口。这限制了自动化脚本的集成、批量处理以及开发者对系统的程序化控制。手动执行重复性任务,如批量搜索联系人、管理文档或安排会议,耗时且易出错。
核心能力与工作流程
企业微信套件通过 wecom-cli 提供了一套完整的命令行工具集,将企业微信的核心功能封装为可编程的命令。
- 按业务域组织:技能根据用户意图智能路由到对应的业务域,如
contact、doc、calendar等。每个域有独立的参考文件定义参数规范。 - 严格的前置流程:使用任何命令前,必须执行
wecom-cli --version检查 CLI 版本(需 ≥ 1.1.0)和wecom-cli auth show --status验证凭证配置。未授权时需执行wecom-cli auth进行扫码授权。 - 身份与 ID 约束:通过
wecom-cli identity whoami获取操作者身份。所有输出严格禁止展示userid、chat_id等内部标识,必须使用可读名称(如姓名、标题),并遵循路由表中的reference文件进行转换。 - 业务域协作:例如,创建会议可能需要先查询日程域的忙闲状态,文档搜索可通过公共管理域进行,体现了域间的数据流转。
适用边界与注意事项
该技能并非万能,存在明确的边界:
- 功能限制:暂不支持周期性日程/会议的创建、邮件的草稿与撤回、文件的移动与删除等操作。
- 前置依赖:必须确保
wecom-cli已安装且版本符合要求,凭证配置是必须的一步。 - 输出规范:由于 ID 约束,当接口仅返回 ID 时,系统会尝试通过
reference文件转换为可读信息,若无法转换则使用自然语言描述,避免向用户暴露机器标识。 - 消歧机制:对于模糊指令如“开会”,创建时会主动消歧以确定是日程还是会议,查询时则会合并结果。
使用场景
- 当需要快速查找公司内符合特定姓名或别名的多名联系人,并获取其邮箱和部门路径以进行后续通知时,可通过通讯录域批量搜索。
- 当收到一个在线文档链接,需要读取其全文内容并在末尾追加新的会议纪要段落时,可通过文档域执行读取和追加操作。
- 当需要创建一个包含在线会议链接的安排,并自动检查所有参会者在未来一小时内的忙闲状态以确定最佳时间时,需要联动日程与会议域进行查询和创建。
- 当需要将一份本地的 Excel 数据文件导入到企业微信的智能表格中,并后续通过命令行更新其中特定行的数据时,可使用智能表格域的导入与记录修改功能。
适合人员
- 需要通过自动化脚本批量处理企业微信通讯录数据,进行人员信息核对或组织架构分析的运维工程师。
- 负责管理团队的在线文档、表格,并需要定期整理会议纪要、更新会议待办事项的项目经理或团队主管。
- 需要为团队成员统一安排线下会议,查询会议室可用性并预订,或创建不含在线链接的日程的行政人员。
- 希望通过命令行高效管理邮件往来,并能快速搜索、读取特定邮件及其附件内容的商务或运营人员。