Runpod usage 是一个概念性技能,用于在动手前理解 Runpod 的工作方式与正确选择。它本身不运行任何操作;明确做法后,可用 runpod-mcp/runpodctl 执行基础设施操作,用 flash 运行自己的代码,或用 companion-clis 处理模型、镜像与数据。该技能强调概念解释、演示则由 golden paths 提供;当问题是“如何做 X”而非“X 如何运作”时,应参考已验证的端到端示例 runpod/golden-paths/README.md。
它按问题提供参考文件:首次设置与认证(RUNPOD_API_KEY、SSH、配套凭据)见 reference/getting-started.md;Pod 与无服务器、worker、冷启动、FlashBoot、队列与负载均衡见 reference/concepts.md;任意工作负载的开发循环见 reference/development-loop.md(规划→优先预构建→配置→验证→拆除);在 Pod 上搭建与迭代见 reference/pod-workflows.md;部署与迭代无服务器端点见 reference/endpoint-workflows.md;Pod 上安装软件见 reference/on-pod-setup.md;构建 Runpod 可运行的 Docker 镜像见 reference/docker.md;镜像构建要点见 reference/building-images.md;数据存放(容器磁盘与网络卷、模型缓存、S3)见 reference/storage.md;GPU/显存/CUDA/成本与可用性见 reference/gpu-selection.md;停止的 Pod 可能无法用 GPU 重启的原因见 reference/pods-and-machines.md;端点发布与滚动更新见 reference/endpoint-builds-and-releases.md;密钥管理见 reference/secrets.md;HTTP 访问见 reference/networking.md;常见错误见 reference/gotchas.md。
精确事实可读同目录 concepts/ 下的 YAML,每个概念一个文件(如 pod.yaml、network-volume.yaml、machine.yaml),含字段、状态、关系与规则,规则均引用公开来源。可用 grep -il "volume disk" concepts/*.yaml 按名称或别名查找概念,用 grep -n "statement:" concepts/pod-volume-disk.yaml 查看规则;rules[].statement 是事实,see: 指向其它概念的相关规则;conflict: true 表示两个公开来源不一致,应给出两种解读;kind: process 文件逐步说明流程,如 pod-deployment.yaml 覆盖部署、停止与重启,包括数据中心有库存时重启仍可能失败的原因。