Wecomcli Doc Manage by Pinvou — AI Skill for Any LLM

Overview

Publisher	Pinvou
Repository	`pinvou-agent`
Skill name	`wecomcli-doc-manage`
Stars	2K
Forks	281
Bundled files	3
License	MIT
Links	Skill source Repository Homepage

Markdown instructions

A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

Works with any LLM

AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

3 bundled files

Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

Open source

Published by Pinvou on GitHub. Read the source before you install it.

Installation

Install the Wecomcli Doc Manage AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

Open the app and go to Plugins → Skills.
Choose "Install from GitHub".
Paste the skill folder URL below and confirm.
Enable the skill in any chat where you want it available.

Store

Installed

Skills

Add skills

Import one or more skills from a public GitHub folder or a local .skill or .zip archive, or SKILL.md file.

From GitHub URLFrom .skill, .zip, or SKILL.md

GitHub repo or folder

https://github.com/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-doc-manage

Points to a single skill folder, or any folder that contains multiple skills. Public repos only.

CancelContinue

Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills

git clone --depth 1 https://github.com/Pinvou/pinvou-agent.git /tmp/pinvou-agent
mkdir -p .claude/skills
cp -r /tmp/pinvou-agent/pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-doc-manage .claude/skills/wecomcli-doc-manage

Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Wecomcli Doc Manage in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Wecomcli Doc Manage on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Wecomcli Doc Manage is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

Loaded only when it is needed

The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

Switch models mid-chat

Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

执行任何 wecom-cli 命令前，必须先读取并完成 wecomcli-shared 技能的公共前置检查。

核心概念

四种文档类型：在线文档 doc、在线表格 sheet、智能表格 smartsheet、智能文档 smartpage。doc_type 枚举在多接口中复用。
搜索接口额外支持的类型：收集表 collect、PPT ppt、脑图 mind、流程图 flow、汇报 journal、PDF pdf。这些类型仅在「搜索文档」接口的 doc_types 过滤中可用，其他接口（改名、权限、加入规则等）不适用。

适用范围

适用：

仅支持搜索 doc文档 / 在线表格 / 智能表格 / 智能文档 / PPT / 收集表 / 脑图 / 流程图 / 汇报 / PDF 文档类型
仅支持修改 doc文档 / 在线表格 / 智能表格 / 智能文档的名称
仅支持添加 doc文档 / 在线表格 / 智能表格 / 智能文档的成员权限
仅支持设置 doc文档 / 在线表格 / 智能表格 / 智能文档的加入规则

接口路由表

路由表第二列若是 references/xxx.md 链接 → 必须先用 read 读完该文件，再构造命令。

用户意图	参考位置
搜索文档（包含最近浏览/创建）	见下方「搜索文档」
修改文档名	+names-update
添加文档成员 / 改权限	+members-update
设置链接加入规则	+rules-update

接口详述

搜索文档

按关键词与过滤条件（类型 / 创建者 / 浏览者-成员 / 时间窗 / 排序）搜索文档

关于"浏览者"与"成员"：在本接口的搜索语义下二者等价——visitor_userids 命中的是"该 userid 作为浏览者/成员/相关者"的文档，用来表达"包含 X"、"X 参与的"、"与 X 相关的"、"X 作为成员的"均可。注意权限约束：无论传谁的 userid，最终结果只会返回当前调用者本人有权限访问的文档；他人有权限但你没权限的文档不会出现在结果中，因此本接口不能用于"窥探他人独占的文档列表"。

命令

bash
wecom-cli doc search --json '<JSON 参数>'

参数

