---
title: 编写并分享技能
order: 5
description: 把自定义 skill 上传到 workspace，再推广给整个团队。
---

# 编写并分享技能

你可以用自己的 skill 扩展 Investibook —— 教 agent 如何处理你们团队特有的问题。

## 1. 编写 skill

一个 skill 是一个目录，包含：

- 一份 `SKILL.md`，面向 agent 描述**什么时候**使用这个 skill。
- 分步指引与参考资料。
- 可选的辅助脚本或 prompt。

好的 skill 描述会写清楚**触发短语**、**所需 sources**（例如「TiDB Cloud Dedicated 集群的
cluster meta」），以及一个**不应使用**的反例。

## 2. 上传到 workspace

打开 **Settings → Skill Hub**，点击 **Upload**。

![Skill Hub 展示 Upload 按钮以及现有技能](/docs/_assets/skill-hub-settings.png)

Investibook 会做结构校验，校验通过即可在当前 workspace 使用。从这一刻起，agent 可以像
调用内置 skill 一样调用它，sources 面板里也能看到。

> **作用域仅限当前 workspace**。上传不会影响别的 workspace 或同事。适合快速迭代：调一下
> 再上传，再让 agent 跑一遍。

## 3. 推广给团队

当 skill 跑得稳了，向
[tidbcloud/nutshell-skills](https://github.com/tidbcloud/nutshell-skills) 提交 PR。合并之后
就会作为内置 skill 出现在每个 workspace。

## 4. 跟踪使用情况

进入内置目录后，[Ranking](/docs/features/skill-ranking) 页面会展示有多少工程师在用、用得
有多频繁。