---
title: Agent 技能
description: 安装 Linkdash 技能，让 Cursor、Claude Code 或 Codex 能够创建链接、上传文件、调用 HTTP API 并连接 MCP。
sidebar:
  label: Agent 技能
  order: 2
---
该技能就是 Agent 从网站和 npm 获取的同一个 `SKILL.md` 文件。

```bash
npx skills add https://linkdash.dev/skills/linkdash/SKILL.md
```

规范文件：[npm 上的 linkdash-skill](https://www.npmjs.com/package/linkdash-skill)。网站副本：[https://linkdash.dev/skills/linkdash/SKILL.md](https://linkdash.dev/skills/linkdash/SKILL.md)。

安装技能后，Agent 仍需要 CLI（或 API 密钥）才能实际执行操作。请安装 [`linkdash-cli`](https://www.npmjs.com/package/linkdash-cli)，其命令为 `linkdash`。请参阅[快速入门](/zh/quickstart)。

## 技能涵盖的内容

- 创建 URL、文件和文本链接
- 变体：在一个链接上配置多个目标地址，并设置权重和访客条件（`--variant`、`links variants`、`--when`、`--sticky`）
- 更新、暂停、列出和删除
- 文件夹：创建、移动、复制以及列出单个文件夹的内容（`--folder`、`--in`、`links move`、`links copy`）
- 访问与共享：默认受限，`--access link|public`，通过邮箱共享（`links share`、`links shares`、`links unshare`、`links shared`、`links leave`、`links role`、`links unlock`、`links activity`、`links reset-link`）
- 统计数据、CSV 导入/导出
- 自定义域名
- 账户级 HTTPS Webhook
- HTTP API，地址为 `https://api.linkdash.dev/v1`
- MCP，地址为 `https://api.linkdash.dev/mcp`

## Agent 规则（不可跳过）

1. 将 CLI 的 stdout 作为 JSON 解析。不要传入 `--json`。
2. 切勿编造参数、端点或令牌。
3. 除非用户要求确认步骤，否则不要对删除操作进行确认。
4. 切勿回显机密信息（`--password`、令牌、API 密钥、Webhook 密钥）。
5. 如果命令失败，请读取 stderr 或 JSON 中的 `error` 并修正参数。
6. 写操作计入每月事件配额，读操作不计入。
7. 新链接默认受限。对于将要公开发布的链接，请使用 `--access public`，并将输出的 `url` 交给用户。

CLI 无法更改邮箱、密码或账单信息。请引导用户前往[账单](https://linkdash.dev/dashboard/billing)或[设置](https://linkdash.dev/dashboard/settings)。API 密钥（HTTP 和 MCP）：[API 密钥](https://linkdash.dev/dashboard/keys)。
