1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | cloud-armor-crs-rule-upgrader-google-skills |
| 作者/维护者 | Google(官方) |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/cloud-armor-crs-rule-upgrader |
| 许可证 | Apache-2.0 |
| GitHub Stars / Forks | 21,805 / 1,861(所属仓库整体数字,不代表本技能自身热度;GitHub API,2026-11-11 读取) |
| 最新版本 | 技能内标注 1.0.1;仓库主分支最近一次提交 2026-11-06 |
| 安装方式 | 把技能目录复制进 agent 的 skills 目录;命令经 gcloud 执行 |
数据来源:上述数字取自 GitHub API;功能与评分依据来自技能正文与官方文档。
2. 功能介绍与亮点
一句话:把 Cloud Armor 的 OWASP 规则从 CRS 3.0/3.3 升到 4.22——保留白名单、换算表达式、重映射签名 ID,并先算清这次升级会断什么。
- 保续用名单:升级时保留原有的签名 opt-in / opt-out 列表,不会把豁免弄丢。
- 表达式换算:把
evaluatePreconfiguredExpr翻成原生的evaluatePreconfiguredWaf字典参数。 - 签名重映射:ID 统一到
v042200,已退役的签名被剔除。 - 风险分级:High Breaking Change / Medium / Low 三档,明确 PUT/PATCH/DELETE 可能被拦这类破坏性变化。
- 灰度路径:支持原地升级与 preview 模式,留优先级间距与 200 条规则配额护栏。
- 边界清楚:限流、地域封禁、reCAPTCHA 与非 WAF 规则不在范围内。
3. 适用场景
所属分类:安全与合规。
- 还在跑 CRS 3.0/3.3、需要升到 4.22 的安全团队;
- 升级前想先评估「会不会把正常请求拦掉」的平台工程师;
- 规则数接近 200 条上限、需要预留间距的运维;
- 要把升级做成可回滚灰度发布的 SRE。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能目录安装,按描述触发 |
| Codex | 需适配 | 技能正文通用,gcloud 调用需按平台调整 |
| OpenClaw | 需适配 | 需要平台支持技能目录并允许执行本地命令 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
WAF 规则升级最怕「升完才发现正常流量被拦」:签名 ID 变了、表达式写法变了、白名单丢了,而这些都是上线后才暴露。这个技能把风险分级、preview 模式与配额护栏写进流程,让升级可以先灰度再切——对跑公网业务的团队,这比照着 changelog 手改可靠得多。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Google 官方出品;所属仓库 21,805 stars 是整个合集热度,不代表本技能自身热度 |
| 可用性 | 8 | 升级映射、风险分级与灰度步骤都写清楚了;前置是 gcloud 与 Cloud Armor 策略 |
| 安全性 | 9 | 见下方清单;官方开源,操作范围限于用户自己的策略 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 通过 gcloud 读取与更新自有安全策略,先 preview 再落地 |
| ② 联网外发 | 只与 Google Cloud 端点通信 |
| ③ 凭据 | 使用既有 gcloud 凭据,不要求写进对话 |
| ④ 可疑指令 | 未见注入或夹带推广 |
| ⑤ 作者信誉 | Google 官方仓库,Apache-2.0 |
| ⑥ License | Apache-2.0,全文可查 |
| ⑦ 维护时间 | 2026-11-06 仍在更新 |
扣分点:只覆盖 WAF 规则升级;预览结果仍需对照真实流量核对。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| cloud-operator-google-skills | GCP 综合助手 | 泛用;本技能专攻一次规则版本升级 |
| api-gateway-backend-security-and-rate-limiting-google-skills | 网关后端封锁与限流 | 管限流;本技能管 WAF 规则迁移 |
| semgrep-trailofbits-skills | 代码级静态扫描 | 看代码;本技能看线上 WAF 策略 |
核心差异:同类是泛用助手或代码扫描,它是「一次具体迁移」的可执行手册。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价(2026-11-11)。
9. 其他补充
- 技能内标注 1.0.1,随官方仓库更新。
- 属于
google/skills合集(180 个技能),可按需只装这一条。
10. 安装使用方式
git clone https://github.com/google/skills
mkdir -p ~/.claude/skills
cp -r skills/skills/cloud/cloud-armor-crs-rule-upgrader ~/.claude/skills/
装好后说「把这些 Cloud Armor 策略从 CRS 3.3 升到 4.22,先给我风险评估和 preview 步骤」。
11. 注意事项
- 升级前先跑 preview,用真实流量比对再切。
- 注意 PUT/PATCH/DELETE 的方法拦截变化,可能影响写接口。
- 规则数接近 200 条时要预留间距。
- 非 WAF 规则(限流、地域封禁、reCAPTCHA)不适用。