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

# Skill 与 Reference

> 工作流的固化与触发配置，外部资料的导入与同步

## Skill：固化流程

Skill 把高频工作流写成文档：步骤、检查项、产出格式。遇到同类任务时，Agent 按 Skill 规范执行，不需要每次重新交代。策划等非程序成员按程序预先写好的 Skill 开发功能，也是推荐的协作方式，见[使用建议](/overview/usage-guidance)。

右键 Skill 分类`新建技能`创建。正文写流程本身，`配置`侧栏控制触发行为：

* **`描述`**：简短描述，用于检索和匹配。自动触发依赖它判断当前任务是否命中，应写清适用与不适用的场景。
* **`参数提示`**：/ 指令的参数占位说明，输入指令时显示。
* **`触发方式`**：四档。`不启用`（不出现在 / 命令面板，也不允许自动召回）、`仅指令`（只通过 / 指令手动触发）、`仅自动`（只由模型语义召回，不进命令面板）、`两者`。
* **`指令触发`**：/ 指令名，如 `/commit-batch`。与内置命令重复、或已被其他 Skill 占用时会提示冲突，需要换名。

## 技能包

Skill 可以打包分发。右键菜单提供三个操作：

* **`导入 Package`**：导入他人分享的技能包。包内文档只读，无法重命名、移动或删除。
* **`导出 Package`**：把自己的 Skill 导出为包文件，分享给团队。
* **`删除 Package`**：整包移除。

包内容需要修改时，由包作者更新版本后重新导入；插件提供的 Skill 同样只读，随插件更新，见[插件与视图](/extensions/plugins-and-views)。

## Reference：外部资料

Reference 存放项目之外的只读资料，导入后与项目知识一起参与检索。三种来源：

* **本地文件夹**：`导入外部文件夹`，选择目录后内容进入 Reference。
* **Unity 官方文档**：按当前项目的 Unity 版本下载官方离线文档，并转换为可检索的 Markdown。导入时选择`文档语言`（`中文` / `English`），独立窗口显示下载、解压、转换与索引进度；项目升级 Unity 版本后，页面会提示`重新导入`对应版本。
* **飞书文档**：配置飞书应用（应用身份，或经用户身份授权），选择知识空间与目录后托管导入其中的文档。

## 外部内容只读

外部导入的文档保持只读：修改需要回到原始来源（本地文件、飞书文档），再重新导入或同步。这保证 Reference 始终与来源一致，不会出现两边各改一份的分叉。导入 Unity 官方文档后，Agent 查 API 用法时可直接检索本地副本，配合[资产数据库](/assets/index)的引用分析，回答会更贴近当前项目版本。