Skill 安装
多 Agent 安装npx skills add https://github.com/anthropics/skills --skill docx
使用 npx skills 快速安装,支持将 Skill 添加到多个兼容的 AI Agent。
Skill 调研报告
Skill 详细介绍
anthropics/skills#docx 是 Anthropic 官方 skills 仓库中的一个文档处理 Skill,Skill 名称为 docx。它的作用是让 AI Agent 具备创建、读取、编辑和解析 Word(.docx)文档的能力,属于“文档与办公”方向的官方示例 Skill。
需要先说明一点:它不是独立运行的软件,也不是可执行程序,本质是一套面向 Agent 的指令集与工作流说明。安装后,Agent 会“学会”处理 .docx 文件,而不是多出一个后台服务。
核心能力
- 生成新的 Word 文档,包含标题、段落、列表、表格、样式等结构化内容
- 读取、解析已有 .docx 文件,提取文字与结构
- 修改现有文档内容,如增删段落、替换文字、调整格式
- 把结构化内容(Markdown、纯文本、数据)转换为 .docx
- 在文档处理场景中配合 Agent 完成批量或半自动化的办公任务
它不是什么
- 不是 Word 的替代软件,不能在界面里可视化编辑文档
- 不是 PDF 或 Excel 专用 Skill,虽然可能间接涉及,但核心对象是 .docx
- 不是网络服务,不依赖某个远程 API 才能工作,具体以官方当前说明为准
典型使用场景
- 把 Markdown 或纯文本草稿导出成规范的 Word 文档
- 批量读取一批 .docx 文件,提取内容做汇总、对比或翻译
- 根据模板或规范自动生成报告、合同、说明文档的初稿
- 在已有 Word 文档基础上做局部修改
适合哪些用户
经常处理 Word 文档、需要把 AI 生成内容落地成规范 .docx、或希望自动化处理大量文档的用户。如果只需要纯文本或 Markdown 输出,这个 Skill 属于可选,并非必需。
和通用文档处理能力的区别
它是一套针对 .docx 的专门指令与工作流,覆盖生成、解析、编辑等具体操作方式,比 Agent 仅靠自身通用能力“临场发挥”更聚焦、更规范。
Skill 安全评估
总体判断:该 Skill 来自 Anthropic 官方 skills 仓库,来源可信度较高,功能聚焦在文档读写,没有明显的恶意行为特征。但它会涉及文件读取与文件写入,是否安全主要取决于你给 Agent 的权限范围和使用场景。
主要安全关注点
- 文件读取权限。解析 .docx 需要读取文件。如果 Agent 被授权访问整个磁盘或敏感目录,理论上可以读到你不希望它访问的文档。建议只让它访问当前项目或指定目录。
- 文件写入 / 覆盖权限。编辑和生成文档意味着可能写入或覆盖文件。如果 Agent 自动执行写入,存在误覆盖已有文件的风险。对重要文档,建议先备份,或让 Agent 先输出到新文件。
- Shell / 命令执行。文档处理通常依赖底层工具链(如文档相关库或脚本)。如果 Agent 具备 Shell 权限并且会自动执行命令,就继承了 Shell 的一般风险。若只需生成文档内容,可以关闭自动执行,由用户手动运行命令。
- 第三方依赖与供应链。文档处理可能依赖某些库,这类依赖的真实性和必要性以官方说明为准;不要从非官方来源安装同名依赖。
- Prompt Injection。如果 Agent 读取的 .docx 文件来自不可信来源,文档内容中可能包含针对 Agent 的隐藏指令。处理外部文档时,应把文档内容当作数据,而不是指令。
降低风险的建议
- 限定 Agent 的可访问目录,避免开放整个磁盘
- 处理重要文档前先备份
- 对不可信来源的文档保持警惕,不让 Agent 盲目执行文档中“看起来像指令”的内容
- 非必要不开启 Agent 自动执行 Shell 的权限
该 Skill 未涉及账号、密钥类高危操作,整体风险可控,但文档读写本身属于需要用户留意权限范围的操作。
Skill 使用要求
一、Agent / 客户端
该 Skill 来自 Anthropic 官方 skills 仓库,与 Claude Code 高度适配,优先建议在 Claude Code 中使用。Anthropic 官方没有公布完整的第三方 Agent 兼容列表。从 Agent Skill 的通用工作方式来看,在支持 Skills、自定义 Skill 或类似指令加载机制的环境中,通常也可以尝试在 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 里使用。不同 Agent 的 Skill 加载方式和兼容程度可能不同,具体以对应 Agent 当前版本为准。
二、运行环境 / 依赖
| 项目 | 要求 |
| Agent | Claude Code 优先,其他兼容 Agent 可尝试 |
| 文档处理依赖 | 实际解析 .docx 通常依赖文档处理工具链,具体以官方说明为准 |
| 网络 | 仅在需要下载依赖或访问外部资源时涉及 |
| 操作系统 | 官方未明确限定,以对应 Agent 支持的环境为准 |
官方未明确给出固定的版本号要求,请以官方当前说明为准。
三、权限
| 权限 | 是否必需 | 说明 |
| 文件读取 | 必需 | 解析已有 .docx 需要读取文件 |
| 文件写入 | 必需 | 生成 / 编辑文档需要写入文件 |
| Shell | 视实现而定 | 若底层依赖命令行工具链则可能需要 |
| 网络 | 可选 | 仅下载依赖或访问外部资源时需要 |
| 浏览器 | 不需要 | — |
| Docker | 不需要 | — |
四、账号 / API Key
Skill 本身不需要额外的账号或 API Key,也不会要求你登录某个第三方平台。Skill 后续生成或处理的项目是否需要凭证,取决于该项目本身,与该 Skill 无关。
最小使用条件
- 一个支持 Skills 的 Agent(优先 Claude Code)
- 可访问要处理的 .docx 文件目录,或允许写入输出目录
- 如果底层依赖工具链,确保相应运行环境可用
Skill 安装、使用与卸载教程
一、安装
可以直接复制本页面提供的 Skill 安装指令,粘贴到对应 Agent 或终端中执行。
如果不确定自己的 Agent 怎样安装 Skill,可以直接询问当前 Agent:
如何安装 anthropics/skills#docx?
也可以指定 Agent 询问:
如何在 Claude Code 中安装 anthropics/skills#docx?
如何在 Codex 中安装 anthropics/skills#docx?
如何在 Cursor 中安装 anthropics/skills#docx?
让当前 Agent 根据自己的 Skill 加载 / 管理机制给出安装步骤,通常是最稳妥的方式。如果该 Skill 存在特殊的官方安装要求,以官方说明为准。
二、安装后如何使用
安装后一般不需要手动触发命令,直接用自然语言描述文档任务即可。适合交给它的任务包括:生成 Word 文档、读取解析 .docx、修改已有文档、把结构化内容转成 .docx。
自然语言使用示例(以下为示例,不是官方命令):
使用 docx skill,把下面这份周报内容整理成一份格式规范的 Word 文档。
用 docx skill 读取这个目录下的所有 .docx 文件,提取正文并汇总成一份摘要。
帮我用 docx skill 在这份合同草稿里,把“甲方”统一替换为“示例科技有限公司”。
描述需求时,说清“输入是什么、想得到什么输出、是否需要保留原文件”,通常能得到更准确的结果。
三、卸载
保持简单即可:使用对应 Agent / Skill 管理器提供的删除方式移除该 Skill,或直接询问当前 Agent:
如何卸载 anthropics/skills#docx?
不同 Agent 的 Skill 安装位置和管理方式可能不同。如果没有统一的卸载命令,直接询问当前 Agent 如何移除通常更稳妥。官方若提供了明确的卸载方式,以官方说明为准。
常见问题
1. 安装后 Agent 没有识别到这个 Skill 怎么办?
先确认 Skill 安装到了当前 Agent 实际读取的目录,并确认 Agent 已重启或重新加载。不同 Agent 的 Skill 加载机制不同,可以让当前 Agent 自查“是否已加载 docx skill”,或核对本页面提供的安装指令是否执行成功。
2. 可以同时安装到多个 Agent 吗?
可以尝试。Skill 一般按 Agent 安装,多个 Agent 各装一份互不影响。但各 Agent 的兼容程度和加载方式不同,实际能否正常工作以对应 Agent 当前版本为准。
3. Skill 更新后需要重新安装吗?
通常以官方当前的安装 / 更新说明为准。如果你的 Agent 支持更新机制,按对应方式更新;如果不确定,直接询问当前 Agent 如何处理 docx skill 的更新。
4. 它会直接修改或覆盖我已有的 Word 文件吗?
取决于你给 Agent 的指示和文件写入权限。如果希望避免误改,明确要求“输出到新文件、不要覆盖原文件”,并在处理重要文档前先备份。
5. 处理不可信来源的 .docx 有风险吗?
有。文档正文里可能包含针对 Agent 的隐藏指令(Prompt Injection)。处理外部文档时,建议把文档内容当作数据看待,不让 Agent 盲目执行其中出现的“指令”类文字。
6. 在 Claude Code 之外使用,效果会一样吗?
不一定。该 Skill 与 Claude Code 适配最好;其他 Agent 的兼容程度和加载方式可能不同,实际表现以对应 Agent 当前版本为准。
7. 它和通用的文档处理能力有什么区别?
区别在于它是一套针对 .docx 的专门指令与工作流,覆盖生成、解析、编辑等具体操作方式,比 Agent 仅靠通用能力“临场发挥”更聚焦、更规范。