s3-upload

Installation
SKILL.md

S3 Upload

通过 scripts/s3-cli.js 操作 S3 兼容存储(七牛 Kodo、MinIO、AWS S3 等)。配置来自环境变量,与 src/app-agent/lib/server/s3-storage.ts.env-template 一致。

Agent 工作流

  1. 先检查配置 — 未配置时不要猜测密钥,提示用户补全 .env
    node --env-file-if-exists=.env .cursor/skills/s3-upload/scripts/s3-cli.js config
    
  2. 选命令 — 上传用 upload;浏览用 list;按名称搜用 find;取公网链用 url
  3. 优先 --json — 需要解析结果给后续步骤时用 JSON 输出。
  4. 从仓库根目录执行 — 依赖根目录 node_modules 中的 @aws-sdk/client-s3
  5. 删除需 --yes — 避免误删;向用户确认后再删。
  6. 失败时必须给出正确反馈 — 见下方「错误处理」;不要编造 URL 或假装上传成功。

错误处理(Agent 必遵)

CLI 失败时 exit code = 1。加 --json 时 stdout 为结构化 JSON(含 codeerrorhint),Agent 必须解析后再回复用户

Installs
4
First Seen
Aug 22, 2026
s3-upload — liuhuapiaoyuan/shuangyuan-skills