1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Univer CLI (dream-num/skills) |
| 作者/维护者 | dream-num(Univer 开源项目团队,GitHub 组织账号) |
| 来源链接 | https://github.com/dream-num/skills/tree/main/skills/univer-cli |
| 许可证 | Apache-2.0(GitHub API 确认) |
| GitHub Stars | 54(GitHub API,2026-07-23;本仓库仅含该技能这一个入口 Skill) |
| Forks | 3(GitHub API) |
| 最新版本 | v0.1.25(仓库 tag,GitHub API;技能内容随 Univer CLI 工具版本同步,最近一次同步为 v0.3.5) |
| 安装方式 | npx skills add dream-num/skills,或手工 clone 后复制到对应 Agent 的 skills 目录 |
2. 功能介绍与亮点
Univer CLI 是开源电子表格/文档框架 Univer 官方提供的终端原生技能,让 Agent 直接读写 .univer 多单元文件——一个文件可同时容纳 Sheet(表格)、Doc(文档)、Slide(幻灯片)、Base(结构化数据表)、Board(画布)五种单元,按 unitId 分别寻址。
核心机制:
- Git 风格工作流:改动在独立 worktree 中进行,可读回校验、比对、批准或回滚,避免一次性改坏原文件;
- 版本匹配加载:核心与各 Unit 的操作指引由本地已装的 Univer CLI 按版本动态下发,命令与 API 始终对齐本地工具版本;
- 支持 Excel(.xlsx)导入导出,结果收敛到统一的
.univer格式; - 内置只读诊断(
univer doctor)与离线 API 查找,减少凭空编造调用签名; - 编辑完成后可交出浏览器预览链接供人工复核。
亮点:由 Univer 官方团队维护(母项目 GitHub 已有 13,900+ Star,细分领域认可度较高);文档结构清晰;近几周几乎每周都有随新版本同步的提交,多名团队成员参与。
3. 适用场景
所属分类:文档与办公自动化
适合需要让 Agent 批量处理 Excel/表格数据、生成或修改文档与幻灯片,且希望改动可追溯(谁改了什么、能否撤销)的用户——如财务/运营人员批量核对报表公式,或团队协作中需先审阅 Agent 的表格改动再合并。
4. 跨 Agent 兼容性
- Claude Code:原生支持。README 提供明确的 clone + 复制到
~/.claude/skills/步骤。 - Codex:原生支持。README 同样给出复制到
~/.codex/skills/的对应步骤。 - OpenClaw:未验证——已抓取材料未提及。
- Hermes Agent:未验证——已抓取材料未提及。
判断依据:README「Manual installation」章节逐一列出 Claude Code、Codex、Cursor 三者的具体安装路径;OpenClaw、Hermes Agent 不在列,未做额外搜索验证。
5. 推荐理由
它是少数把表格、文档、幻灯片、结构化数据统一到同一份可版本控制文件里的官方技能,Git 风格 worktree/回滚机制让 Agent 批量改表格变得可审阅、可撤销;背靠认可度较高的开源项目,文档完整,维护频繁。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 技能仓库由 Univer 官方团队维护,母项目本身 GitHub 已有 13,900+ Star,是该细分领域认可度较高的开源框架;技能仓库自身 54 Star,有多名真实用户提交带讨论的 issue(非仅收录类噪音) |
| 可用性 | 8 | 一行命令即可安装技能本身,SKILL.md 文档结构清晰、示例明确,近几周持续随新版本同步更新;但需额外全局安装 univer-cli 这一 npm 工具作为前置依赖,且仅支持 Linux/macOS,不支持 Windows |
| 安全性 | 9 | 逐项见下表 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ① shell 命令及权限范围 | 仅调用本地 univer CLI 对指定 .univer 文件做读写,范围限定在目标文件与其 worktree 内 |
| ② 运行时联网外发 | 无外发,全部为本地文件操作;浏览器预览为本地渲染查看,非上传数据 |
| ③ API key/凭据 | 不需要任何密钥或账号 |
| ④ 可疑指令 | 审阅 SKILL.md 全文未发现提示词注入或隐蔽指令 |
| ⑤ 作者信誉 | dream-num 为 Univer 开源项目官方组织账号,母项目本身知名度较高,无造假迹象 |
| ⑥ License | Apache-2.0,仓库根目录 LICENSE 文件明确 |
| ⑦ 最近维护 | 最近一次提交 2026-07-20(3 天前),随 Univer CLI 版本持续同步 |
综合评分(三项均值):8.3
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与 Univer CLI 的差异 |
|---|---|---|
| xlsx-anthropics-skills(Anthropic 官方) | Python/openpyxl 脚本直接读写 .xlsx,强制用公式而非硬编码数值 | 产出即标准 .xlsx,无需额外 CLI;Univer CLI 换成统一 .univer 格式,多一层工具安装,换来 Sheet/Doc/Slide/Base/Board 互通与 worktree/回滚审阅 |
| sn-da-excel-workflow(商汤 SenseNova 官方) | 面向数据分析的 Excel 全流程编排,自动分级处理大文件 | 定位偏“表格数据分析管道”;Univer CLI 偏“人机协作的文档编辑与版本管理”,覆盖文档、幻灯片、结构化数据表,并内置回滚机制 |
8. 用户评价
该技能目前在第三方 Skill 目录(如 awesomeskills.dev)有收录展示,但尚无具名用户评价;所在仓库自身 issue 区有多位不同用户提交的功能讨论与文档改进建议。
9. 其他补充
仓库提供中英双语 README;Univer CLI 工具通过 npm 独立发版,技能内容随 CLI 新版本自动同步,保持命令与工具版本一致。
10. 安装使用方式
方式一(推荐):
npx skills add dream-num/skills
方式二(手工安装):
git clone https://github.com/dream-num/skills.git
cd skills
mkdir -p ~/.claude/skills # Codex 对应 ~/.codex/skills
cp -R skills/univer-cli ~/.claude/skills/
安装技能前需先备好 Univer CLI 本体:
npm install -g univer-cli@latest
univer doctor
安装完成后无需重启 Agent;首次使用建议先执行 univer doctor 确认环境可用,再让 Agent 加载对应 Unit 技能(如 univer skills get sheet)操作具体的 .univer 文件。
11. 注意事项
- 仅支持 Linux/macOS,不支持 Windows;
- 需额外安装 Node.js/npm 与全局
univer-cli工具,非零依赖技能; - 核心工作文件是
.univer格式而非直接的 .xlsx/.docx/.pptx,导入导出 Excel 需经技能内置流程; - OpenClaw、Hermes Agent 上的兼容性未经验证。