字段	类型	必填	默认值	语义
`keywords`	string[]	是	—	关键词数组，OR 关系。仅按其他条件过滤时传空数组 `[]`
`search_scope`	string	否	`title_content`	搜索范围枚举：`title`（仅标题） / `title_content`（标题和内容，默认） / `content`（仅内容）
`doc_types`	string[]	否	—	限定类型，取值为 `doc` / `sheet` / `smartsheet` / `smartpage` / `collect` / `ppt` / `mind` / `flow` / `journal` / `pdf` 的子集
`creator_userids`	string[]	否	—	限定创建者 userid 列表（典型：传当前用户 userid 查"我最近创建"）
`visitor_userids`	string[]	否	—	限定"浏览者 / 成员" userid 列表
`created_after` / `created_before`	string	否	—	创建时间窗，`YYYY-MM-DD HH:mm:ss`
`opened_after` / `opened_before`	string	否	—	最近打开时间窗，`YYYY-MM-DD HH:mm:ss`
`sort_by`	string	否	`best_match`	排序枚举：`best_match`（默认） / `create_time`（创建时间） / `modify_time`（修改时间）
`limit`	int	否	`10`	返回上限，不超过 100
`cursor`	string	否	—	分页游标；首次传空，后续取上页 `next_cursor`

字段	类型	说明
`has_more`	boolean	是否还有下一页；`true` 时用 `next_cursor` 续取
`next_cursor`	string	下一页游标
`docs`	array	结果文档列表，每项字段见下表

docs[] 单条文档字段：

字段	类型	说明
`docid`	string	文档唯一 ID
`doc_name`	string	文档名
`doc_type`	string	文档类型
`url`	string	可访问的文档链接
`creator_userid`	string	文档创建者 userid
`create_time` / `modify_time`	string	创建 / 最近修改时间
`title_highlight` / `text_highlight`	string[]	命中高亮片段

使用规则

ppt / journal / collect / mind / flow 目前没有任何下游 skill 或 CLI 能读取正文，命中这些类型且用户要看内容时，直接告知暂不支持读取，引导用户用 doc_url 在企业微信客户端内打开查看。
参数组合按意图分派（含必填约束）：先判定用户意图，再按对应分支组装参数。禁止所有参数均不传或仅传空值（如 {}）。
- (a) 按内容找 → keywords（必填，不得为空数组） + search_scope=title_content + sort_by=best_match
- (b) "我最近浏览 / 与我相关 / 我作为成员 / 包含我的文档" → visitor_userids=[<当前 userid>]（必填，不得为空） + sort_by=best_match + opened_after（默认近 7 天）
- (c) "包含某人为成员 / 某人参与 "（他人）→ visitor_userids=[<他人 userid>]（必填，先经 wecomcli-contact 由姓名解析）+ sort_by=best_match；必须提醒用户：只会返回当前调用者有权限访问的那部分文档，对方独占且你无权访问的文档不会出现。
- (d) "我最近创建" → creator_userids=[<当前 userid>]（必填，不得为空） + created_* 时间窗 + sort_by=create_time + created_after（默认近 7 天）
- 若意图不属于 (b)(c)(d)，一律按 (a) 处理，keywords 必填。
userid（前缀 wo）：用户提供的是姓名时通过 读取 wecomcli-contact 技能 解析为 userid；禁止把姓名当 userid 拼接，禁止凭记忆或猜测编造。
keywords 必须先分词再组装：当用户给出自然语言 query（如 "帮我找下产品的待办tool文档"）时，禁止把整段 query 直接当成单个 keyword 传入。处理流程：
1. 对 query 做中英文分词，得到 token 列表（中文按词切分，英文按空格 / 大小写边界切分），并剔除"帮我"、"找下"、"文档"、"的"等口语化 / 通用 / 停用词。
2. 判定"必传 token"：从剩余 token 中挑出真正承载用户检索意图的核心词（通常是专有名词、产品名、功能名等强区分度词），其余作为辅助 token。
3. 组装 keywords 数组：第 1 个元素是所有"必传 token"用空格拼接的串（只拼必传的，不要把全部 token 都塞进去），后续元素依次是各单独 token（必传 + 辅助）。例如 query "帮我找下产品的待办tool文档"，分词后必传 token 为 ["待办", "tool"]，则 keywords = ["待办 tool", "待办", "tool"]。
4. 若必传 token 只有 1 个，第 1 个元素就是该 token 本身，不必重复追加。例如 query "周报" → keywords = ["周报"]。
多候选必须让用户确认：结果 >1 条时，按下方「结果展示规范」展示候选列表，等用户选定后再继续后续动作。
无候选必须追问用户：结果 =0 条时，告知用户当前没有搜到文档，追问用户是否可以提供更多的关键词线索。

