本文へ移動
cccskills
無料GitHub で公開

volcengine-troubleshooting

Use when the user encounters VolcEngine errors or needs local troubleshooting for OpenAPI, Python SDK, CLI, IAM, billing, compute, networking, storage, database, CDN, media, AI, security, or VKE cases.

インストール方法を見る

含まれるファイル(122)

  • SKILL.md6.4 KB
  • references/domain-guides/account-permission/README.md7.9 KB
  • references/domain-guides/account-permission/references/01-overview-routing/README.md1.4 KB
  • references/domain-guides/account-permission/references/02-account-verification-risk/README.md1.1 KB
  • references/domain-guides/account-permission/references/03-iam-user-policy/README.md1.7 KB
  • references/domain-guides/account-permission/references/04-role-sts/README.md1.3 KB
  • references/domain-guides/account-permission/references/05-product-resource-access/README.md980 B
  • references/domain-guides/account-permission/references/06-access-key/README.md1.6 KB
  • references/domain-guides/account-permission/references/07-playbooks/README.md893 B
  • references/domain-guides/account-permission/references/api-coverage-matrix.md34.7 KB
  • references/domain-guides/account-permission/references/python-sdk-script-patterns.md495 B
  • references/domain-guides/account-permission/references/query-cli-catalog.md1.2 KB
  • references/domain-guides/account-permission/scripts/README.md459 B
  • references/domain-guides/billing-quota/README.md14.0 KB
  • references/domain-guides/billing-quota/references/01-overview-routing/README.md2.5 KB
  • references/domain-guides/billing-quota/references/02-balance-arrears-precharge/README.md3.2 KB
  • references/domain-guides/billing-quota/references/03-subscription-package/README.md2.9 KB
  • references/domain-guides/billing-quota/references/04-usage-quota-limit/README.md3.1 KB
  • references/domain-guides/billing-quota/references/05-order-purchase-activation/README.md2.3 KB
  • references/domain-guides/billing-quota/references/06-bill-cost-detail/README.md4.6 KB
  • references/domain-guides/billing-quota/references/07-playbooks/README.md2.5 KB
  • references/domain-guides/billing-quota/references/api-coverage-matrix.md11.3 KB
  • references/domain-guides/billing-quota/references/provider-code-aliases.md1.8 KB
  • references/domain-guides/billing-quota/references/python-sdk-script-patterns.md2.1 KB
  • references/domain-guides/billing-quota/references/query-cli-catalog.md2.8 KB
  • references/domain-guides/billing-quota/scripts/collect_billing_context.py19.1 KB
  • references/domain-guides/billing-quota/scripts/README.md3.3 KB
  • references/domain-guides/communication-media/README.md7.8 KB
  • references/domain-guides/communication-media/references/01-overview-routing/README.md1.4 KB
  • references/domain-guides/communication-media/references/02-sms-service/README.md1.4 KB
  • references/domain-guides/communication-media/references/03-rtc-webrtc/README.md1.1 KB
  • references/domain-guides/communication-media/references/04-vod-playback-media/README.md1.4 KB
  • references/domain-guides/communication-media/references/05-live-streaming/README.md1.6 KB
  • references/domain-guides/communication-media/references/06-cv-ocr-media-processing/README.md1.1 KB
  • references/domain-guides/communication-media/references/07-playbooks/README.md1.1 KB
  • references/domain-guides/communication-media/references/api-coverage-matrix.md48.2 KB
  • references/domain-guides/communication-media/references/python-sdk-script-patterns.md1000 B
  • references/domain-guides/communication-media/references/query-cli-catalog.md2.0 KB
  • references/domain-guides/communication-media/scripts/README.md500 B
  • references/domain-guides/compute-container-network/README.md12.7 KB
  • references/domain-guides/compute-container-network/references/01-overview-routing/README.md2.9 KB
  • references/domain-guides/compute-container-network/references/02-ecs-lifecycle-state/README.md3.3 KB
  • references/domain-guides/compute-container-network/references/03-login-os-access/README.md3.2 KB
  • references/domain-guides/compute-container-network/references/04-public-private-connectivity/README.md3.8 KB
  • references/domain-guides/compute-container-network/references/05-security-policy-port/README.md2.4 KB
  • references/domain-guides/compute-container-network/references/06-eip-nat-route-gateway/README.md3.5 KB
  • references/domain-guides/compute-container-network/references/07-vke-container-runtime/README.md3.4 KB
  • references/domain-guides/compute-container-network/references/08-image-init-cloudassistant/README.md1.9 KB
  • references/domain-guides/compute-container-network/references/09-playbooks/README.md3.3 KB
  • references/domain-guides/compute-container-network/references/api-coverage-matrix.md63.3 KB
  • references/domain-guides/compute-container-network/references/python-sdk-script-patterns.md5.2 KB
  • references/domain-guides/compute-container-network/references/query-cli-catalog.md3.0 KB
  • references/domain-guides/compute-container-network/scripts/collect_clb_backend_context.py9.8 KB
  • references/domain-guides/compute-container-network/scripts/collect_ecs_network_context.py6.6 KB
  • references/domain-guides/compute-container-network/scripts/collect_vke_pod_context.py6.1 KB
  • references/domain-guides/compute-container-network/scripts/README.md3.7 KB
  • references/domain-guides/domain-cdn-ingress/README.md9.3 KB
  • references/domain-guides/domain-cdn-ingress/references/01-overview-routing/README.md1.7 KB
  • references/domain-guides/domain-cdn-ingress/references/02-dns-domain-resolution/README.md1.5 KB
  • references/domain-guides/domain-cdn-ingress/references/03-ssl-https-certificate/README.md1.8 KB
  • references/domain-guides/domain-cdn-ingress/references/04-cdn-dcdn-cache-origin/README.md2.6 KB
  • references/domain-guides/domain-cdn-ingress/references/05-load-balancer-ingress/README.md2.6 KB
  • references/domain-guides/domain-cdn-ingress/references/06-public-origin-connectivity/README.md1.4 KB
  • references/domain-guides/domain-cdn-ingress/references/07-playbooks/README.md1.8 KB
  • references/domain-guides/domain-cdn-ingress/references/api-coverage-matrix.md24.7 KB
  • references/domain-guides/domain-cdn-ingress/references/python-sdk-script-patterns.md1.4 KB
  • references/domain-guides/domain-cdn-ingress/references/query-cli-catalog.md2.7 KB
  • references/domain-guides/llm-ecosystem/README.md12.2 KB
  • references/domain-guides/llm-ecosystem/references/01-overview-routing/README.md2.0 KB
  • references/domain-guides/llm-ecosystem/references/02-l1-model-capability/README.md1.7 KB
  • references/domain-guides/llm-ecosystem/references/03-l2-ark-maas/README.md1.9 KB
  • references/domain-guides/llm-ecosystem/references/04-l3-agent-development/README.md2.6 KB
  • references/domain-guides/llm-ecosystem/references/05-l4-ai-native-infra/README.md1.3 KB
  • references/domain-guides/llm-ecosystem/references/06-l5-vertical-scenarios/README.md3.2 KB
  • references/domain-guides/llm-ecosystem/references/07-cross-cutting/README.md2.0 KB
  • references/domain-guides/llm-ecosystem/references/08-playbooks/README.md3.0 KB
  • references/domain-guides/llm-ecosystem/references/api-coverage-matrix.md27.8 KB
  • references/domain-guides/llm-ecosystem/references/python-sdk-script-patterns.md2.1 KB
  • references/domain-guides/llm-ecosystem/references/query-cli-catalog.md6.0 KB
  • references/domain-guides/openapi-sdk-cli/README.md11.0 KB
  • references/domain-guides/openapi-sdk-cli/references/01-overview-routing/README.md2.1 KB
  • references/domain-guides/openapi-sdk-cli/references/02-openapi-call-model/README.md1.5 KB
  • references/domain-guides/openapi-sdk-cli/references/03-auth-signature/README.md2.2 KB
  • references/domain-guides/openapi-sdk-cli/references/04-parameters-version/README.md1.5 KB
  • references/domain-guides/openapi-sdk-cli/references/05-sdk-runtime/README.md1.9 KB
  • references/domain-guides/openapi-sdk-cli/references/06-cli-api-explorer/README.md1.5 KB
  • references/domain-guides/openapi-sdk-cli/references/07-errorcode-requestid/README.md1.3 KB
  • references/domain-guides/openapi-sdk-cli/references/08-api-gateway-cloudcontrol-iac/README.md2.3 KB
  • references/domain-guides/openapi-sdk-cli/references/09-playbooks/README.md1.7 KB
  • references/domain-guides/openapi-sdk-cli/references/api-coverage-matrix.md23.8 KB
  • references/domain-guides/openapi-sdk-cli/references/python-sdk-script-patterns.md2.5 KB
  • references/domain-guides/openapi-sdk-cli/references/query-cli-catalog.md3.0 KB
  • references/domain-guides/README.md1.6 KB
  • references/domain-guides/security-kms-encryption/README.md10.3 KB
  • references/domain-guides/security-kms-encryption/references/01-overview-routing/README.md1.8 KB
  • references/domain-guides/security-kms-encryption/references/02-kms-service-key-state/README.md2.2 KB
  • references/domain-guides/security-kms-encryption/references/03-key-permission-access-control/README.md1.6 KB
  • references/domain-guides/security-kms-encryption/references/04-crypto-params-secret/README.md2.0 KB
  • references/domain-guides/security-kms-encryption/references/05-key-lifecycle-hsm/README.md1.3 KB
  • references/domain-guides/security-kms-encryption/references/06-security-risk-compliance/README.md1.3 KB
  • references/domain-guides/security-kms-encryption/references/07-waf-ddos-cfw/README.md2.8 KB
  • references/domain-guides/security-kms-encryption/references/08-security-center-bastion-workload/README.md1.9 KB
  • references/domain-guides/security-kms-encryption/references/09-playbooks/README.md2.2 KB
  • references/domain-guides/security-kms-encryption/references/api-coverage-matrix.md42.6 KB
  • references/domain-guides/security-kms-encryption/references/python-sdk-script-patterns.md1.4 KB
  • references/domain-guides/security-kms-encryption/references/query-cli-catalog.md1.9 KB
  • references/domain-guides/storage-database/README.md9.0 KB
  • references/domain-guides/storage-database/references/01-overview-routing/README.md949 B
  • references/domain-guides/storage-database/references/02-tos-object-access/README.md1.7 KB
  • references/domain-guides/storage-database/references/03-tos-signature-s3/README.md727 B
  • references/domain-guides/storage-database/references/04-file-storage/README.md862 B
  • references/domain-guides/storage-database/references/05-block-storage-volume/README.md844 B
  • references/domain-guides/storage-database/references/06-backup-restore/README.md645 B
  • references/domain-guides/storage-database/references/07-database-connectivity-permission/README.md1.4 KB
  • references/domain-guides/storage-database/references/08-database-performance-availability/README.md965 B
  • references/domain-guides/storage-database/references/09-playbooks/README.md621 B
  • references/domain-guides/storage-database/references/api-coverage-matrix.md60.7 KB
  • references/domain-guides/storage-database/references/python-sdk-script-patterns.md539 B
  • references/domain-guides/storage-database/references/query-cli-catalog.md1.5 KB
  • references/getting-started.md7.7 KB
  • references/openapi-quick-check.md4.5 KB
  • scripts/common_check.sh2.3 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

