1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | agent-platform-prompt-management-google-skills（SKILL.md 自述名称：“Agent Platform Prompt Management”） | GitHub 仓库 + SKILL.md |
| 作者/维护者 | Google（官方 google/skills 仓库，Cloud IX 团队具名提交维护） |
GitHub API |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/agent-platform-prompt-management | — |
| 许可证 | Apache License 2.0 | GitHub API 实测 |
| GitHub Stars / Forks | 所属仓库 15,239 / 1,192（整仓库口径——google/skills 是 Google 官方发布的多技能合集，非本技能独立仓库，星数不代表单个技能自身热度） |
GitHub API 实测 |
| 最新版本 | 子目录 2026-05-27 新增，2026-06-03 因 SDK 变化更新，2026-06-17 补充安全确认分级机制，2026-06-24 最近一次结构调整 | GitHub commits API 实测 |
| 安装方式 | npx skills add google/skills 后从列表勾选 agent-platform-prompt-management，或克隆仓库手动复制子目录到对应 agent 的 skills 目录 |
官方 README 实测 |
2. 功能介绍与亮点
该技能让 Agent 能生成并执行管理 Google Cloud「Agent Platform」（原 Vertex AI，现称 Gemini Enterprise Agent Platform）托管提示词的 Python 代码，把提示词当作可版本化、可追踪的云端资源来运营：
- 生命周期全覆盖：创建、列出、按版本检索、组装变量、删除托管提示词均给出可直接执行的 SDK 代码片段
- 分级安全确认：只读操作免确认直接执行；创建类操作要求交互式“Yes/No”确认且须列出模型、模板文本等关键参数；删除类操作要求用户在新对话轮次里手动敲出“I confirm”等文字，且明令禁止“边确认边执行”，专防误创建或永久误删生产提示词
- 环境准备说明完整：Phase 0 章节写明 gcloud 认证、虚拟环境、SDK 安装的具体命令
- 持续跟随 SDK 演进：2026-06 有一次专为“匹配最新 SDK”所做的更新
3. 适用场景
所属分类：元技能与 Agent 增强
适合已在 Google Cloud Agent Platform 上构建或运维生产级 AI Agent、需要把提示词升级为可版本管理云端资源的开发团队：多人协作维护同一批提示词模板、需要按版本回滚或对比、或需要在删除生产提示词前有一道不可绕过的二次确认。
4. 跨 Agent 兼容性
google/skills 仓库通过 npx skills 通用安装器（vercel-labs/skills）分发；该安装器 README 的 Supported Agents 表格逐一列出各 agent 的安装路径：
| Agent | 项目路径 | 全局路径 |
|---|---|---|
| Claude Code | .claude/skills/ |
~/.claude/skills/ |
| Codex | .agents/skills/ |
~/.codex/skills/ |
| OpenClaw | skills/ |
~/.openclaw/skills/ |
| Hermes Agent | .hermes/skills/ |
~/.hermes/skills/ |
四个生态均由安装器原生支持，技能本身是纯 Markdown 指令 + Python 代码片段，不依赖任何特定 Agent 的专有能力，跨平台一致可用。
5. 推荐理由
在 Google Cloud Agent Platform 上运营提示词最容易踩的两个坑——误操作覆盖生产模板、误删还在使用的提示词——该技能用强制性分级确认协议在流程层面堵死，而非依赖使用者自觉小心；同时把认证、环境搭建、SDK 调用范式一次性讲清楚，省去来回查文档的成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Google 官方仓库出品，所属「Gemini Enterprise Agent Platform」产品有官方 Google Cloud Blog 专文发布与 Wikipedia 词条；该具体子技能自身在第三方渠道尚未见独立讨论 |
| 可用性 | 8 | 步骤清晰、文档与代码示例完整，2026-06 内有因 SDK 变化专门更新的记录，维护活跃；但需要 Google Cloud 项目、gcloud 认证与独立虚拟环境等前置配置 |
| 安全性 | 9 | 见下方检查清单 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 仅执行标准 gcloud auth、pip install 等透明环境准备命令，其余为用户在自己环境中运行的 Python 代码，无越权范围扩张 |
| ② 运行时联网外发 | 仅调用用户自行认证的 Google Cloud 官方 API 端点，未见向第三方地址外发数据 |
| ③ API Key/凭据存储 | 依赖 gcloud Application Default Credentials（ADC），是 Google Cloud 标准认证机制，存储方式明确可查 |
| ④ 可疑指令/注入迹象 | 未发现提示注入或隐蔽指令；相反内置三层（只读/可逆变更/不可逆删除）强制确认协议，明确禁止“确认与执行同轮完成” |
| ⑤ 作者/组织信誉 | Google 官方仓库，Cloud IX 团队具名维护 |
| ⑥ License 明确性 | Apache License 2.0，GitHub API 确认 |
| ⑦ 最近维护时间 | 最近一次实质性更新 2026-06-24（结构调整），2026-06-17 有功能性增强，均在近 3 个月内 |
7. 跟同类 Skills 相比的优势
提示词的版本管理与生命周期治理是 LLM 应用领域的通用需求，市面上已有多款独立的第三方平台专门做这件事：
| 产品/项目 | 定位 | 与本技能的差异 |
|---|---|---|
| LangSmith Prompt Hub | LangChain 生态官方提示词版本库，附带 Playground 与从调用轨迹直接打开调试的能力 | 定位为通用多模型平台，深度绑定 LangChain/LangGraph 生态；本技能则原生绑定 Google Cloud Agent Platform 自身模型与项目体系，无需额外框架 |
| Langfuse Prompt Management | 开源自托管的提示词版本管理，MIT 协议，支持组合式提示词 | 需要自行部署与运维 Langfuse 服务；本技能直接调用 Google 托管 API，无自建基础设施负担，但也因此被锁定在 Google Cloud 内 |
| PromptLayer | 商业化“提示词 CMS”，强调协作版本控制、发布标签与可控上线流程 | 面向多云多模型的团队协作场景，发布标签机制更成熟；本技能的差异化在于把删除等破坏性操作的确认协议写进了 Agent 执行规则本身，而不只是平台 UI 层面的权限控制 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
无。
10. 安装使用方式
- 通用安装器：
npx skills add google/skills，安装过程中从技能列表勾选agent-platform-prompt-management - 手动安装：克隆
google/skills仓库后，将skills/cloud/agent-platform-prompt-management目录复制到对应 Agent 的 skills 目录（见第 4 章路径表） - 使用前准备：需先执行
gcloud auth login与gcloud auth application-default login完成 Google Cloud 认证，建议创建独立虚拟环境后pip install google-cloud-aiplatform google-genai - 触发方式：无需重启 Agent；在对话中提出创建/查询/删除托管提示词等相关需求即可自动触发
11. 注意事项
- 使用前提是已有可用的 Google Cloud 项目并开通 Agent Platform（原 Vertex AI）相关 API，存在云端资源与调用费用
- 技能明确锁定在 Google Cloud Agent Platform 内的托管提示词资源，不适用于管理该平台之外的提示词或用于模型训练、部署等其他场景
- 删除操作为不可逆操作，技能已内置强制二次确认，但用户仍需自行确认目标提示词 ID 无误后再输入确认文字