google-cloud-filestore-autoscale-google-skills

1. 基本信息

项目	内容
名称	google-cloud-filestore-autoscale-google-skills
作者/维护者	Google（google/skills 官方仓库）
来源链接	https://github.com/google/skills/tree/main/skills/cloud/google-cloud-filestore-autoscale
许可证	Apache-2.0（数据来自 GitHub API）
GitHub Stars	19,099（数据来自 GitHub API；为 google/skills 整个合集仓库的星数，不代表本技能自身热度）
Forks	1,542（数据来自 GitHub API，同为合集仓库整体数字）
最新版本	未发布正式版本号（仓库未使用 Git tag/Release，滚动更新，最近一次提交 2026-08-11）
安装方式	`npx skills add google/skills`，安装时从清单中勾选本技能

2. 功能介绍与亮点

Google Cloud Filestore Autoscale 教会 agent 巡检、评估并调整 Google Cloud Filestore（GCP 的托管 NFS 文件存储服务）实例容量。核心能力包括：

容量巡检：跨项目列出 Filestore 实例，读取 5 分钟平均已用容量（file.googleapis.com/nfs/server/used_bytes），计算剩余空间百分比。
五档判定矩阵：把每个实例归入“需要扩容 / 需要缩容 / 健康 / 已在容量下限 / 该档位不支持缩容”五种状态之一，判定逻辑覆盖 Basic（仅支持扩容不支持缩容）、Zonal/Regional（支持缩容但有下限）等不同层级的差异化规则。
执行前强制确认：任何扩缩容操作在真正执行前，必须向用户展示目标容量与预计效果并等待明确确认，防止意外的账单波动或容量耗尽。
MCP 优先、CLI 兜底：优先使用 Filestore MCP 工具读取数据，MCP 不可用时自动切换到 gcloud filestore 命令行，两条路径都能完整工作。

主要亮点：Google 官方出品、Apache-2.0 完全开源、正文自带完整的容量层级与限额表（references/instance-tiers-specs.md），并把“只读概念问答不触发工具调用”这类边界情况也写进了指令，减少误操作。

3. 适用场景

固定分类：DevOps 与基础设施。

适用于管理 Google Cloud 基础设施的团队与个人开发者，尤其是：

需要防止 Filestore 实例因空间耗尽导致业务中断的运维人员；
希望通过自动缩容控制云存储成本、但不想手工核对各层级容量下限的团队；
在多项目、多实例的 GCP 环境中，需要一份可重复执行的巡检+扩缩容流程的场景。

4. 跨 Agent 兼容性

Claude Code：原生支持——标准 Agent Skills 格式（YAML front matter + Markdown 指令），可直接安装进 .claude/skills/。
Codex CLI：原生支持——技能主体依赖 gcloud CLI 对接用户已授权的 GCP 账号，与该仓库同批已验证的 GKE 系列技能同一机制；Codex 默认沙箱下需要用户按常规方式为 gcloud 授予网络访问（cloud CLI 场景下的标准配置动作，不构成额外适配）。
OpenClaw：原生支持——同上，纯 gcloud/官方 MCP 工具对接已认证的 GCP 环境，不涉及技能自身写死的第三方公网请求。
Hermes Agent：未验证——未查到该平台对 Agent Skills 格式或 Google Cloud MCP 工具的公开兼容性说明。

5. 推荐理由

这是 Google 官方为 Filestore（GCP 托管文件存储）提供的容量管理技能，把“读容量指标 → 按层级规则判断该不该扩缩容 → 生成命令 → 等确认再执行”这套原本需要人工逐条核对文档的流程直接封装成可复用指令。相比让 agent 临场现编 gcloud 命令，它内置了 Basic/Zonal/Regional 三种层级各自的容量下限与缩容限制，避免生成一条实际会执行失败或超出限额的命令；执行前强制确认的设计也降低了“agent 自主改动生产存储容量”的风险，适合直接交给团队在生产环境中使用。

