wecomcli-shared
wecom-cli 业务技能的公共前置检查、获取机器人及授权真人身份，以及通用输出约束。任何 wecomcli- 技能首次准备执行 wecom-cli 命令前，都必须同时读取本技能，检查 CLI 是否安装、版本是否不低于 1.2.1，以及企业微信凭证是否已授权；仅在缺失、版本过低或未授权时执行安装或初始化。本技能还定义所有技能通用的 ID 类字段禁止外露约束。本技能不处理具体业务请求。
- Installs
- 7.9K
- Last 24h
- +145
- Trending rank
- #1514
- Security
- Pass
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/wecomteam/wecom-cli --skill wecomcli-shared- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads wecomcli-shared automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
Security audits
Independent scans of the skill's instructions and bundled files.
SKILL.md
The instructions your agent reads when the skill is triggered.
wecom-cli 公共前置检查
本技能提供所有 wecomcli-* 业务技能共用的 CLI 安装、版本与授权检查，以及通用输出约束。首次准备执行任意 wecom-cli 命令前，先完成本技能；检查通过后，再回到对应业务技能执行。
本技能不能代替具体业务技能。处理联系人、文档、表格、日程、会议、待办、邮件、微盘、消息或媒体请求时，必须同时读取对应业务技能。
Step 1：检查 CLI 安装与版本
wecom-cli --version
- 命令成功，且输出中的版本号不低于
1.2.1→ 继续 Step 2。 - 命令不存在、执行报错或版本号低于
1.2.1→ 执行安装/升级：
npm install -g @wecom/cli
安装完成后重新执行 wecom-cli --version；仍失败或版本仍低于 1.2.1 时停止业务操作，并把错误告知用户。
Step 2：检查授权状态
wecom-cli auth show --status
- 输出
authorized→ 前置检查完成，可以执行具体业务命令。 - 输出
unauthorized→ 执行 Step 3。 - 命令报错或输出不是上述状态 → 停止业务操作，并把错误告知用户，不要猜测授权状态。
Step 3：初始化凭证（仅未授权时）
wecom-cli auth init --noninteractive
该命令会展示授权链接和二维码，并等待用户使用企业微信扫码。授权成功后命令自动退出，仅需初始化一次。
初始化完成后重新执行：
wecom-cli auth show --status
仅当输出 authorized 时，才能继续执行具体业务命令。
通用输出约束：ID 类字段禁止外露
本约束对所有 wecomcli-* 技能生效，优先级高于各业务技能的输出格式，且不因用户主动索要而放宽。
- 禁止：你的最终回复禁止出现
userid/open_vid/department_id/chat_id等 ID 标识。凡是接口返回的内部标识（含mail_id/media_id/file_id/space_id/folder_id/docid/content_id/msg_id/cursor/next_cursor等，命名上以_id结尾或语义上属于机器标识的字段一律视为 ID）都只能在内部流转，用于后续接口调用。 - 必须：你的思考过程和最终回复必须使用可读名称，如
name/username/external_username/ 部门名 / 邮箱 /subject/doc_name/chat_name/title等tool_result返回的内容。 - 接口只返回 ID 而没有可读名称时，先调用对应技能（如
wecomcli-contact解析人员）换取可读名称；确实无法换取时，用自然语言描述该对象（如「上一封日报邮件」「你刚上传的那个文件」）来指代，禁止退化为展示 ID。 - 需要用户在多个候选中选择时，用序号 + 可读信息（名称 / 主题 / 时间 / 路径等）构造候选列表，禁止用 ID 作为区分依据让用户辨认。
- 用户直接要求「把 ID 给我」「打印 mail_id」时，说明该标识属于内部字段不便提供，并改用可读信息或继续帮其完成实际操作。
- 可读链接（如文档
doc_url、微盘分享链接）不属于本约束限制范围，可按各业务技能规定正常展示，即使链接本身包含标识字符串。
执行规则
- 已安装、版本达标且已授权时，不重复安装或初始化。
- 安装、升级、初始化或复查失败时，不执行后续业务命令。
- 本技能不定义任何联系人、文档、表格、日程、会议、待办、邮件、微盘、消息或媒体接口参数；具体命令必须回到对应业务技能读取。
- 执行任何业务命令并组织回复时，同时遵守上方「通用输出约束：ID 类字段禁止外露」。
获取个人身份
如果操作流程必须获取机器人或授权人身份（姓名、userid等），需要调用 wecom-cli identity whoami 获取。
FAQ
What does the wecomcli-shared skill do?
wecom-cli 业务技能的公共前置检查、获取机器人及授权真人身份，以及通用输出约束。任何 wecomcli- 技能首次准备执行 wecom-cli 命令前，都必须同时读取本技能，检查 CLI 是否安装、版本是否不低于 1.2.1，以及企业微信凭证是否已授权；仅在缺失、版本过低或未授权时执行安装或初始化。本技能还定义所有技能通用的 ID 类字段禁止外露约束。本技能不处理具体业务请求。
How do I install wecomcli-shared?
Run npx skills add https://github.com/wecomteam/wecom-cli --skill wecomcli-shared in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/wecomcli-shared/ (personal) or .claude/skills/wecomcli-shared/ (project).
Which AI agents can use wecomcli-shared?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is wecomcli-shared safe to install?
Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk passed. As with any skill, read the SKILL.md and bundled scripts before installing.
Who maintains wecomcli-shared?
It is published by wecomteam in wecomteam/wecom-cli. It has 7,938 recorded installs.
More from wecomteam/wecom-cli
wecomcli-doc
wecomteam/wecom-cli
企业微信在线 doc 文档技能。能够新建 doc、导入本地 .doc/.docx/.txt 为 doc、读取 doc 内容、向 doc 追加或覆盖写入。仅当用户明确出现「doc」「docx」「word」「在线文档」「office 文档」等强类型词，或提供 https://doc.weixin.qq.com/doc/xxx 链接时才使用本技能。用户说"文档""新建文档""写文档""整理成文档""输出到文档"等未指定类型的泛化表达，一律使用 wecomcli-smartpage。
wecomcli-todo
wecomteam/wecom-cli
管理企业微信待办，支持创建、删除或退出、完成、查询和筛选，以及修改标题、描述、参与人名单和截止时间。
wecomcli-meeting
wecomteam/wecom-cli
企业微信会议管理。本技能负责『在线会议』——即含在线会议链接（含会议号/入会链接、可远程或视频参会）的会议的创建、查询、搜索、获取详情（含会议信息、纪要、待办）、查询会议转写原文（逐字发言记录）、更新、取消等全部操作；若用户要的是不含在线会议链接的『日程』（也涵盖纯线下面对面碰头），改用 wecomcli-calendar 技能。用户仅说'开会/约个会/某会/某会议'等、未明确要创建的是日程还是在线会议时，必须先读取本技能并按其中的消歧流程向用户追问确认后再处理，不可臆断直接创建。
wecomcli-contact
wecomteam/wecom-cli
使用 wecom-cli 按姓名、拼音、英文名或别名搜索企业微信通讯录中的人员，并查询匹配人员的 userid、部门和职务。适用于查找联系人、区分同名人员、获取用户 userid，以及列出全部同名人员。
wecomcli-smartsheet
wecomteam/wecom-cli
企业微信智能表格内容操作技能——专注于智能表格（smartsheet）的数据、结构与样式管理：读取表结构与记录、管理子表/字段/记录/视图/图表，以及修改行列样式（填色/高亮）；记录新增或更新遇到 851003 / no authority 时通过 Webhook 兜底写入。触发条件：用户提到智能表格、企微表格、smartsheet 的内容操作或样式修改，或链接形如 https://doc.weixin.qq.com/smartsheet/s3xxx。企业微信表格分为「智能表格」和「在线表格」两种类型，本文档介绍的是智能表格的相关技能。智能表格包含子表（sheet）、视图（view）、字段/列（field），每条记录（record）以 recordid 作为主键，结构类似关系型数据库。当用户未明确说明使用「在线表格」时，一律默认使用功能更强大的智能表格（本技能）。
wecomcli-msg
wecomteam/wecom-cli
企业微信消息技能。提供会话列表查询、消息记录拉取（支持文本/图片/文件/语音/视频）、多媒体文件获取和文本消息发送能力。当用户需要"查看消息"、"看聊天记录"、"发消息给某人"、"最近有什么消息"、"给群里发消息"、"看看发了什么图片/文件"时触发。
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.