VolcEngine Troubleshooting

本 skill 面向用户本地环境使用,目标是在不修改云上资源的前提下,帮助定位 VolcEngine 产品、OpenAPI、Python SDK、ve/tosutil CLI 和控制台操作失败的原因。主入口只保留必要的启动规则、场景路由和安全边界;本地工具检查与完整领域索引放在 references/getting-started.md,OpenAPI 报错、签名、鉴权、参数、限流以及 ve/tosutil/Python SDK 调用链路的快速检查放在 references/openapi-quick-check.md,具体产品域手册放在 references/domain-guides/。

先把 SKILL_ROOT 解析为包含本 SKILL.md 的绝对目录。所有脚本和 reference 都从 ${SKILL_ROOT} 解析,不依赖仓库布局或当前工作目录。

开始前

  1. 先读取 references/getting-started.md,确认本地工具、环境变量、场景依赖和领域路由。

  2. 如用户允许执行本地体检,运行通用检查:

    bash "${SKILL_ROOT}/scripts/common_check.sh"
    
  3. 优先用 ve sts GetCallerIdentity 验证当前身份链路,只报告是否可用和必要的身份摘要,不输出 SecretKey、SessionToken、完整 AccessKeyId、完整手机号、账单明细或对象内容。

  4. 不要运行 ve configure、登录/SSO 初始化、安装依赖、写入配置文件或修改云资源,除非用户明确要求并确认影响。

  5. 若不确定归属,按 references/getting-started.md 中的“场景路由”定位领域;遇到 OpenAPI 报错、签名/鉴权失败、参数校验、限流、服务端错误,或由 ve/tosutil/Python SDK 暴露出的 OpenAPI 调用失败,先读 references/openapi-quick-check.md 收敛 RequestId、Action、Region、错误码和最小复现上下文。

  6. 根据下方路由打开对应 references/domain-guides/<domain>/README.md,再按领域手册的“先读这些”读取 query-cli-catalog.md、章节 README、api-coverage-matrix.md 和脚本 README。

