Skip to content

skill.md

Latest commit

 

History

History
293 lines (199 loc) · 6.63 KB

skill.md

File metadata and controls

293 lines (199 loc) · 6.63 KB
Raw

English | 简体中文

ar skill

管理 Skill 技能包。Skill 是以 ZIP 打包的目录，包含 SKILL.md 指令文件和 实现代码。命令分为两个平面：

  • 控制面：上传、列表、查看、下载、删除平台上的 Skill。
  • 数据面：扫描本地 Skill、读取 SKILL.md 指令、读取文件、在 Skill 目录中 执行命令。

子命令

控制面：

数据面（本地）：

同步（批量下载到 AI 工具目录）：

create

把本地 Skill 目录打包上传到平台。

ar skill create --name <name> --code-dir <dir> [options]

参数

Flag 类型 必填 默认 说明
--name string 是 全局唯一 Skill 名。
--code-dir path 是 包含 SKILL.md 的本地目录。
--description string 否 自动 省略时从 SKILL.md 的 YAML frontmatter 读取。
--credential string 否 凭证名。
--from-file path 否 完整创建配置的 JSON 文件。

示例

ar skill create --name web-scraper --code-dir ./skills/web-scraper
ar skill create --name restricted --code-dir ./skills/restricted --credential my-key

list

ar skill list [--page-number <n>] [--page-size <n>]

参数

Flag 类型 必填 说明
--page-number int 否 页码。
--page-size int 否 每页条数。

示例

ar skill list
ar skill list --page-size 50

get

ar skill get --name <name>

示例

ar skill get --name web-scraper

download

下载 Skill 包并解压到本地目录。

ar skill download --name <name> [--dir <dir>]

参数

Flag 类型 必填 默认 说明
--name string 是 Skill 名。
--dir path 否 .skills 解压到的目标目录。

示例

ar skill download --name web-scraper
# → 解压到 ./.skills/web-scraper/

ar skill download --name web-scraper --dir ~/my-skills

delete

ar skill delete --name <name>

示例

ar skill delete --name web-scraper

scan

扫描本地 Skill 目录，列出每个 Skill 的元数据。

ar skill scan [--dir <dir>]

参数

Flag 类型 必填 默认 说明
--dir path 否 .skills 要扫描的 Skills 目录。

示例

ar skill scan
ar skill scan --dir ~/my-skills

load

打印某个本地 Skill 的指令（SKILL.md）和文件列表。

ar skill load --name <name> [--dir <dir>]

参数

Flag 类型 必填 默认 说明
--name string 是 Skill 名。
--dir path 否 .skills 本地 Skills 目录。

示例

ar skill load --name web-scraper

如果 Skill 不存在，以退出码 1 结束并提示 Skill '<name>' not found in <dir>。

read-file

读取某个 Skill 目录下的文件（或列目录），内容按原始格式打印，方便管道传给 其他工具。

ar skill read-file --name <name> --path <relpath> [--dir <dir>]

参数

Flag 类型 必填 默认 说明
--name string 是 Skill 名。
--path string 是 相对于 Skill 目录的路径。
--dir path 否 .skills 本地 Skills 目录。

示例

ar skill read-file --name web-scraper --path scraper.py
ar skill read-file --name web-scraper --path assets/  # 列目录

exec

在 Skill 目录下执行 shell 命令（以该目录为 cwd）。

ar skill exec --name <name> --command <cmd> [--dir <dir>] [--timeout <sec>]

参数

Flag 类型 必填 默认 说明
--name string 是 Skill 名。
--command string 是 要执行的 shell 命令。
--dir path 否 .skills 本地 Skills 目录。
--timeout int 否 300 超时时间（秒）。

示例

ar skill exec --name web-scraper --command "python scraper.py --url https://example.com"
ar skill exec --name my-skill --command "pytest tests/" --timeout 600

sync

把平台 Skills 批量同步到本地 AI 工具技能目录（增量下载，支持可选清理）。

ar skill sync --tool <tool> (--user | --project) [options]

参数

Flag 类型 必填 默认 说明
--tool choice 是 目标 AI 工具，见下表。
--user flag 是* 同步到用户级目录。
--project flag 是* 同步到项目级目录。
--workspace multi 否 全部 工作空间过滤，可重复。
--delete-unmanaged flag 否 false 删除不在所选管控范围内的本地技能目录（需确认）。
-y、--yes flag 否 false 跳过确认提示。

* --user 与 --project 二选一。

--tool 可选值

选项 用户级路径 项目级路径
claude-code ~/.claude/skills .claude/skills
codex ~/.codex/skills .codex/skills
github-copilot ~/.github/copilot/skills .github/copilot/skills
cursor ~/.cursor/skills .cursor/skills
qoder ~/.qoder/skills .qoder/skills

行为说明

  • 默认同步全部平台 Skill（除非传入 --workspace）。
  • 在下载/更新前会先进行用户确认（传 -y 可跳过）。
  • 同步会检查本地元数据，仅下载缺失或有更新的 Skill。
  • 开启 --delete-unmanaged 时，会在再次确认后删除不在当前管控范围内的本地 Skill 目录。

示例

# 将 workspace abc + def 的 skills 同步到用户级 Claude Code 目录
ar skill sync --tool claude-code --user --workspace abc --workspace def

# 将 workspace abc 的 skills 同步到项目级 Codex 目录
ar skill sync --tool codex --project --workspace abc

# 跳过确认，将全部 skills 同步到项目级 Cursor 目录
ar skill sync --tool cursor --project -y

# 同步到 GitHub Copilot 用户级目录，并删除不在管控范围的本地 skills
ar skill sync --tool github-copilot --user --delete-unmanaged

# 同步到 Qoder 项目级目录
ar skill sync --tool qoder --project --workspace my-workspace