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 工作流
- 先检查配置 — 未配置时不要猜测密钥,提示用户补全
.env:node --env-file-if-exists=.env .cursor/skills/s3-upload/scripts/s3-cli.js config - 选命令 — 上传用
upload;浏览用list;按名称搜用find;取公网链用url。 - 优先
--json— 需要解析结果给后续步骤时用 JSON 输出。 - 从仓库根目录执行 — 依赖根目录
node_modules中的@aws-sdk/client-s3。 - 删除需
--yes— 避免误删;向用户确认后再删。 - 失败时必须给出正确反馈 — 见下方「错误处理」;不要编造 URL 或假装上传成功。
错误处理(Agent 必遵)
CLI 失败时 exit code = 1。加 --json 时 stdout 为结构化 JSON(含 code、error、hint),Agent 必须解析后再回复用户。