Skills 使用指南
本页帮助你了解 HagiCode 中的 Skills 面板应该怎么用。
如果你想完成下面这些事情，可以直接打开 Skills：
- 查看这台机器已经安装了哪些技能
- 根据当前项目和仓库获取推荐技能
- 在技能库中搜索某个技能
- 安装前确认来源、信任状态和实际执行命令
- 管理哪些来源会被标记为 trusted
Skills 是什么
Section titled “Skills 是什么”Skills 是 HagiCode 提供的技能浏览与安装面板。你可以把它理解为一个统一入口：在这里查看本地已安装技能、浏览推荐内容、搜索整个技能库，并在安装前确认来源和安全提示。
它特别适合下面几种场景：
- 你刚开始接触 HagiCode，想先知道系统已经有哪些可用技能
- 你正在处理某类项目，希望快速找到更合适的辅助技能
- 你准备安装一个新技能，但想先确认来源是否可信
- 你想知道某个技能是否已经装过，避免重复安装
1. 打开 Skills
Section titled “1. 打开 Skills”在 HagiCode 主界面的顶部导航栏中，点击 Skills 按钮即可打开 Skills 面板。
你可以先关注截图中的红色箭头，它标出了入口位置。
打开后，你会看到同一个面板中的 4 个主要标签页：
- 本地技能（
Local Skills） - 推荐（
Recommendation） - 技能库（
Gallery） - 可信来源（
Trusted Providers）
2. 查看本地已安装的技能
Section titled “2. 查看本地已安装的技能”本地技能页（Local Skills）适合回答两个最常见的问题：我已经装了什么？这些技能目前能不能更新？
在这个页面里，你可以重点看这几个区域：
- 搜索框：按名称、ID、路径或 agent 过滤本地技能
- 刷新清单（
Refresh inventory）：重新扫描本机当前已安装的技能 - 全部更新（
Update all）：批量更新支持托管更新的技能 - 批量更新摘要（
Batch update summary）：查看这次批量更新的结果和最新日志
列表中的每一行通常会显示：
- 技能名称
- 适用的 agent
- 本地安装路径
- 当前可执行操作
如果某一行出现“缺少后端托管安装元数据”之类的提示，说明这项技能不能通过一键更新流程处理，需要你单独确认。
3. 获取推荐技能
Section titled “3. 获取推荐技能”推荐页（Recommendation）用来根据你当前的项目和仓库上下文生成候选技能，适合在“我知道自己要做什么，但还不确定该装哪些技能”时使用。
这个页面建议按下面顺序理解：
- 先看顶部的 hero 选择器，确认这次推荐参考的是哪类工作角色
- 点击生成推荐（
Generate recommendations）生成候选集 - 查看中间的查询标签（query chips），理解系统为什么给出这批推荐
- 再看下方候选卡片，判断哪些值得进一步打开详情
推荐卡片上的常见标签含义如下：
Recommended：这是系统当前推荐你关注的技能Installed：该技能已经处于已安装状态Installed locally：这项技能已经在当前本地环境可用，通常不需要再次安装
4. 在技能库中搜索和比较
Section titled “4. 在技能库中搜索和比较”如果你已经知道要找什么，或者想在更大范围内比较不同来源的技能，可以使用技能库页（Gallery）。
技能库页（Gallery）更适合做这些事情：
- 按关键词搜索技能
- 先筛选 trusted 来源，再决定是否继续浏览
- 比较不同来源的同类技能
- 查看安装量和当前安装状态
建议重点关注 3 个信息：
- 来源（
Source）：技能来自哪个提供方或仓库 - 安装量（
Installs）：这项技能的安装量，可作为参考信号 Installed locally：说明它已经在本地可用
5. 安装前查看技能详情
Section titled “5. 安装前查看技能详情”打开某个技能后，会进入技能详情面板（Skill Details）。这里是安装前最值得认真看的页面。
在技能详情面板中，建议重点查看以下内容：
- 技能名称、来源、安装量：确认你打开的是目标条目
- 可信状态（
Trust status）：查看这条来源为什么会被视为可信 - 托管命令（
Managed command）：查看 HagiCode 实际准备执行的安装命令 - 当前状态（
Status）：判断当前工作区能否安装这项技能 - 概览（
Overview）：补充查看技能 ID、slug、source、install count 等基础信息
Managed command 特别重要，因为它展示的是安装时真正会运行的命令，而不是一段说明文字。
6. 管理可信来源规则
Section titled “6. 管理可信来源规则”可信来源页（Trusted Providers）用来管理“哪些来源会被标记为 trusted”。如果你想知道某个技能为什么显示 trusted，或者你想补充自己的来源规则，就看这个页面。
在这个页面中：
- 规则格式（
Rule format） 会说明规则怎么写 - 添加提供方（
Add provider） 用于新增一组 provider 规则 - 恢复默认值（
Reset defaults） 用于恢复默认预设 - 表格中的
Rules、Status、Source examples用来说明匹配规则、当前状态和命中示例
常见规则形式包括：
prefix:owner/：按前缀匹配一组来源exact:owner/repo：只匹配单个来源
安装前请检查这 4 项
Section titled “安装前请检查这 4 项”如果你准备安装一个技能，建议至少检查下面 4 项：
| 检查项 | 在哪里看 | 说明 |
|---|---|---|
| 来源是否可信 | Trusted Providers、技能详情页中的 Trust status | 确认这个来源为什么会被标记为 trusted |
| 是否已经安装 | Recommendation、Gallery 的状态标签 | 如果显示 installed locally，通常无需重复安装 |
| 批量更新结果 | Local Skills 中的 Batch update summary | 用来查看这次批量更新是否成功、是否需要人工复核 |
| 实际安装命令 | 技能详情页中的 Managed command | 安装前建议先看一遍实际会执行什么命令 |
常见使用路径
Section titled “常见使用路径”你可以按下面的顺序使用 Skills：
- 进入本地技能页（
Local Skills），先看本机当前已有技能 - 打开推荐页（
Recommendation），获取更贴合当前工作的候选技能 - 在技能库页（
Gallery）中搜索和比较不同来源 - 进入技能详情页，确认来源、信任状态和安装命令
- 如有需要，在可信来源页（
Trusted Providers）中复核或调整可信规则