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

# Agent Skills

> 在兼容的 AI 智能体中安装并使用 Nonce 和 reboot-report skills

Nonce Agent Skills 可以让兼容的智能体连接 Nonce，通过自然语言查询矿场资源并生成运维报告。官方
[agent-skills 仓库](https://github.com/noncehq/agent-skills)包含两个 skill：

* `nonce` 负责登录认证、数据访问、代码化预处理、精简输出和受保护的运维操作。
* `reboot-report` 分析单个矿场的重启活动，并生成可分享的 HTML 报告。

<Note>
  生成重启报告时，默认同时安装两个 skill。当 `nonce` 不可用，或者你明确选择已有的 Nonce 登录连接时，
  `reboot-report` 可以使用该连接作为回退。每份报告只使用一种数据通道。
</Note>

## 使用前准备

* 支持 Agent Skills 的智能体
* 一个 Nonce 账号
* 使用命令行安装时所需的 Node.js 和 `npx`

支持的目标和安装行为以最新的
[skills.sh 文档](https://www.skills.sh/docs/cli)为准。`nonce` 会在首次使用时检查自身运行环境，并引导智能体完成
Nonce 授权。

## 安装

### 方式一：使用纯文本 prompt（推荐）

<Prompt description="为当前项目安装并验证 Nonce Agent Skills" actions={["copy"]}>
  请按照 [https://docs.nonce.app/api-guide/mcp/agent-skills-install](https://docs.nonce.app/api-guide/mcp/agent-skills-install) 为当前项目安装并验证 Nonce Agent Skills。
</Prompt>

安装 skills 或打开浏览器授权流程前，智能体可能会请求你的操作许可。

### 方式二：使用 npx

推荐同时安装两个 skill：

```bash theme={null}
npx skills add noncehq/agent-skills --skill nonce --skill reboot-report
```

当 `nonce` 不可用，或者你明确选择已有的 Nonce 登录连接时，只安装报告 skill：

```bash theme={null}
npx skills add noncehq/agent-skills --skill reboot-report
```

按照 skills.sh 的交互提示和文档，为当前环境选择合适的目标和作用域。

## 连接并验证

安装完成后，发送：

```text theme={null}
连接我的 Nonce 账号，并列出我的工作区。
```

* 使用 `nonce` 时，智能体会按照该 skill 的运行环境和认证流程调用 `listWorkspaces`。
* 使用回退连接时，智能体会执行该连接的工作区列表操作。

只有所选通道的只读查询成功返回后，才能认为安装验证完成。

<Note>
  Skills 使用当前 Nonce 账号的权限。遇到权限错误时，应调整账号角色或矿场授权范围，而不是扩大查询范围。
</Note>

## 使用方法

### 查询矿场资源

```text theme={null}
列出我的矿场，并汇总当前离线的矿机。
```

`nonce` 会查找所需的工作区和矿场标识，通过代码组合数据，并返回精简结果。

### 生成重启分析报告

请求中应包含一个矿场、明确的时间范围和时区：

```text theme={null}
请为 Farm A 生成一份 7 月 1 日 00:00 到 7 月 8 日 00:00、时区为 Asia/Hong_Kong 的重启分析报告。使用 skill 自带的 HTML 模板，并把完成的报告保存到当前项目。
```

`reboot-report` 默认通过 `nonce` 收集并预处理数据，区分检测到的重启事件和 Nonce 下发的重启任务，并生成
只读 HTML 报告。当 `nonce` 不可用时，已有的 Nonce 登录连接仍可作为回退。

### 执行运维操作

`nonce` 可以执行影响真实矿机或运维数据的操作。创建任务批次前，智能体必须展示准确的目标和预期效果，并
获得你的明确确认。

## 更新

### 方式一：使用纯文本 prompt（推荐）

<Prompt description="更新并验证已安装的 Nonce Agent Skills" actions={["copy"]}>
  请按照 [https://docs.nonce.app/api-guide/mcp/agent-skills-install](https://docs.nonce.app/api-guide/mcp/agent-skills-install) 中的升级流程，更新并验证已安装的 Nonce skills。
</Prompt>

### 方式二：使用 npx

按照最新的 [skills.sh 文档](https://www.skills.sh/docs/cli)更新已安装的 skill，不要改变原有目标或作用域。若两个
skill 均已安装，应同时更新。更新旧版 `nonce` 前，应将 `.nonce-skill/tasks/` 中用户创建的文件保存到已安装
skill 目录之外。