Agent skill · wecomteam
wecomcli-media
企业微信媒体文件上传/下载技能。承接基于 media_id 下载媒体文件到本地，以及上传本地文件获取 media_id 两类操作。当其他技能（微盘、邮件等）返回了 media_id 需要落地为本地文件，或已有本地文件需要转换为 media_id 供其他技能使用时，必须先读取本技能获取完整指引，不得凭记忆处理。本技能不解析/识别文件内容，仅负责文件本身的搬运。
What it needs
About 1k tokens when loaded.
What this skill does
企业微信媒体文件 执行任何 wecom-cli 命令前，必须先读取并完成 wecomcli-shared 技能的公共前置检查。 资源型 skill，负责基于 mediaid 下载媒体文件到本地，以及把本地文件上传为 mediaid。是其他技能（微盘、邮件等）处理 mediaid 相关操作的基础依赖：upload 会产出新的 mediaid，但本 skill 不负责搜索/发现其他业务场景中已存在的 mediaid（如邮件附件、微盘文件的 mediaid 由对应业务技能产出），也不解析文件内容。 适用范围 适用 根据其他技能或用户提供的 mediaid 下载媒体文件到本地 上传本地文件（本地路径已知）获取 mediaid，供其他技能后续使用（如微盘上传素材） 不适用 解析/识别文件内容（正文提取、OCR、看图问答、PDF/Word/Excel 解析等） → 本 skill 只负责把文件下载到本地拿 filepath，如需查看内容请直接通过 filepath 读取该本地文件 搜索/发现其他业务场景中已存在的 mediaid（如邮件附件、微盘文件列表/搜索等） → 由对应业务技能负责产出并返回 mediaid，本 skill 只接收已有的 mediaid 做下载；本地文件转mediaid 的场景仍走本 skill 的 upload 编造或猜测 mediaid / 本地文件路径 → 两者必须来自其他技能返回或用户明确提供，禁止自行构造 接口详述 下载媒体文件 根据 mediaid 下载媒体文件到本地，返回本地文件路径。 命令 入参 字段 类型 必填 说明 --- --- :----: --- mediaid string 是 文件的 mediaid，由上传文件后获得，或由其他技能（邮件附件/内嵌图片等）返回 返回 字段 类型 说明 --- --- --- filepath string 下载成功后的本地文件路径 使用规则 下载完成后如需查看文件内容，直接通过 filepath 读取该本地文件。 下载失败时返回错误码和错误信息。 mediaid 必须是真正的 mediaid，不接受任何形式的 URL：若拿到的是一个链接（如 attachurl、正文里的图片/附件链接），不要把这个 URL 当作 mediaid 传入本接口，会直接报错。尤其是命中 work.weixin.qq.com/filepreview/security/ 特征的防泄漏加密链接，属于加密的、与用户身份绑定的资源，本接口无法下载或解密，应直接告知用户该文件受防泄漏策略保护，引导其点击链接、在企业微信客户端内打开查看/保存，不要尝试用本接口或其他手段绕过。 上传媒体文件 将本地文件上传，获取 mediaid。 命令 入参 字段 类型 必填 说明 --- --- :----: --- filepath string 是 需要上传的文件的本地路径 返回 字段 类型 说明 --- --- --- type string 媒体类型：image(图片)/voice(语音)/video(视频)/file(文件) mediaid string 上传后的 mediaid，供其他技能后续使用（如微盘upload 的 filecontentmedia） createdat string 创建时间，格式：YYYY-MM-DD HH:mm:ss 关键约束 mediaid / filepath 不得编造：mediaid 必须来自上传结果、其他技能返回或用户明确提供；filepath 必须是真实存在的本地路径。两者都没有时用自然语言追问，禁止靠猜测凑一个。 不做内容解析：本 skill 只负责文件的下载落地与上传，download 拿到 filepath 后如需查看内容，直接通过 filepath 读取，不在本 skill 职责范围内。 内部 ID 不外露：mediaid 仅用于后续接口调用，禁止直接展示给用户；下载后的本地 filepath 同样不展示给用户。 CLI 报错原样转达：命令返回明确错误码时如实告知用户并给替代建议，禁止用 curl / python 等通用手段绕过 CLI 强行完成。 跨技能依赖 依赖场景 说明 --- --- wecomcli-email 邮件附件/内嵌图片的 mediaid，使用本 skill 的 download 下载到本地后通过 filepath 读取 wecomcli-disk 上传文件到微盘时若已有 mediaid，直接作为 disk files upload 的 filecontentmedia 使用，无需再走本 skill；若只有本地路径且需要先转成 mediaid，可用本 skill 的 upload 参数缺失 / 意图不明确时，用自然语言追问让用户明 …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills wecomteam/wecomcli-media