跳转到主要内容
文档扩展生态技能系统

技能系统

技能是 Agent 的能力包：系统预装 Office 文档生成等通用技能，也能从技能市场安装、按用户启用停用。

技能（Skill）是给 Agent 用的能力包：一个以 SKILL.md 为核心的目录，里面装着操作说明、脚本和参考资料。Agent 执行任务时按需读取这些内容，就能做一件原本不会做的事，比如生成一份带目录和页眉的 Word 文档。

技能是什么

每个技能是一个目录，最少包含一份 SKILL.md：frontmatter 里写 name 和 description，正文是给 Agent 看的操作说明。目录里还可以带附件（脚本、参考文档、配置模板），并声明依赖与 MCP 服务器。

markdown
---
name: weekly-report-style
description: 生成周报 Excel 时统一使用团队的配色与表头规范
---

# 使用说明

正文写给 Agent 看：什么时候用这个技能、
按什么步骤做、附带的脚本和参考文件怎么用。

技能采用渐进式披露：Agent 平时只看到每个技能的名称与描述，判断当前任务用得上某个技能时，才读入完整正文与附件。这样即使装了很多技能，也不会把所有内容都塞进每次对话。

技能和模块是两回事：模块是可复用的工作流片段，以 sub_workflow 的方式被别的工作流调用；技能是 Agent 在单个步骤内部使用的知识与脚本包，不改变工作流结构。见内置模块库。

系统技能与用户安装技能

类型来源谁可见能做什么
系统技能平台预装所有用户只读，不能删除；可以对自己的账号停用
用户安装技能技能市场安装 / ZIP 导入仅安装者本人可启用 / 停用、升级、卸载

平台预装的通用系统技能主要有两类：Office 文档生成（docx / xlsx / pptx / pdf）和开发类技能（前端、全栈、iOS、Android、Flutter、React Native 等）。在控制台的「技能管理」页可以看到完整清单，点开任何一个技能都能查看它的版本、附件和 SKILL.md 全文。

Office 文档生成

这组系统技能让 Agent 步骤直接产出办公文档文件，而不只是 Markdown 文本：

技能能力
docx创建和编辑 Word 文档：标题层级、目录、表格、图片插入、查找替换、修订与批注
xlsx生成带格式与公式的 Excel 表格，也能读取、清洗已有表格数据和制作图表
pptx从零生成幻灯片，或基于已有模板修改演示文稿、提取其中的文本
pdf提取 PDF 文本与表格、合并拆分、加水印、填写 PDF 表单

典型用法：日报工作流里的 Agent 步骤用 xlsx 技能产出一份带格式的周报表格，随执行产物一起下载，或直接送达 Slack / 邮件。产物还能发布为公开链接，见产物公开分享。

技能市场：安装与版本

控制台的「ClawHub 技能市场」页连接 ClawHub 注册中心。按关键词搜索，查看每个技能的版本、作者、下载量和更新时间，点安装即可为自己的账号装上。

bash
# 搜索市场
curl "https://braidrun.com/api/skills/market/search?query=testing&limit=10" \
  -H "Authorization: Bearer <token>"

# 安装（安装状态只记在你自己的账号下）
curl -X POST https://braidrun.com/api/skills/market/<slug>/install \
  -H "Authorization: Bearer <token>"

# 升级到最新版本
curl -X POST https://braidrun.com/api/skills/market/<slug>/upgrade \
  -H "Authorization: Bearer <token>"
  • 技能带版本号。已安装的技能在「技能管理」页点「检查更新」，升级会重新下载最新版本
  • 只有从市场安装的技能走升级流程；ZIP 导入的技能没有升级来源，重新导入一次即可
  • 卸载只解除你自己账号的安装，不影响装了同一技能的其他用户
  • 也可以直接上传 ZIP 导入自己写的技能：包内必须有一份 SKILL.md，且 name 和 description 字段有效；解压后总大小不超过 100MB

市场里的技能内容来自第三方作者。安装前先在详情页读一遍 SKILL.md，确认它会让 Agent 执行哪些脚本和外部调用。

按用户启用 / 停用

「技能管理」页里每个技能都有独立开关。启用 / 停用状态记录在你自己的账号下：你把某个系统技能停用后，它对你的 Agent 不再可见，其他用户不受影响。别的用户私有安装的技能，你既看不到也不会被加载。

Agent 作用域：限制某个 Agent 能用哪些技能

账号级开关之外，还可以在 Agent 配置里给单个 Agent 划定更小的技能范围。常用字段：

  • Skills 子系统开关 —— 关掉后这个 Agent 完全不使用技能
  • 白名单模式 —— 开启后只有白名单里的技能能被这个 Agent 探测到，内置技能会自动加入白名单
  • 禁用列表 —— 黑名单，白名单模式关闭时依然生效
  • 每次请求最大技能数 —— 限制单次请求里注入的技能数量
  • 自动搜索下载 —— 默认关闭；开启后 Agent 发现本地缺少能力时会自动去 ClawHub 搜索并下载新技能，会引入外部下载行为，企业场景慎用

执行时平台把 Agent 配置和你的用户级状态合并成最终生效的技能范围：你在「技能管理」页停用的技能，对这次执行里的所有 Agent 都不可用。

运行时配置

有的技能需要先填参数或凭据才能工作，比如第三方服务的 API token。带配置模板的技能会在卡片上显示「已配置 / 待配置」，点「配置 Skill」按字段填写即可。

  • 敏感字段（token、密码、私钥等）保存后以遮罩显示，不回显明文；保持遮罩提交则沿用旧值
  • 自己安装的技能自己就能配置；系统技能的运行时配置只有管理员可以修改

常用端点

端点作用
GET /api/skills列出你可见的全部技能
GET /api/skills/{name}技能详情，含 SKILL.md 全文与附件清单
PUT /api/skills/{name}/toggle为自己的账号启用 / 停用
GET /api/skills/market/search搜索 ClawHub 技能市场
POST /api/skills/market/{slug}/install安装到自己的账号
POST /api/skills/market/{slug}/upgrade升级到最新版本
DELETE /api/skills/market/{slug}卸载
POST /api/skills/import上传 ZIP 导入技能

相关页面