前言¶

在自动化流程或对话式开发里，经常要把本地的 Word、表格、图片或网页快照统一成 PDF 再归档、发审或入库。本地装 LibreOffice、写脚本调各格式转换器，维护成本高，格式一多还容易踩坑。若你已经在阿里云市场使用「度慧文档转换」这类文档转 PDF 服务，更希望 Agent 在识别到相关意图时直接走同一套异步 API，而不是每次手写调用步骤。

下面介绍 SkillHub 上的社区 Skill「度慧文档转换-文档转PDF」（坐标 @user_d9c601a2/duhui-all-to-pdf，版本 1.0.0），它把触发条件与转换能力写进 SKILL.md，供 Cursor、Claude Code、Codex 等支持 Skills 的客户端加载。

这是什么¶

「度慧文档转换-文档转PDF」是 SkillHub 社区来源（community）的办公效率类 Skill，发布者为 user_d9c601a2，分类为 office-efficiency。

一句话定位：当需要借助阿里云市场的度慧文档转换，把单个本地文件通过异步 API 转成 PDF 时，由 Agent 按 Skill 说明触发并完成调用。

它解决的是「对话里提到文档转 PDF，但 Agent 不知道该用哪家 API、支持哪些格式、何时该走异步任务」的问题；Skill 正文里写明了触发词与适用边界，减少误判和重复解释。

核心功能¶

以下能力均来自 SkillHub 页面与已抓取元数据，未展开的部分不在此编造。

1. 单文件转 PDF
   面向单个本地文档的转换请求，不是批量目录扫描（批量需自行在业务层循环，并注意服务配额）。

2. 多类输入格式
   官方说明覆盖 Office/WPS、OFD、图片、文本、网页等「任意文件」转 PDF 的场景；具体以度慧文档转换服务当前支持的格式为准。

3. 异步 API 流程
   转换通过异步 API 完成，适合体积较大或耗时较长的文件；Agent 应按 Skill 内指引提交任务并轮询或等待结果（具体步骤以安装后的 SKILL.md 为准）。

4. 意图触发
   当用户提到「度慧」「文档转 PDF」「doc to pdf」「文档转换」「格式转换」「文档格式转换」「PDF 转换」，或明确需要异步 API 将本地文件转为 PDF 时，应触发此 Skill。

5. 需要 API Key
   标签 requires_api_key=true 表示使用前需配置度慧/阿里云市场相关 API 凭证；未在公开页面列出环境变量名时，以 Skill 包内文档为准。

SkillHub 侧统计（抓取时）：评分 100000，下载 2210，安装 181。

安装与启用¶

安装前确认本机已有 skillhub CLI；若没有，可先按 SkillHub 官方安装说明安装。

command -v skillhub && skillhub --version

未安装时可执行（完整安装，含默认 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

安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被客户端识别。官方页面给出的包名为 @user_d9c601a2/duhui-all-to-pdf。

以 Cursor 为例，skills 目录一般为 ~/.cursor/skills/：

skillhub install @user_d9c601a2/duhui-all-to-pdf --dir ~/.cursor/skills/

其他常见客户端路径（来自 SkillHub 安装文档，按你实际使用的客户端择一）：

• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装后按 Skill 包内说明配置 API Key，并重启或重新加载 Agent 的 Skills 目录，使 SKILL.md 生效。

典型用法¶

公开页面未提供独立脚本示例，典型用法是对话触发 + Agent 按 Skill 调用度慧异步接口。可复现的交互方式如下。

1. 在阿里云市场开通并获取「度慧文档转换」所需 API 凭证，按 Skill 内要求写入配置（字段名以包内 SKILL.md 为准）。
2. 将待转换文件放在本机 Agent 可访问的路径。
3. 在对话中明确意图与文件，例如：「用度慧把 /path/to/report.docx 转成 PDF」或「文档转 PDF，文件在桌面上的 contract.ofd」。
4. Agent 命中 Skill 后，应走异步 API：提交转换任务，等待完成后将 PDF 路径或下载结果返回给你。

触发词与官方简介一致，便于检索：度慧、文档转PDF、doc to pdf、文档转换、格式转换、文档格式转换、PDF转换。

适用场景与注意¶

适合谁

• 已在用或计划用阿里云市场度慧文档转换的团队，希望 Coding Agent 统一走同一套转 PDF 能力。
• 需要在对话里偶尔把 Office/WPS、OFD、图片、文本或网页类本地文件打成 PDF，又不想每次查 API 文档的开发者。

限制与注意

• 单文件：Skill 定位是单个本地文档；多文件需多次调用或自建批处理，并关注 API 限流与费用。
• API Key：requires_api_key=true，未配置凭证时 Agent 无法完成真实调用。
• 网络与合规：调用的是云端异步服务，文件会上传到服务商；敏感文档需先过企业安全与合规流程。
• 来源与版本：社区 Skill，版本 1.0.0；行为以安装包内 SKILL.md 与度慧官方 API 文档为准，升级前留意变更说明。

结尾¶

「度慧文档转换-文档转PDF」把「何时用度慧、转什么、走异步 API」写进 Agent Skill，适合把文档转 PDF 从一次性脚本变成可重复的对话能力。安装与优先源配置可参考 SkillHub 安装说明；Skill 详情与安装入口见 SkillHub 页面 与 API 地址。