Agent Platform 模型注册表管理
用 gcloud 管理 Agent Platform 中的模型、版本及其元数据。
技能明确区分只读、可逆变更和破坏性删除，并要求对上传、更新和删除进行分级确认，删除还要求输入式确认；这支持用户控制和外部效果透明度。扣分原因是初始化要求直接执行 gcloud 登录和项目切换，未说明最小权限、凭据处理、数据流、依赖来源或回滚方案；删除前禁止预检与后文“必须先解除部署”存在安全流程张力。
命令路径、区域参数和主要模型注册操作有清晰示例，且覆盖列出、描述、上传、更新和删除。静态证据未包含测试、CI、版本兼容性、异常输入处理或可诊断错误反馈；环境变量、认证失败、权限不足、长时间上传和无效模型 ID 的处理未说明，因此限制在静态条件下的中低分。
元数据清楚界定适用范围为 Agent Platform Model Registry 的模型及版本管理，并明确排除训练、端点部署和非 Agent Platform 模型。扣分原因是未定义输入要求、输出格式、触发词边界、地区或权限限制，也未提供中文支持或中国大陆网络可达性说明；核心依赖 Google Cloud 服务，环境适配证据有限。
文档结构按安全、环境设置和操作流程组织，命令示例完整，仓库 README 提供安装方式、技能索引、Apache-2.0 许可证、问题反馈和贡献入口，且声明持续开发。扣分原因是选定技能没有版本、变更记录、维护责任人、依赖版本、FAQ、故障排查或已知限制；README 的治理信息主要是仓库级而非技能级。
技能覆盖模型注册表的核心管理动作，示例命令原则上可直接作为操作起点，并说明了模型版本和区域参数。扣分原因是未提供成功输出示例、结果验证步骤、上传参数选择指导、权限前置条件或失败后的恢复路径；删除、版本上传和元数据更新仍需要用户自行补充关键决策，因此静态评估不超过 7 分。
源文件提供了可审计的命令、操作范围和安全规则，README 与 LICENSE 可核验仓库安装、许可证和维护入口。扣分原因是没有提交测试套件、CI 覆盖、第三方执行证据、版本变更记录或多来源交叉验证；结论仅基于静态文档，无法确认命令在当前修订中实际可运行。
- 执行前应确认 Google Cloud 凭据、项目、区域和所需 IAM 权限，并避免在不必要时扩大权限范围。
- 删除流程应先验证部署状态和可恢复性；当前文档同时要求删除前不得预检且要求模型已解除部署，存在操作风险。
- 技能未说明凭据、模型制品或元数据的敏感信息处理方式，也未提供失败恢复和结果验证步骤。
这个 Skill 能做什么，适合哪些场景？
该技能用于管理 Agent Platform Model Registry 中的机器学习模型及模型版本。它涵盖模型和版本的列出、详情查看、新模型或新版本上传、元数据更新以及模型删除。只适用于 Agent Platform Model Registry，不用于模型训练、端点部署或非 Agent Platform 模型管理。执行操作前需要完成 Google Cloud 身份认证、ADC 配置和项目设置。
通过 gcloud ai models list 列出注册表中的模型并获取数字 ID；通过 gcloud ai models describe 查看模型或指定版本的元数据；通过 gcloud ai models upload 上传新模型或现有模型的新版本；通过 gcloud ai models update 更新显示名称、描述和标签等元数据；通过 gcloud ai models delete 删除模型及其所有版本。列出、查看和获取操作无需确认；上传和更新需要包含完整命令的交互式确认；删除需要明确的文字确认。
- Google Cloud 用户需要发现 Agent Platform Model Registry 中已有模型及其数字 ID 时。
- 机器学习工程师需要查看某个模型或特定版本的完整元数据时。
- 团队需要将自定义模型及其工件注册到 Agent Platform Model Registry 时。
- 模型维护者需要更新模型显示名称、描述或标签时。
- 管理员确认模型已不再需要并准备删除模型及其版本时。
这个 Skill 有哪些优点和局限？
- 覆盖模型注册表的完整基础生命周期操作，包括列出、查看、上传、更新和删除。
- 明确区分只读、可逆变更和破坏性操作的确认等级。
- 提供模型版本查看和新版本上传的命令示例。
- 依赖 Google Cloud CLI、Google Cloud 认证和已设置的项目与区域。
- 删除操作不可逆，并且模型的所有版本必须先从所有端点取消部署。
- 源材料未提供测试套件、错误处理说明或故障排查流程。
- 不覆盖模型训练、端点部署或非 Agent Platform 模型。
如何安装这个 Skill？
运行 npx skills add google/skills，并在安装选择过程中选择 Agent Platform Model Registry Management。README 未说明具体安装目录。
如何使用这个 Skill？
先运行 gcloud auth login、gcloud auth application-default login，并运行 gcloud config set project $PROJECT_ID 设置项目。随后始终为命令指定 --region=$LOCATION_ID；例如提出“列出 Agent Platform Model Registry 中的模型”，对应命令为 gcloud ai models list --region=$LOCATION_ID。上传、更新或删除前，必须先完成相应确认流程。