> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 我的技能

> 了解如何浏览官方技能、管理个人技能，以及将个人技能分享给团队使用。

## 这是什么

superun 将技能分为三类：

* **官方技能**：由 superun 提供，所有用户都可以浏览并按引导配置。
* **个人技能**：仅属于当前用户，可由「我的记忆」转化而来。
* **团队技能**：个人技能经过分享与审核后，供所属团队在团队项目中使用。

## 项目内技能库

打开项目后，依次进入 **「研发 → 功能 → 技能库」**。技能库包含「官方」「团队」「个人」三个 Tab，方便按来源查找技能。

## 官方技能

在「官方」Tab 浏览官方技能。点击技能卡片可查看介绍，并按页面引导完成配置。

<img src="https://b.ux-cdn.com/uxarts/files/t20260723203450/nsihabii.png" alt="项目技能库的官方技能 Tab" width={800} style={{ borderRadius: '8px' }} />

## 个人技能

个人技能仅对当前用户可见，可由「我的记忆」转化而来。项目创建者或其他协作者的个人技能不会出现在你的列表中，你的个人技能也不会展示给他们。

<img src="https://b.ux-cdn.com/uxarts/files/t20260723203450/th8i5vbm.png" alt="项目技能库的个人技能 Tab" width={800} style={{ borderRadius: '8px' }} />

### 上传技能包

在「我的技能」中点击添加，可选择 **从我的记忆转化**，或 **上传技能**（从本地上传技能文件）。

<img src="https://b.ux-cdn.com/uxarts/files/t20260810170601/3gv9egdl.png" alt="添加技能：从我的记忆转化或上传技能" width={480} style={{ borderRadius: '8px' }} />

选择「上传技能」后，在上传区点击选择或拖拽技能包。支持 **.zip / .skill**，大小 **≤ 10MB**。

<img src="https://b.ux-cdn.com/uxarts/files/t20260810170601/tlyoo3q9.png" alt="上传技能包：拖拽或选择文件，须包含 SKILL.md" width={480} style={{ borderRadius: '8px' }} />

* 包内须包含 **SKILL.md**（可放在根目录或子文件夹下）。
* 可选包含 `scripts/`、`examples/`、`resources/` 等目录。
* 上传后系统会校验技能包内容；若有错误，会 **批量收集并明细展示**，便于逐项修正后重试。
* 上传后还会走 **适配审核**：自动判断该技能是 **可直接使用**、**需改写后使用**，还是因能力不支持 **无法接入**（以产品内结果为准）。
* 若需要改写，面向你的说明会写清结果与影响；不会堆砌不必要的平台内部实现细节。
* 审核元数据要求恰好 **一个** 分类标签：业务知识 / 设计规范 / 设计系统 / 技术实现。
* 技能 ID **不允许** 以 `skill.` 开头。
* 导入成功后，可按下方流程发起团队分享与审批。

## 团队技能

团队技能只会在 **当前项目所属团队精确匹配** 时显示。个人项目不能使用团队技能；团队项目中，团队技能可以和你的个人技能同时使用。

<img src="https://b.ux-cdn.com/uxarts/files/t20260723203450/8nujc0su.png" alt="项目技能库的团队技能 Tab" width={800} style={{ borderRadius: '8px' }} />

## 管理我的技能

点击右上角头像，在菜单中选择 **「我的技能」**。

<img src="https://b.ux-cdn.com/uxarts/files/t20260723203450/f3bwdok8.png" alt="头像菜单中的我的技能入口" width={360} style={{ borderRadius: '8px' }} />

「我的技能」独立页面包含「官方」「个人」「团队」三个 Tab，可集中浏览和管理不同来源的技能。

<img src="https://b.ux-cdn.com/uxarts/files/t20260723203450/giwfda1t.png" alt="我的技能独立管理页面" width={800} style={{ borderRadius: '8px' }} />

### 项目中的快捷入口

在项目页打开项目名称菜单，也可以选择 **「我的技能」**。系统会根据项目进度打开合适的页面：

* 尚未进入研发时，进入独立的「我的技能」页面；
* 进入研发后，直接打开当前项目的技能库；
* 部分旧项目会直接进入项目内技能库。

## 将个人技能分享给团队

只有个人技能的创建者可以发起分享；分享前，你需要先加入目标团队。

1. 先创建个人技能，或将「我的记忆」转化为个人技能。
2. 加入需要使用该技能的团队。
3. 在个人技能中发起团队分享。
4. 根据页面状态查看审核进度：

* **未分享**：技能仍只属于个人，尚未提交给团队。
* **待审核**：已提交分享申请，等待团队管理员审核。
* **已共享**：审核通过，技能可供该团队使用。

团队管理员可以移除已共享技能。移除只会解除技能与 **当前团队** 的关联，不会删除原个人技能。

## 在项目中使用技能

* **个人项目**：可使用官方技能和当前用户的个人技能。
* **团队项目**：可使用官方技能、当前用户的个人技能，以及与当前项目所属团队匹配的团队技能。

## 常见问题

<AccordionGroup>
  <Accordion title="为什么我看不到团队技能？">
    请确认当前项目属于团队、你已加入该团队，并且技能已通过该团队的分享审核。个人项目不会显示团队技能。
  </Accordion>

  <Accordion title="我加入了多个团队，会显示所有团队的技能吗？">
    不会。项目内只显示与当前项目所属团队精确匹配的团队技能。
  </Accordion>

  <Accordion title="协作者能看到项目创建者的个人技能吗？">
    不能。每位用户只能看到自己的个人技能，不会看到项目创建者或其他协作者的个人技能。
  </Accordion>

  <Accordion title="分享给团队后会立即生效吗？">
    不会。提交后状态为「待审核」，需要团队管理员审核通过后才会变为「已共享」。
  </Accordion>

  <Accordion title="分享后，它还是我的个人技能吗？">
    是。分享会建立个人技能与团队的关联，原个人技能仍归你所有，也可以继续作为个人技能使用。
  </Accordion>

  <Accordion title="管理员移除团队技能会删除我的个人技能吗？">
    不会。管理员移除只会解除该技能与当前团队的关联，不会删除你的个人技能。
  </Accordion>
</AccordionGroup>
