# Aic CLI

> AIC CLI 命令行工具使用指南。搜索、下载、安装、管理 Coding Agent 的 skills。 当用户需要搜索、下载、安装、导入、打包 skills，或管理技能包时使用。 触发词："skill"、"技能"、"技能包"、"aic-cli"、"下载skill"、"安装skill"、"搜索skill"。

- Skill: `cicbyte/aic-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cicbyte/aic-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cicbyte/aic-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: cicbyte (https://skillmd.com/u/cicbyte)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cicbyte/aic-cli

---


# AIC CLI 使用指南

AIC CLI 是用于管理 Coding Agent skills 的命令行工具，支持从 AIC 服务器搜索、下载、安装 skills。

## 命令总览

```
aic-cli skill           # 技能管理（搜索、下载、安装）
aic-cli package         # 技能包管理（列表、添加）
aic-cli server          # 服务器操作（打开页面、查看状态）
aic-cli version         # 显示版本信息
```

> 创建和维护技能请使用 `aic-author` skill。

## 搜索技能

```bash
aic-cli skill search "关键词"
aic-cli skill search "前端" -c 1        # 按分类筛选
aic-cli skill search "react" -p 1 -n 10 # 分页
```

## 安装技能

```bash
aic-cli skill add <skill-id>
aic-cli skill add <skill-name>
aic-cli skill add "obsidian" --agent cursor    # 指定目标 Agent
aic-cli skill add "obsidian" -o ./custom-dir   # 指定输出目录
aic-cli skill add "obsidian" -m symlink        # symlink 模式
```

支持的 `--agent` 值：
- `claude`（默认）、`cursor`、`continue`、`amazonq`、`copilot`
- `windsurf`、`cline`、`opencode`、`codex`、`gemini`
- `roo`、`amp`、`trae`、`openclaw`、`qclaw`、`hermes`、`codebuddy`、`qoder`

不指定 `--agent` 时，自动检测当前项目的 Agent，多个时交互选择。

## 下载技能

```bash
aic-cli skill download <skill-id>
aic-cli skill download "obsidian" -o ./downloads
```

## 导入技能

```bash
aic-cli skill import ./my-skill.zip
aic-cli skill import ./my-skill.skill
aic-cli skill import ./my-skill-folder/
aic-cli skill import ./my-skill.zip -d "技能描述" -c 1
```

## 查看分类

```bash
aic-cli skill categories
```

## 本地管理

### 列出已安装的技能

```bash
aic-cli skill list               # 当前项目
aic-cli skill list -g            # 全局目录
aic-cli skill list --agent cursor # 指定 Agent
```

### 移除已安装的技能

```bash
aic-cli skill remove <skill-name>
aic-cli skill remove <skill-name> -g            # 同时删除全局源文件
aic-cli skill remove <skill-name> --agent cursor # 指定 Agent
```

### 清理失效软链接

```bash
aic-cli skill clean
```

## 打包技能

```bash
aic-cli skill pack ./my-skill/                  # 默认 .zip
aic-cli skill pack ./my-skill/ --format skill   # .skill 格式
aic-cli skill pack ./my-skill/ -o output.zip    # 指定输出文件名
```

## 安装模式

```bash
aic-cli skill mode               # 查看当前模式
aic-cli skill mode symlink       # 切换到 symlink 模式
aic-cli skill mode copy          # 切换到 copy 模式
```

## 技能包管理

```bash
aic-cli package list                    # 列出所有技能包
aic-cli package list -s "前端"          # 搜索技能包
aic-cli package add <package-id>        # 按 ID 添加
aic-cli package add "前端工具"           # 按名称添加
aic-cli package add 1 --agent cursor    # 指定目标 Agent
```

## 服务器操作

```bash
aic-cli server open    # 在浏览器中打开 AIC 服务页面
aic-cli server status  # 查看服务器连接状态
```

## 多 Agent 支持

| Agent | 项目级目录 | 全局目录 |
|-------|-----------|---------|
| claude | `.claude/skills/` | `~/.claude/skills/` |
| cursor | `.cursor/rules/` | `~/.cursor/rules/` |
| opencode | `.opencode/skills/` | `~/.config/opencode/skills/` |
| trae | `.trae/skills/` | `~/.trae/skills/` |

安装模式：
- `symlink`（默认）：下载到全局目录，创建软连接到目标目录
- `copy`：直接复制文件到目标目录

## 注意事项

- 使用前需先通过 `aic-cli server status` 确认服务器连接正常
- 名称匹配如有多个结果，会交互式提示选择
- 已存在的 skill 会自动跳过，不会重复安装