6. 评分

维度	分数	说明
受欢迎程度	7	Google 为该技术的官方所有者，属第一方出品；技能自身仅 1 次提交（2026-08-11），未查到独立第三方讨论或采用数据
可用性	8	步骤清晰（启用 API → 巡检 → 按矩阵判定 → 确认执行），文档含完整层级限额参考表；仓库整体持续维护（最近推送 2026-08-31），但技能子目录自身只有单次提交，成熟度有限
安全性	9	Google 官方出品、Apache-2.0 完全开源可审计；无凭据存储（复用用户已有的 gcloud 认证）；扩缩容类“破坏性”操作前强制要求用户逐条确认，未发现可疑指令或数据外发

安全检查清单：

检查项	结果
① Shell 命令与权限范围	执行 `gcloud filestore` 命令，权限范围明确限定在 Filestore 实例的读取与扩缩容操作
② 运行时联网外发	仅通过官方 GCP API / MCP 工具与用户自己的 Google Cloud 项目通信，无第三方外发
③ API Key/凭据	复用用户本机已有的 `gcloud` 认证会话，技能本身不索取、不存储任何凭据
④ 可疑指令	未发现 prompt injection 或与任务无关的夹带指令
⑤ 作者/组织信誉	Google 官方仓库，信誉可查证
⑥ License	Apache-2.0，明确
⑦ 最近维护	仓库整体近日活跃（2026-08-31 有推送），技能子目录 2026-08-11 创建后未见后续修订

综合评分：8.0（(7+8+9)/3）

7. 跟同类 Skills 相比的优势

技能	定位	与本技能的差异
Google Cloud Storage Basics	GCS 对象存储（bucket/object）的基础操作指南	服务对象是 Cloud Storage 对象存储，而非 Filestore 文件存储；不含容量自动扩缩容的判定逻辑
GKE Storage	GKE 集群内 Persistent Volume 的存储配置	面向 Kubernetes 集群内的块/文件卷挂载与配置，不涉及独立 Filestore 实例的容量运维
Azure Storage	Azure 存储账号（Blob/File/Queue 等）的管理指南	服务平台不同（Azure 而非 GCP），且覆盖多种存储类型的通用配置，未针对某一服务做扩缩容判定

本技能的差异化在于：只聚焦 Filestore 这一单一 GCP 服务，把该服务特有的层级容量规则（如 Basic 不能缩容）写死进判定逻辑，并加入强制确认这道安全闸，而不是提供泛化的存储操作说明。

8. 用户评价

该技能目前在第三方平台（GitHub Issues/PR、Reddit、Hacker News）尚无具名用户评价；仓库本身发布不足一个月，社区讨论尚未形成。

9. 其他补充

Google 已在 Google Cloud Next 2026 官方宣布 google/skills 仓库，作为面向 Antigravity、Gemini CLI 及第三方 agent 的官方技能库；配套发布了《Behind the scenes: How we build, test, and scale Google Agent Skills》一文说明其构建与测试流程。

10. 安装使用方式

安装：npx skills add google/skills，在交互式清单中勾选 google-cloud-filestore-autoscale；也可手动下载 SKILL.md 与 references/ 目录放入对应 agent 的技能目录。
使用前确保本机已安装并登录 gcloud（gcloud auth login），并对目标项目启用 file.googleapis.com 与 monitoring.googleapis.com 两个 API。
触发：向 agent 描述“检查 Filestore 容量”或“是否需要扩缩容”等意图即可自动加载本技能；扩缩容命令生成后需用户明确回复确认才会执行。

11. 注意事项

技能子目录自身只有 1 次提交，尚处早期版本，建议在非生产环境先验证判定矩阵的边界情况（如恰好在容量下限附近的实例）。
Basic 层级实例不支持缩容，遇到该场景技能会建议数据迁移而非强行操作，不代表技能功能缺失。
未获取到该技能自身的独立版本号，如需追踪变更需直接关注仓库 commit 历史。