场景路由

先从用户报错中提取 RequestId、ErrorCode、Action、Service、Region、资源 ID、发生时间和调用方式。如果缺失,先问最少必要问题。

领域判断优先读 references/getting-started.md。确定领域后,再进入对应 references/domain-guides/<domain>/README.md:

  • openapi-sdk-cli:OpenAPI、ve CLI、Python SDK、签名、API 网关。
  • account-permission:账号、AK/SK、STS、IAM、角色、权限不足。
  • billing-quota:账单、余额、欠费、订单、配额、资源包。
  • compute-container-network:ECS、VKE、CLB/ALB、VPC、NAT、EIP、路由、安全组。
  • storage-database:TOS、EBS、文件存储、云备份、RDS、Redis、数据库连接。
  • domain-cdn-ingress:DNS、域名、证书、CDN/DCDN、入口回源。
  • communication-media:SMS、RTC、VOD、Live、CV/OCR、veImageX。
  • llm-ecosystem:Ark、豆包、VikingDB、AgentKit、ArkClaw、Coze、机器学习平台。
  • security-kms-encryption:KMS、Secret、云加密机、WAF、DDoS、Cloud Firewall、安全中心。

仍无法分类时,完成 scripts/common_check.sh 后,按报错中的服务名查 ve SERVICE --help 和 ve SERVICE ACTION --help。

