SuperAPI AI 工具集

volcengine-troubleshooting

通用与其它

查看项目

更新于 10-16 01:49

技能介绍

用途:面向本地环境,在不修改云上资源的前提下,帮助排查火山引擎产品、OpenAPI、Python SDK、ve/tosutil CLI 与控制台操作失败的原因。

主要能力:主入口保留启动规则、场景路由与安全边界,本地工具检查与领域索引见 references/getting-started.md,OpenAPI 报错、签名、鉴权、参数、限流及调用链路快速检查见 references/openapi-quick-check.md,具体产品域手册见 references/domain-guides/。领域路由包括 openapi-sdk-cli、account-permission、billing-quota、compute-container-network、storage-database、domain-cdn-ingress、communication-media、llm-ecosystem、security-kms-encryption。

使用方式:先把 SKILL_ROOT 解析为包含 SKILL.md 的绝对目录,路径均从 ${SKILL_ROOT} 解析,不依赖仓库布局或当前工作目录。开始前先读 references/getting-started.md,确认本地工具、环境变量、场景依赖与领域路由;如用户允许执行本地体检,运行:bash "${SKILL_ROOT}/scripts/common_check.sh",并优先用 ve sts GetCallerIdentity 验证身份链路。按路由打开 references/domain-guides/<domain>/README.md,再读其“先读这些”中的 query-cli-catalog.md、章节 README、api-coverage-matrix.md 和脚本 README。取证时先从报错提取 RequestId、ErrorCode、Action、Service、Region、资源 ID、发生时间和调用方式,缺失就先问最少必要问题;无法分类时运行 common_check.sh 后,按服务名查 ve SERVICE --help 和 ve SERVICE ACTION --help。

限制:默认只执行 Describe/List/Get/Query/Lookup/Check 类只读命令,写操作须先解释影响并等待确认;不要运行 ve configure、登录/SSO 初始化、安装依赖、写配置文件或改云资源,除非用户明确要求并确认。凭证只从环境变量读取,不打印 SecretKey、SessionToken 或完整 AccessKeyId,展示 AK 需遮蔽。CLI 仅支持 ve 和 tosutil,SDK 脚本仅在分页聚合、跨资源拓扑、日志归并或 CLI 未覆盖时使用。反馈为可选,不替代故障处理,同一对话主动邀请最多一次。