ChatBI 支持注册和管理自定义 Skill。会话问答时，若未指定 Skill，ChatBI 默认使用系统内置 Skill 运行；若指定自定义 Skill，则按该 Skill 定义的分析流程执行，帮助您将业务分析方法沉淀为可复用的分析能力。
功能概述
自定义 Skill 是您自行注册的分析能力单元，核心内容通过 SKILL.md 定义。SKILL.md 使用 Markdown 格式编写，可描述适用场景、基础约束、定制流程等信息，ChatBI 将按照其中的指令开展数据分析。
在 ChatBI 会话问答时，Skill 的运行规则如下：
未指定 Skill：默认使用系统内置 Skill 运行，ChatBI 根据您的提问自动完成数据分析。
指定自定义 Skill：使用指定的自定义 Skill 运行，ChatBI 按照该 Skill 中定义的分析流程和约束执行，适合有固定分析范式的业务场景（例如经营指标波动归因分析）。
前提条件
已在使用 ChatBI 功能的对应地域创建使用Serverless资源组。
已创建数据集。
创建自定义 Skill
ChatBI 支持通过以下两种方式创建自定义 Skill，您可在创建 Skill 时按需选择：
创建方式 | 说明 |
手动编写 | 直接填写名称、描述和 SKILL.md，适合结构相对简单的分析技能。 |
上传压缩包 | 上传 zip 包，由包内 SKILL.md 解析名称、描述和正文，适合需要携带资源文件的复杂技能。 |
手动编写
进入 ChatBI 页面，在左侧导航栏单击
进入skill管理页面。在 Skill 管理列表上方单击创建 Skill。在创建 Skill 对话框中，选择手动编写。
配置以下参数：
参数
说明
名称
Skill 的唯一标识，建议使用英文和连字符命名（例如
metric-impact-diagnosis），便于在会话中引用。描述
Skill 的功能描述，用于帮助您和其他用户快速了解该技能的用途和适用场景。
Skill 正文
SKILL.md 的核心内容，使用 Markdown 格式编写。您可以在正文中定义适用场景、基础约束、定制流程等，ChatBI 将按照正文中的指令执行分析任务。
配置完成后，单击确定，完成自定义 Skill 的创建。
上传压缩包
进入 ChatBI 页面，在左侧导航栏单击
进入skill管理页面。在 Skill 管理列表上方单击创建 Skill。在创建 Skill 对话框中，选择上传压缩包。
上传已编辑好的 zip 包。zip 包需满足以下结构要求：
根目录必须包含
SKILL.md，用于定义 Skill 的 name、description 和正文。后端将自动解析该文件。可在包内按需创建以下可选资源目录，并在
SKILL.md中通过相对路径引用：目录
用途
scripts/存放可执行脚本。
references/存放按需加载的参考资料。
assets/存放模板、图片等资源。
限制：单个
SKILL.md不超过 200KB，整个 zip 包不超过 50MB。
zip 包结构示例如下：
my-skill.zip ├── SKILL.md # 必填；定义 name、description 和正文 ├── scripts/ │ └── clean.py # 可执行脚本 ├── references/ │ └── api.md # 按需加载的参考资料 └── assets/ └── template.csv # 模板、图片等资源单击确定，完成自定义 Skill 的创建。
SKILL.md 正文建议按适用场景、基础约束、定制流程等结构组织内容。例如，创建一个经营指标波动归因分析技能时，可在适用场景中描述适用的业务指标范围，在基础约束中约定数据口径与统计周期，在定制流程中定义归因分析的执行步骤与输出格式。
管理自定义 Skill
创建成功后，您可在 ChatBI 的管理技能列表中查看已注册的自定义 Skill，并支持以下管理操作：
操作 | 说明 |
编辑 | 修改自定义 Skill 的名称、描述或 Skill 正文。 |
删除 | 删除不再使用的自定义 Skill。删除后，会话中将无法再指定该 Skill。 |
在会话中使用自定义 Skill
在 ChatBI 会话中提问时，若指定了自定义 Skill，ChatBI 将使用该 Skill 运行，按照其中定义的分析流程和约束执行本次问答；未指定 Skill 时，默认使用系统内置 Skill 运行。
若业务问题具有固定的分析范式（例如每周的经营指标波动归因分析），建议在提问时指定对应的自定义 Skill，以获得稳定、可复用的分析过程和结论。
在 ChatBI 会话输入框中，单击
按钮并选择自定义技能。在弹出的自定义 Skill 列表中，单击目标 Skill。
输入业务问题并发送，ChatBI 将按该 Skill 定义的分析流程和约束执行本次问答。
指定自定义 Skill 后，本次问答将严格遵循该 Skill 中定义的基础约束和定制流程执行；如需恢复默认的系统分析能力，可在后续提问中不再指定自定义 Skill。
相关文档
了解 ChatBI 的功能与使用流程，请参见ChatBI 概述。
了解 ChatBI 会话的使用方法，请参见ChatBI会话。
了解 ChatBI 知识库的配置方法，请参见知识库。
了解新版 Data Agent 中技能的配置和使用，请参见新版 Data Agent。