非阻塞反馈

已有证据显示 skill 指引有误、CLI 行为异常、缺少所需能力,或用户目标仍未完全解决时,先继续已授权的排障、恢复和主任务。在自然总结点,可以简短邀请用户分享这次真实场景;清楚区分已确认的问题与尚未验证的原因。反馈不替代故障处理,也不是继续任务或结束排障的前置条件。

  • 同一对话的主动邀请最多一次,跨 skill 路由也共用此限制;用户拒绝或忽略后不再提醒。用可忽略的陈述句附上入口,不停下来等待答复。
  • 邀请只使用已有上下文,不为此安装工具或 skill、登录、搜索 issue、额外采集日志,或重试云操作来复现错误。主任务仍可继续时直接继续。
  • 用户主动提出反馈时,使用已可用的 volcengine-feedback 整理实际目标、观察结果和期望。若该 skill 未安装或无法在当前对话加载,直接提供 反馈表单,也可在当前对话整理脱敏草稿;不要要求为反馈安装、登录或重启主对话。公开发布前的内容确认和脱敏由反馈流程处理。

例如:“如需反馈本次发现的能力缺口,可通过 反馈表单 说明使用场景和改进建议;反馈是可选的,不影响当前任务继续。”

核心原则

  • 只读优先:默认只执行 Describe/List/Get/Query/Lookup/Check 类命令。Create/Update/Delete/Attach/Detach/Put/Set/Start/Stop/Run/Invoke/Pay/Renew/Refresh/Preload 等写操作必须先解释影响并等待用户确认。
  • CLI 优先,SDK 辅助:只支持 ve 和 tosutil 两类 CLI。只有分页聚合、跨资源拓扑、日志归并或 CLI 未覆盖时,才建议 volc-sdk-python 或 volcengine-python-sdk 脚本。
  • 凭证安全:只从环境变量读取 AK/SK/Token;不要要求用户把凭证写入文件;不要打印 SecretKey、SessionToken 或完整 AccessKeyId;展示 AK 时至少遮蔽中间部分。
  • 最小上下文:每次排障只收集当前问题所需的服务、地域、资源和时间窗口。不要批量枚举无关账号资源。
  • 解释判据:每个检查都说明为什么查、期望看到什么、异常意味着什么,以及下一步该收集哪一项证据。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Query and answer questions about Volcengine API specifications. Use when the user asks about API parameters, error codes, request methods, enum values, required fields, response structures, pagination, parameter dependencies, service capability lists, API availability, or API comparisons, even if they do not explicitly say "API". Typical intent includes checking what an action supports, which fields are required, what values a parameter accepts, why an API returns a specific error, how to pass nested or body parameters, how pagination works, what an API response contains, whether a batch operation exists, what services or versions expose an operation, or how two APIs differ. Use API Explorer data as the authoritative source and preserve constraints, examples, and caveats found in the spec. Answer in Chinese or English. When the user needs runnable SDK code, language-specific examples, or SDK configuration, hand off to volcengine-sdk-generator. When they need CLI operations, hand off to volcengine-cli.

日本語の概要は準備中です。原文の説明を表示しています。

volcengine/volcengine-skills212026年9月23日 更新