示例：用户 query "帮我找下产品的待办tool文档"

剔除"帮我 / 找下 / 的 / 文档"等通用词，剩余 ["产品", "待办", "tool"]；判定核心检索意图为 "待办" 与 "tool"，故必传 token 为 ["待办", "tool"]，"产品" 作为辅助 token。

bash
wecom-cli doc search --json '{"keywords":["待办 tool","待办","tool","产品"],"search_scope":"title_content","limit":10}'

结果展示规范

向用户展示搜索结果（含单条与多候选）时严格遵守：

用 markdown 无序列表逐条展示，禁止使用表格——最多展示10条结果，即使只有 2~3 条结果也用列表；表格会强制四列对齐，反而把 ID / 时间等噪声字段一起暴露。
文档名必须是可点击链接：每条首行写成 - [doc_name](url)，url 取接口返回的 url 字段原样使用。
默认不展示创建者：creator_userid 是内部 ID，禁止以任何形式输出给用户。

跨技能依赖

依赖技能	典型协作场景	数据流向
`wecomcli-contact`	添加文档成员时用户只给姓名，需先解析为 `userid`	`wecomcli-contact` 的 `contact users search` → 返回 `userid` → 本 skill 的 `doc members update` 接口

需要读取、打开搜索到的docid

拿到 docid 只是第一步。读取/打开文档正文是另一类技能，必须按doc_types，先用 read 读取对应"内容技能"的 SKILL.md，再按其文档发命令：

doc（在线文档）→ wecomcli-doc 技能
smartpage（智能文档）→ wecomcli-smartpage 技能
sheet（在线表格）→ wecomcli-sheet 技能
smartsheet（智能表格）→ wecomcli-smartsheet 技能严禁直接拼"读正文"的命令；首次读取正文前必须先用 read 读取上述对应内容技能的 SKILL.md，命令一律以该 SKILL.md 为准。

搜索多候选需确认 / 搜索意图类确认 / 必填参数（docid、权限角色等）缺失时，用简洁自然语言仅追问缺失或有歧义的信息；有候选项时在文字中列出供用户选择，不得自行猜测。

Frequently asked questions

What does the Wecomcli Doc Manage AI skill do?

何时用:仅当用户明确指向企业微信文档的公共管理(搜索/改名/成员权限/加入规则)时使用;本地文件管理默认走本地工具。适用所有企微文档类型;新建 doc 走 wecomcli-doc、新建在线表格走 wecomcli-sheet、智能表格 CRUD 走 wecomcli-smartsheet、生成智能文档走 wecomcli-smartpage;「看过哪些文档/浏览历史」走本技能。

Why use Wecomcli Doc Manage on TypingMind?

Because you install it once and use it with any model. Wecomcli Doc Manage is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Wecomcli Doc Manage in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-doc-manage. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Wecomcli Doc Manage?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Wecomcli Doc Manage?

As many as you like. As long as a model supports skills, you can use Wecomcli Doc Manage with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Wecomcli Doc Manage AI skill free?

Yes. It is published on GitHub by Pinvou under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

核心概念

适用范围

接口路由表

接口详述

搜索文档

命令

参数

返回

使用规则

结果展示规范

跨技能依赖

需要读取、打开搜索到的docid

Bundled files

Frequently asked questions

Related AI Skills

Set up your own AI workspace now