1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | cloud-logging-query-generation-google-skills（SKILL.md 自述名称：“Generate Logging Query Language queries”） | GitHub 仓库 + SKILL.md |
| 作者/维护者 | Google（官方 google/skills 仓库，Cloud IX 团队维护） |
GitHub API（组织账号 google） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/cloud-logging-query-generation | — |
| 许可证 | Apache-2.0 | GitHub API 实测 |
| GitHub Stars / Forks | 所属仓库 15,344 / 1,201（整仓库口径——本技能所在的 google/skills 是 Google 官方发布的多技能合集，非本技能独立仓库，星数不代表单个技能热度） |
GitHub API 实测（2026-07-30） |
| 最新版本 | 无独立版本号；子目录最近一次实质更新 2026-07-29 | GitHub commits API 实测 |
| 安装方式 | npx skills add google/skills，交互式选择该技能或指定 --skill cloud-logging-query-generation |
官方 README 实测 |
2. 功能介绍与亮点
cloud-logging-query-generation 是 Google 官方 Agent Skills 仓库中专门教 Agent 生成正确 Cloud Logging 查询语句（Logging Query Language，LQL）的技能，把原本分散在 Google Cloud 各服务文档里的日志查询语法整理成一套可直接调用的参考体系：
- 19 个 Google Cloud 服务的专属查询参考：App Engine、BigQuery、Cloud Functions、Cloud Run、GKE、IAM、网络（VPC/负载均衡）、审计日志（Security）等每个服务各配一篇独立参考文档，累计 21 篇、约 93KB 内容，涵盖各自的
resource.type取值与常见字段 - 明确的语法纠错规则：例如提醒不要把
gce_instance的实例名当实例 ID 比较、审计日志查询要用SEARCH()而非精确匹配以避免版本前缀不匹配 - 严格的输出格式约束：只输出裸 LQL 文本、不加对话性文字；缺失变量时用占位符而非阻塞式追问用户，同时明确规定哪些占位符可以省略以避免“因为写了占位符反而导致漏检日志”这种反直觉错误
- 未知字段的兜底策略：查不到匹配 schema 时改用全局
SEARCH()并强制在查询中加注释说明原因，不让 Agent 凭空猜测字段名
3. 适用场景
所属分类：DevOps 与基础设施
适合在 Google Cloud 上运维多个服务、需要频繁按自然语言描述（如“过去一小时 Cloud Run 里的 5xx 错误”）快速拼出正确 Logging 查询语句排查问题的 SRE、DevOps 工程师与后端开发者，尤其适合不熟悉 LQL 语法细节、容易在 resource.type 或字段名上写错的用户。
4. 跨 Agent 兼容性
google/skills 统一通过 npx skills add 分发器安装，该分发器（vercel-labs/skills）README 的 Supported Agents 表格逐一列出各生态的确切安装路径：
| 生态 | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 支持 | 分发器表格列出 .claude/skills/ 项目路径与 ~/.claude/skills/ 全局路径 |
| Codex | ✅ 支持 | 分发器表格以 codex 标识列出 .agents/skills/ 与 ~/.codex/skills/ |
| OpenClaw | ✅ 支持 | 分发器表格列出 skills/ 项目路径与 ~/.openclaw/skills/ 全局路径 |
| Hermes Agent | ✅ 支持 | 分发器表格列出 .hermes/skills/ 项目与全局路径 |
5. 推荐理由
Google 官方出品，把 19 个 Google Cloud 服务分散的日志查询语法整理成结构化参考体系，让 Agent 能根据自然语言描述直接写出语法正确的 LQL 查询，且技能本身零依赖、零配置——不需要额外的 MCP 工具或凭据，装上即可用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Google 官方出品，但该子技能本身仅 3 次提交且均由内部同步账号（Cloud IX Team）产生，未查到独立第三方讨论或评价；仓库整体星数不计入个体子技能评分 |
| 可用性 | 9 | 无需任何 MCP 工具、外部 API Key 或付费依赖，纯参考文档形态；21 篇参考文件覆盖 19 个 Google Cloud 服务，内容详尽（GKE 参考文档单篇即 24KB）；最近一次实质更新为 2026-07-29，维护活跃 |
| 安全性 | 9 | 纯文本/参考类技能，不执行 shell 命令、不产生任何网络外发，只生成供用户自行使用的查询语句建议；官方组织出品，Apache-2.0 完全开源可审计 |
综合评分（三项均值）：8.3
安全检查清单： ① Shell 命令：技能不涉及任何 shell 命令执行，仅指导生成 LQL 查询文本 → 不扣分 ② 联网外发：技能本身不发起任何网络请求，纯静态参考文档驱动的文本生成 → 不扣分 ③ 凭据：不涉及凭据存储；用户后续在 Cloud Logging 中执行生成的查询时使用自己的标准 GCP 权限，这是使用该功能本身的通用前提，非技能独有依赖 → 不扣分 ④ 可疑指令：正文与全部参考文档均为技术性语法说明，未发现隐蔽指令或混淆代码 → 不扣分 ⑤ 作者信誉：Google 官方组织账号，Cloud IX 团队具名维护，无造假迹象 → 不扣分 ⑥ License：Apache-2.0，明确 → 不扣分 ⑦ 维护时间：子目录最近实质提交 2026-07-29，远在 3 个月窗口内 → 不扣分
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与 cloud-logging-query-generation 的差异 |
|---|---|---|
| elasticsearch-esql（Elastic 官方） | 教 Agent 生成 ES|QL（Elasticsearch 管道式查询语言）查询，面向已用 Elastic Stack 做日志/搜索的团队 | 覆盖平台不同：elasticsearch-esql 服务于 Elastic Stack 生态，本技能专注 Google Cloud 19 个服务的 Logging 体系；本技能额外内置逐服务的字段/资源类型对照表，覆盖面更细分到具体云服务 |
| victoriametrics-skills（VictoriaMetrics 官方） | 面向 VictoriaMetrics 时序数据库的 PromQL 风格指标查询与运维 | 查询对象不同：victoriametrics-skills 处理的是时序指标（metrics），本技能处理的是结构化日志条目（logs）；两者是可观测性体系里互补而非竞争的两块 |
| cloud-logging-configuration-basics（Google 官方，同仓库） | 教如何配置 Cloud Logging 基础设施本身——日志桶、日志接收器（sink）、日志视图与 IAM 权限 | 分工不同：cloud-logging-configuration-basics 解决“如何搭建/管理日志系统”，本技能解决“如何查询已有日志数据”，官方将两者拆成独立技能，一个面向运维配置、一个面向日常排查 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。其所属的 google/skills 仓库于 2026 年 Google Cloud Next 大会上作为官方 Agent Skills 项目正式发布，持续保持近乎每日的更新节奏，cloud-logging-query-generation 是仓库内近期仍在补充内容的子技能之一，最近一次更新（补充基础日志 schema 信息）发生在 2026 年 7 月 29 日。
9. 其他补充
技能内容以英文撰写，暂无多语言版本；作为 google/skills 仓库的一部分，遵循该仓库统一的 Apache-2.0 协议与贡献流程，社区贡献需通过该仓库的 Pull Request 提交。
10. 安装使用方式
- 通用安装：
npx skills add google/skills，在交互列表中勾选 “Generate Logging Query Language queries”，或直接执行npx skills add google/skills --skill cloud-logging-query-generation指定安装 - 安装后：技能文件落地为
<agent 目录>/skills/cloud-logging-query-generation/，内含SKILL.md与references/下 21 篇分服务参考文档；Agent 会依据 SKILL.md 头部 description 中的触发条件（涉及查询 Cloud Logging 日志数据或调试问题）自动匹配加载，无需重启或额外配置 - 前置条件：仅需一个已启用 Cloud Logging 的 Google Cloud 项目（GCP 项目默认启用），生成的查询语句需在 Cloud Logging 控制台的 Logs Explorer、Logging API 或
gcloud logging read命令行中自行执行
11. 注意事项
- 技能只负责生成查询语句本身，不会自动连接 GCP 项目或执行查询，用户需自行把生成的 LQL 复制到 Logs Explorer 或 Logging API 中运行
- 对于 README 服务参考列表之外的 Google Cloud 服务，技能会退化为“按通用知识生成”，准确度可能低于列表内已覆盖的 19 个服务
- 内容以英文撰写，中文用户需自行理解正文与参考文档
- 该子技能与仓库内其他部分共享同一批内部提交历史，暂无该子技能层面的独立版本发布记录