Create and manage Volcengine cloud resources using the Volcengine CLI (`ve` command). Supports all Volcengine services including ECS, VPC, CLB, RDS, Redis, and more. Trigger this skill whenever the user asks to create, query, modify, or delete cloud resources on Volcengine, mentions the `ve` command, says "volcengine CLI", or describes infrastructure tasks such as "create an ECS instance", "set up a VPC", "list security groups", "allocate an EIP". Also trigger on Chinese prompts mentioning "火山引擎" or "火山" (e.g., "火山引擎上有哪些 ECS"、"查一下我火山的云服务器"、 "火山引擎创建一个 VPC"、"火山的 Redis 实例列一下"). Also trigger when the user encounters errors from `ve` commands and needs troubleshooting help. Also use for TOS bucket/object operations, tosutil (sometimes written tosutils), Ark CLI / arkcli model discovery, inference, generation, endpoints, fine-tuning, plans, or usage, and TLS (日志服务) / volclog log search, analysis, ingest, export, or LogCollector collection, through `ve tosutil`, `ve arkcli` and `ve volclog`.

日本語の概要は準備中です。原文の説明を表示しています。

volcengine/volcengine-skills212026年9月23日 更新

Use when the user asks to query Volcengine CloudTrail audit logs, investigate login or resource operations, or manage CloudTrail trails and backfill delivery tasks. Trigger on 操作审计, 审计日志, CloudTrail, cloud_trail, trail, 跟踪, 历史补投, or backfill in a Volcengine context. Audit queries are read-only; trail and backfill mutations require an explicit preview and confirmation.

日本語の概要は準備中です。原文の説明を表示しています。

volcengine/volcengine-skills212026年9月23日 更新

火山引擎合规最佳实践助手:一是根据用户诉求(要满足的合规标准、关键词、关注的风险等级), 从火山引擎官方内置的合规包模板里推荐该开启哪些、并标出哪些已开启;二是汇总账号当前的合规 态势,把已生效规则/合规包(官方内置 + 用户自定义)的评估结果按类别(法规 / 最佳实践 / 自定义)与严重度聚合成一份合规总览报告;三是当官方基线没覆盖时,指导用户写一条 Rego 策略 作为自定义合规规则并注册评估。可在用户确认后把推荐的模板部署为合规包。Use when 用户想做「合规检查 / 合规巡检 / 安全合规 / 合规最佳实践 / 该开哪些合规规则 / 等保合规 / 我火山账号合规吗 / 有哪些不合规 / 帮我写条自定义合规规则」,或提到火山引擎「配置审计 / Config / 合规包 / conformance pack / Rego 策略」。Trigger on 火山 / 火山引擎 / volcengine 关键词叠加合规场景。部署合规包 / 注册自定义规则属写操作,需用户确认;合规报告 与资源修复严格分离。

日本語の概要は準備中です。原文の説明を表示しています。

volcengine/volcengine-skills212026年9月23日 更新

Manage Volcengine's AI-native BaaS platform (Supabase edition / AIDAP / 火山引擎 AI 原生 BaaS 平台 Supabase 版) — a Volcengine-operated distribution that differs from official Supabase. Use when the user asks to create, inspect, or manage Volcengine Supabase or AIDAP resources — workspaces, branches, computes, SQL queries, schema changes, Auth, Realtime, Edge Functions, Storage buckets, frontend static-site hosting (Pages), API keys, connection info, or TypeScript type generation — or when a Volcengine deployment selects AIDAP as its database provider. Also trigger on Chinese prompts mentioning "火山引擎 Supabase" or "火山 Supabase". Operations run through the byted-supabase-cli command-line tool (installed via `npm i -g @byted-supabase/cli`; this is NOT the official `supabase` CLI). Do NOT use it for general database discussions, non-Supabase services (RDS MySQL, Redis), or pure client-side coding unrelated to Supabase backend management.

日本語の概要は準備中です。原文の説明を表示しています。

volcengine/volcengine-skills212026年9月23日 更新

Deploy a local project directory or Git repository to Volcengine as a running, reachable cloud service. USE WHEN: deploy to Volcengine, deploy to 火山引擎/火山, deploy this repo/project, publish current code, launch the app, run it in the cloud, expose it as a service, deploy to ECS/VKE/veFaaS, run on ECS, push to VKE, deploy as serverless/FaaS, or the user wants the agent to choose a Volcengine hosting target. If the user only asks which Volcengine deployment target to choose, use `volcengine-prepare` skill first. Not for creating a single standalone resource — use `volcengine-cli` skill for that.

日本語の概要は準備中です。原文の説明を表示しています。

volcengine/volcengine-skills212026年9月23日 更新

volcengine のスキルをすべて見る

このスキルの問題を報告する