跳到主要内容

Skills 模型介绍

本文档基于 @aicloud360/360-ai-cloud-disk-cli 的 Skills 能力说明（自 v0.8.0 起支持，含后续版本）：

  • MCP Skill：通过 executor.py 调用 MCP Server
  • CLI Skill：通过 Shell 直接调用 360disk CLI

如果你正在选型：

  • 需要标准 MCP Tool 能力、希望走 HTTP/NPX/Local 三种连接模式，优先选 MCP Skill。
  • 需要强命令行编排、管道处理、CI/CD 自动化，优先选 CLI Skill。

一图看懂四种接入模型​

1) MCP Server 直连：AI Client -> MCP Protocol -> mcp-server-disk
2) MCP Skill：AI -> SKILL.md -> executor.py -> MCP Server
3) CLI：Shell/Script -> 360disk -> Services -> OpenAPI
4) CLI Skill：AI -> SKILL.md -> Shell(360disk ...)

它们底层共享同一套 Service 层（DirOps / FileOps / CloudOps / UserOps），差异主要在调用协议和执行入口。

MCP Skill（当前实现）​

核心能力​

当前 skill-output/SKILL.md 映射了 9 个工具（实际启用）：

  • file-list
  • file-search
  • file-save
  • file-share
  • file-move
  • file-rename
  • make-dir
  • user-info
  • file-upload-stdio

说明：

  • file-download-stdio 和 get-download-url 在当前 skill 转换配置中均为 convert: true，均在 MCP Skill 工具映射内。

连接模式​

MCP Skill 执行器支持 3 种模式（MCP_MODE）：

  • http（默认，推荐）：调用远程 MCP HTTP 端点
  • npx：npx @aicloud360/360-ai-cloud-disk-cli@latest --stdio
  • local：本地 node ./build/index.js --stdio

当模式是 http 且调用 file-upload-stdio 时，执行器会自动切到 npx 以支持本地文件上传。

适用场景​

  • 需要 Agent 使用 Tool 语义调用云盘能力
  • 需要降低上下文 token 成本（SKILL.md 精简映射）
  • 希望在同一 Skill 内兼容远程 HTTP 与本地 stdio 运行

CLI Skill（当前实现）​

CLI Skill 来自 skill-cli-output/360disk-cli/SKILL.md，本质是把用户意图映射到 360disk 命令。

核心能力​

可覆盖 CLI 的完整命令体系（与 CLI 命令参考 一致，当前为 8 组 31 个子命令）：

  • auth: login / login-wechat / whoami / logout
  • user: info
  • dir: ls / mkdir
  • file: mv / trans-copy / rename / rm / search / share / url / node-info / origin-size / clear-dir / config / save / append / exists / upload / download
  • completion: install / uninstall / script

模型优势​

  • 直接走 Shell 命令，链路简单
  • JSON 输出稳定，天然适合 Agent 与脚本处理
  • 支持管道与批量场景（例如 --quiet + jq、file rm --batch）

MCP Skill vs CLI Skill​

维度MCP SkillCLI Skill
执行入口executor.py -> MCP Server360disk 命令
协议形态MCP Tool 调用Shell 命令
默认覆盖能力18 个核心工具31 个完整命令
本地上传能力通过 file-upload-stdio（HTTP 下自动降级 npx）原生支持 file upload
自动化与管道中等强
典型使用MCP 生态 Agent 平台Claude Code / Cursor / CI

快速开始​

MCP Skill​

  1. 在 ecs_mcp 仓库中构建并生成产物：
    • npm install && npm run build
    • npm run skill:convert → 生成 skill-output/（含 SKILL.md、executor.py、references/、.env.example 等）
    • （可选）打包 zip 便于分发：
      • npm run skill:package → packages/360AICloudDiskSkill-v<version>.zip（文件名含版本号）
      • npm run skill:package:no-version → packages/360AICloudDiskSkill.zip（固定文件名，适合脚本或平台固定路径）
      • 上述 zip 解压后均含最外层目录，目录名与 zip 文件名（去掉 .zip）一致
  2. 配置环境变量（至少 API_KEY；可复制 .env.example 为 .env，默认 MCP_MODE=http）
  3. 在目标 Agent 平台加载 Skill（可直接使用 skill-output/ 目录，或解压上述 zip 后使用）

CLI Skill​

  1. 推荐执行前缀：DISK_360_CLI='npx -y -p @aicloud360/360-ai-cloud-disk-cli@latest 360disk'
  2. 登录：$DISK_360_CLI auth login --api-key <API_KEY>，或使用 $DISK_360_CLI auth login-wechat（微信扫码：终端字符码 / --qr-mode file 落盘 PNG；集成侧推荐 --format json 读两行 stdout——首行 type: qr 含 qr_image_data_url 与裸 qr_image_base64，或 --qr-mode file 时首行 type: qr_file 仅含 qr_image_path）
  3. 加载 skill-cli-output/360disk-cli 到 Agent 的 skills 目录

说明：

  • 交互/日常使用建议 @latest（热更新）
  • 回归/CI 建议固定版本（如 @0.8.6）以保证可复现

相关文档​