Manage files across cloud providers with authentication, cost awareness, and multi-provider opera。Use when 需要数据库操作、SQL查询、数据存储管理时使用。不适用于数据库架构设计决策.
功能说明: 本技能涵盖 中文交互、时使用、化工作流场景 等核心能力。
功能说明: 本技能涵盖 化集成场景 等核心能力。
Cloud Storage
付费版进阶功能
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| Cloud Storage跨云商管理 | 不支持 | 支持 |
| 多租户管理与权限分配 | 不支持 | 支持 |
| 操作审计与合规日志 | 不支持 | 支持 |
| 自定义仪表盘与报表 | 不支持 | 支持 |
| API开放与第三方集成 | 不支持 | 支持 |
场景示例
| 场景 | 输入 | 输出 |
|---|---|---|
| 文件上传 | 本地文件路径和目标存储 | 云端文件URL和存储元数据 |
| 存储管理 | 云存储桶和权限配置 | 存储使用量和成本报告 |
| 跨云迁移 | 源云和目标云配置 | 迁移进度和完整性校验 |
不适用于:本地文件系统管理和内网文件共享
参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| provider | string | 是 | 云存储提供商, 可选: aws/azure/gcp/aliyun |
| operation | string | 否 | 操作类型, 可选: upload/download/list/cost, 默认: list |
输出说明
{
"success": true,
"data": {
"overall_grade": "A",
"total_score": 92,
"max_score": 100,
"summary": "处理完成",
"details": [
{
"item": "代码风格",
"status": "pass",
"score": 95,
"comment": "符合规范"
},
{
"item": "安全合规",
"status": "warn",
"score": 80,
"comment": "符合规范"
}
],
"improvements": [
{
"priority": "high",
"suggestion": "建议优化",
"expected_gain": "+5分"
},
{
"priority": "medium",
"suggestion": "建议优化",
"expected_gain": "+3分"
}
]
},
"error": null
}
安装与配置
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
工具依赖
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
可用性分类
- 分类: MD+execute()
- 说明: 基于Markdown的AI Skill,
API Key配置方式:
export API_KEY="${API_KEY:?请设置环境变量}"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
能力边界
- 依赖云服务,需要网络连接
- 需要有效的云服务凭证和配置好的CLI环境
- 产生的云资源可能产生费用,使用前请确认计费方式
- 不同区域的服务可用性和功能支持可能存在差异
技术创新
效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 文件上传 | 15分钟/次 | 2分钟/次 | 13分钟/次 | 5% |
| 文件下载 | 20分钟/次 | 3分钟/次 | 17分钟/次 | 4% |
| 存储桶列表查询 | 10分钟/次 | 1分钟/次 | 9分钟/次 | 3% |
| 文件权限配置 | 30分钟/次 | 5分钟/次 | 25分钟/次 | 2% |
| 跨云迁移 | 1天/次 | 4小时/次 | 20小时/次 | 10% |
差异化对比
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 简易性 | 高 | 低 | 中 | 高 |
| 跨云支持 | 多云 | 单一云 | 单一云 | 多云 |
| 成本 | 低 | 高 | 中 | 高 |
| 自动化程度 | 高 | 低 | 中 | 高 |
| 可扩展性 | 高 | 低 | 中 | 高 |
核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 管理复杂度 | 云存储资源分散,管理复杂 | 降低工作效率 | 提供统一管理平台 | 提高效率20% |
| 成本控制 | 缺乏成本监控,易超支 | 影响企业财务 | 实现成本感知 | 节省成本15% |
| 迁移困难 | 跨云迁移操作繁琐,成功率低 | 影响业务连续性 | 简化迁移流程 | 提高迁移成功率10% |
常见问题FAQ
Q1: 如何配置云存储的API Key?
A: 请参考依赖说明章节中的API Key配置方式,配置后需重启会话或开启新终端生效。
Q2: 支持哪些云存储提供商?
A: 目前支持AWS、Azure、GCP、阿里云等主流云存储提供商。
Q3: 如何实现跨云迁移?
A: 在使用流程中选择跨云迁移场景,根据提示配置源云和目标云配置,即可实现跨云迁移。
Q4: 如何监控存储成本?
A: 在存储管理场景中,可以通过输出报告查看存储使用量和成本。
Q5: 如何获取技能的输出结果?
A: 在调用技能后,输出结果会以JSON格式返回,详细输出格式请参考输出格式章节。
安全提示
- 确保API Key安全,避免泄露到版本控制系统。
- 定期更新云存储账户的密码,增强账户安全性。
- 严格限制API Key的使用范围,避免被滥用。
- 对敏感数据进行加密存储,保护数据安全。
- 监控异常访问行为,及时处理潜在安全风险。
安全风险防范
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置,禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令,避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议,验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限,实施认证机制 | 定期审计访问日志 |
错误恢复流程
针对云存储使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |
云存储通用排查步骤
- 检查输入参数: 确认所有必填参数已提供且格式正确
- 查看日志输出: 定位具体错误行和异常类型
- 验证环境配置: 确认依赖库版本和运行环境满足要求
- 逐步调试: 缩小问题范围,隔离故障模块
上线流程
- 配置API密钥: 在环境变量中设置对应的API Key
- 初始化连接: 使用提供的凭证建立API连接
- 调用接口: 传入必要参数执行API调用
- 准备文件: 确认文件路径正确且格式受支持
- 执行处理: 调用对应的处理函数
- 查看结果: 检查输出文件或返回数据
- 检查环境: 确认运行时和依赖已安装
- 执行命令: 使用正确的参数格式执行
- 查看输出: 检查命令输出和退出码
前置条件
- 已安装所需运行环境(参考依赖说明)
- 已获取必要的API密钥或访问凭证(如适用)
- 输入数据已准备就绪
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 1mo ago
- Current version
- v1.0.2
- License
- MIT-0
