1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | agent-platform-endpoint-management-google-skills |
| 作者/维护者 | Google（google/skills 官方仓库） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/agent-platform-endpoint-management |
| 许可证 | Apache-2.0（GitHub API 获取，适用于整个仓库） |
| GitHub Stars | 19,013（GitHub API 获取；该数字属整个 google/skills 合集仓库，不代表本技能自身热度） |
| Forks | 1,533（GitHub API 获取，同为合集整体数据） |
| 最新版本 | 无独立版本号；技能目录最近一次提交于 2026-07-31（GitHub API 获取） |
| 安装方式 | npx skills add google/skills 后勾选对应技能，或手动复制 skills/cloud/agent-platform-endpoint-management 目录 |
2. 功能介绍与亮点
这是一个专注于 Google Cloud Agent Platform（Vertex AI）**服务端点（Serving Endpoint）**全生命周期管理的技能——端点是模型上线前必须先创建的稳定服务地址，创建、更新、删除、流量切分等操作均围绕它展开。核心能力包括：
- 三级安全确认体系：把所有操作按风险分为只读（列出/查看，无需确认）、可变更但可逆（创建/更新，需交互式确认且必须展示完整命令行）、破坏性不可逆（删除，需用户输入“I confirm”等明确文字）三档，逐档规定不同的确认动作与“禁止在同一轮对话内执行”的强约束。
- 完整的端点 CRUD 指令集：覆盖列出、查看详情、创建、更新、删除、流量切分六类操作，每条都配具体的
gcloud ai endpoints命令与参数说明，并强制要求指定--region（禁止用global）。 - 故障排查清单：针对 403 权限拒绝、配额超限、资源忙碌（模型未完全下线导致删除失败）三类常见报错给出直接的排查方向。
- 与同仓库其他技能的职责边界清晰：正文明确“部署模型到端点”应转去
agent-platform-deploy技能，避免功能重叠。
3. 适用场景
所属分类：DevOps 与基础设施
适用于在 Google Cloud Agent Platform（Vertex AI）上管理模型服务端点的平台工程师与 MLOps 团队：从查询现有端点、创建新端点、更新端点配置，到安全地下线并删除端点，均可按技能给出的分级确认流程执行，避免误删或误更新生产端点。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 ✅ | SKILL.md 遵循 Agent Skills 规范（YAML frontmatter + Markdown 正文），该规范由 Claude Code 率先定义并读取 |
| Codex | 原生支持 ✅ | Codex CLI 读取同一 SKILL.md 目录结构，属公开标准的通用兼容对象 |
| OpenClaw | 原生支持 ✅ | OpenClaw 采用相同的 AgentSkills SKILL.md 规范（name/description frontmatter），结构可直接迁移 |
| Hermes Agent | 原生支持 ✅ | 遵循 agentskills.io 开放标准，跨兼容框架可移植 |
⚠️ 三级确认体系里“同一轮对话内不得执行确认后的命令”这条约束依赖宿主 Agent 支持多轮交互确认；纯自动化/无人值守场景下需自行调整该约束的落地方式。
5. 推荐理由
它把“端点管理”这个模型上线前必经、却容易因为一次误操作（比如误删还挂着流量的端点）造成生产事故的环节，拆成了按风险分级的确认流程：只读操作直接执行，创建/更新必须先亮出完整命令等确认，删除必须用户手动打字确认——这套三级体系比笼统的“操作前请确认”更可执行，也更适合被审计。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 由 Google 官方发布（第一方，google/skills 是 Agent Platform/Vertex AI 所属厂商自建仓库）；本技能自身在第三方平台尚无独立评价或可查的采用数据，合集仓库整体 19,013 星属于整个仓库，不代表本技能自身热度 |
| 可用性 | 9 | 正文含完整的六类端点操作指令、三级安全确认体系与故障排查清单，逻辑闭环；最近一次提交为 2026-07-31，所属仓库持续活跃维护；无付费依赖（Google Cloud 本身按量计费，非技能自身要求） |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 仅限 gcloud ai endpoints 系列命令操作用户自己的 Google Cloud 项目资源，且按风险分级要求不同程度的用户确认 |
| ② 运行时联网外发 | 仅访问 Google Cloud Agent Platform 官方 API，外联目标透明 |
| ③ 凭据处理 | 依赖 gcloud auth application-default login 生成的应用默认凭据，不落盘存储额外密钥 |
| ④ 可疑指令 | 未发现 prompt injection 或夹带无关推广内容 |
| ⑤ 作者信誉 | Google 官方仓库，无造假迹象 |
| ⑥ License | Apache-2.0，明确 |
| ⑦ 最近维护 | 2026-07-31，一个月内，活跃 |
综合评分：8.33（三项均值）
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| vertex-ai-endpoint-config（第三方，claude-code-plugins-plus-skills 合集） | 面向 Vertex AI 端点配置的自动激活技能，侧重按最佳实践生成配置、校验常见错配 | 侧重“配置生成与校验”，未提供本技能这套按风险分级（只读/可逆变更/不可逆删除）的强制交互确认机制，误操作防护弱于本技能 |
| Vertex AI Agent Builder（第三方，mcpmarket.com） | 面向创建企业级 AI Agent 的脚手架技能，覆盖模型选型、工具接口设计、RAG 落地、监控与成本护栏 | 定位是“从零搭建 Agent”的更上层脚手架，端点只是其众多环节之一，不提供端点自身的完整 CRUD 操作细节 |
| agent-platform-deploy（同仓库官方技能） | 负责把模型部署/下线到已存在的端点上 | 与本技能职责互补：本技能负责端点本身的创建与删除，agent-platform-deploy 负责往端点上部署模型，两者在正文中互相明确引用对方边界，不重叠 |
8. 用户评价
该技能所在的 google/skills 仓库尚处活跃开发阶段，目前在 GitHub Issues、Reddit、Hacker News 等平台尚无具名第三方用户对该技能本身的评价。
9. 其他补充
无。
10. 安装使用方式
方式一（推荐）：
npx skills add google/skills运行后在交互列表中勾选 “Agent Platform Endpoint Management”（即 agent-platform-endpoint-management）。
方式二（手动）：
git clone https://github.com/google/skills.git
cp -r skills/skills/cloud/agent-platform-endpoint-management ~/.claude/skills/安装后注意事项：
- 需已安装并登录
gcloudCLI（gcloud auth application-default login），并已启用 Vertex AI（Agent Platform）API。 - 创建/更新类操作会要求你在确认提示中核对完整命令行；删除操作会要求手动输入确认文字，不接受语气模糊的“是”。
- 删除端点前需确保该端点上所有模型均已下线，否则会因“资源忙碌”报错。
11. 注意事项
- 技能专注于端点资源本身的生命周期管理，不负责模型部署（见
agent-platform-deploy）或模型评估。 - 正文给出的确认交互约束（如“不得在同一轮回复内既提示确认又执行命令”）依赖宿主 Agent 支持多轮等待用户输入，纯自动化流水线场景需自行改造该约束的实现方式。
- 流量切分（Traffic Splitting）章节仅给出概念说明，未提供具体命令，需配合
agent-platform-deploy的部署流程完成实际操作。