什么是 Skill
Skill 文件是一个 Markdown 指令集,放在 ~/.claude/skills/ 目录下。 AI Agent(Claude Code 等)启动时会扫描这个目录,加载 Skill 后便获得了对应的操作能力。
Demos Skill 教 Agent 如何使用 demos CLI 完成应用部署, 包括检查安装、登录认证、上传文件、返回公开链接。你不需要打开浏览器、不需要手动填写表单,Agent 全自动完成。
工作原理
三个角色协作完成一次部署:
用户──"帮我把这个页面部署到 Demos"──▶AI Agent
│
│读取 Skill 文件,学会了 demos 命令
▼
demos login(如需)
demos deploy path/to/app.html
▼
✅ https://demos.zzxun.cn/abc12345
│
│把链接返回给用户
▼
用户◀──"部署成功!🔗 https://demos.zzxun.cn/abc12345"──AI Agent
安装 Skill
方式一:CLI 自动安装(推荐)
demos skill install自动从 Demos 平台拉取最新 Skill 文件,写入 ~/.claude/skills/demos-upload.md
方式二:手动安装
curl /api/skill?format=md -o ~/.claude/skills/demos-upload.md先 mkdir -p ~/.claude/skills,再用 curl 下载(域名自动取当前页面地址)
Agent 执行流程
Skill 文件教会 Agent 按以下步骤操作:
1
检查 CLI 是否安装
运行 demos --version,如未安装则提示 npm install -g demos-cli
2
检查登录状态
运行 demos whoami,如未登录则提示 demos login(打开浏览器完成 OAuth)
3
部署应用
运行 demos deploy <path> --name "应用名",把输出的 URL 告诉用户;若是更新已有应用则运行 demos update <path> <链接或 code>
快速开始
1
安装 CLI
npm install -g demos-cli或从源码:git clone https://github.com/ZZXUN233/ai-bed.git && npm install -g ./ai-bed/cli
2
登录 + 安装 Skill
demos logindemos skill install3
对 AI Agent 说一句话即可部署
帮我把 ./my-app.html 部署到 Demos完整演示
# 1. 安装 Skill(仅需一次)
$ demos skill install
✅ Skill installed to ~/.claude/skills/demos-upload.md
# 2. 在 Claude Code 里对 Agent 说:
用户:帮我把 /tmp/my-app.html 部署到 Demos,名叫「我的作品」
# 3. Agent 读取 Skill 后自动执行:
$ demos whoami
Logged in as: zzxun / Token expires: 2026/9/2
$demos deploy /tmp/my-app.html --name "我的作品"
Deploying "我的作品" from /tmp/my-app.html...
✅ Deploy successful!
App: https://demos.zzxun.cn/sk3cv09e
# 4. Agent 把链接返回给你
Agent:部署成功!访问链接:https://demos.zzxun.cn/sk3cv09e
# 5. 更新已有应用(原地升级版本)
用户:改好了,把 https://demos.zzxun.cn/view/sk3cv09e 更新一下
$ demos update /tmp/my-app.html https://demos.zzxun.cn/view/sk3cv09e
Updating app sk3cv09e from /tmp/my-app.html...
✅ Update successful!
Version: v2
App: https://demos.zzxun.cn/sk3cv09e
注意事项
- Skill 文件只是教 Agent 怎么做的指令,真正干活的是
demosCLI - Skill 内嵌平台 URL,从哪个环境下载就指向哪个环境(域名自动匹配当前页面)
- CLI Token 有效期 30 天,过期后 Agent 会提示你重新运行 demos login
- 整个部署过程不需要打开 Demos 网页、不需要手动填表单
- 支持 .html(最大 5MB)和 .zip(最大 50MB)两种文件格式