前言¶
在自动化办公里,金山文档、WPS 云文档和多维表格往往承担协同与数据沉淀;若要在脚本或 Agent 里读写文件、改权限、驱动多维表格,通常要对着 WPS 开放平台文档查接口、拼鉴权、处理协同与共享规则。手工对接成本高,也容易在权限模型上踩坑。
下面介绍 SkillHub 上的社区 Skill「金山文档WPS云文档助手」(坐标 @user_af163eaa/z-wps-cloud-docs,当前版本 v1.0.1)。它把「何时该用 WPS 开放能力」写进 Skill 触发条件,并引导通过金山/WPS 开放平台 API 完成云文档读写、多维表格协同以及文件权限与共享管理。
这是什么¶
「金山文档WPS云文档助手」是面向办公效率(分类 office-efficiency)的 Agent Skill,来源为社区(community),由发布者 user_af163eaa 维护;SkillHub 页面展示作者为「大智JiYoo」。
一句话定位:当对话涉及金山文档或 WPS 云侧能力时,由 Agent 按 Skill 指引调用开放平台 API,而不是让用户自行翻文档拼请求。
官方入口:
- Skill 资源地址:https://api.skillhub.cn/user_af163eaa/z-wps-cloud-docs
- SkillHub 展示页:https://www.skillhub.cn/skills/user_af163eaa/z-wps-cloud-docs
SkillHub 元数据标注 requires_api_key=true,表示实际调用依赖你在 WPS 开放平台侧申请的应用与 API 凭证;具体环境变量或配置项以安装后技能目录内的 SKILL.md 为准。
核心功能¶
以下能力均来自 SkillHub 简介与页面描述,未单独展开未公开的接口清单。
-
云文档自动读写
通过金山/WPS 开放平台 API,对云文档进行程序化的读取与写入,用于报表归档、内容同步等场景。 -
WPS 多维表格协同
围绕「WPS 多维表格」相关需求,借助开放 API 参与表格侧的协同与数据操作(具体接口以开放平台文档及 Skill 内指引为准)。 -
文件权限与共享管理
处理「WPS 文件权限」、共享与协同编辑相关的开放能力,减少在控制台手工改权限的次数。 -
触发词覆盖常见表述
当用户提到金山文档、WPS、WPS 365、WPS 云文档、WPS 开放平台、WPS 多维表格、WPS 文件权限、WPS 协同编辑时,Agent 应优先启用本 Skill。
安装与启用¶
安装流程遵循 SkillHub 官方说明文档 skillhub.md。先做 CLI 检查,再把技能装进当前 Agent 的 skills 目录。
1、安装 SkillHub CLI(如尚未安装)¶
检查是否已安装:
command -v skillhub && skillhub --version
未安装时可执行完整安装(CLI + 默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill¶
SkillHub 页面给出的安装提示为:请根据 https://skillhub.cn/install/skillhub.md,安装 @user_af163eaa/z-wps-cloud-docs。
命令行方式需使用 --dir 指向当前 Agent 的 skills 目录,否则默认会装到 ./skills/ 而可能不被识别:
skillhub install user_af163eaa/z-wps-cloud-docs --dir <你的 Agent skills 目录>
常用客户端 skills 路径(摘自 skillhub.md):
- Claude Code:
~/.claude/skills/ - Cursor:
~/.cursor/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
在 Cursor 中可示例为:
skillhub install user_af163eaa/z-wps-cloud-docs --dir ~/.cursor/skills/
安装完成后,按 SkillHub 说明重启或刷新 Agent,使新 Skill 被加载;再阅读技能包内 SKILL.md 完成 WPS 开放平台 API Key 等配置。
也可将下面提示词直接发给支持 Skill 的 AI,由其按官方安装文档完成安装:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_af163eaa/z-wps-cloud-docs`。
典型用法¶
公开资料未附带独立脚本示例,典型用法分两层:安装启用,以及在对话中用已列出的产品关键词描述任务。
安装启用:使用上一节的 skillhub install 或安装提示词,确保 Agent 已加载 @user_af163eaa/z-wps-cloud-docs。
对话中发起任务(表述需与 Skill 简介中的场景一致,由 Agent 结合 SKILL.md 与开放平台 API 执行),例如:
帮我在 WPS 云文档里读取指定文档内容,并写回更新后的段落。
需要通过 WPS 开放平台调整某文件的共享权限,并说明 WPS 文件权限相关接口该怎么调。
在 WPS 多维表格里批量同步一列数据,走开放平台 API,不要手工在网页里改。
具体请求路径、鉴权方式与参数以 WPS 开放平台官方文档及本 Skill 包内说明为准;Agent 的作用是减少你从零拼装调用链的时间。
适用场景与注意¶
适合谁
- 已在用金山文档 / WPS 365 / WPS 云文档做协同,希望用 API 做读写、权限或多维表格自动化的人。
- 使用 Cursor、Claude Code、Codex 等支持 Skill 的客户端,并愿意在 SkillHub 安装社区技能的开发者。
使用注意
- API 凭证:SkillHub 标签
requires_api_key=true,须先在 WPS 开放平台创建应用并拿到合法凭证;勿把 Key 写进公开仓库。 - 社区来源:
source: community,行为与维护节奏取决于发布者,升级前可在 SkillHub 查看版本(当前 v1.0.1)。 - 安装目录:务必
--dir指向当前 Agent 的 skills 目录,否则技能可能不会被加载。 - 数据与权限:文件权限、共享、协同编辑涉及企业数据安全,生产环境调用前应在测试租户验证 scope 与审计要求。
SkillHub 统计(以抓取资料为准):评分 100000,下载 13834 次,分类 office-efficiency。
结尾¶
「金山文档WPS云文档助手」把 WPS 云文档、多维表格、权限与协同等高频表述收敛成 Skill 触发条件,并围绕金山/WPS 开放平台 API 组织自动化读写与管理流程。若你正在把办公文档能力接进 Agent 工作流,可从官方地址获取并安装:
https://api.skillhub.cn/user_af163eaa/z-wps-cloud-docs