从检测到自动修复:gemini-cli-security的security-patcher技能一键修复漏洞全流程详解
从检测到自动修复:gemini-cli-security的security-patcher技能一键修复漏洞全流程详解
gemini-cli-security 是 Google 开源的 Gemini CLI 安全扩展:/security:analyze 命令负责扫描代码改动中的漏洞,而 security-patcher 技能则把"检测之后"的工作全部自动化——生成 PoC 验证、一键应用补丁、回归测试。本文带你完整拆解这条从检测到修复的流水线。
它是什么?为什么需要 security-patcher 🛠️
gemini-cli-security 为 Gemini CLI 注入安全能力,核心特点:
- AI 驱动的安全分析:基于 Gemini 的上下文感知分析,聚焦 PR / 分支代码改动,漏洞早发现早修复
- 检测覆盖面广:SQL 注入、XSS、命令注入、SSRF、硬编码密钥、弱加密算法、敏感信息日志泄漏、LLM 提示注入等
- 官方基准验证:在真实 CVE 数据集上达到 90% 精确率、93% 召回率
- 开源:Apache 2.0 许可
但安全报告只回答"哪里有问题",人工修复依旧费时、容易踩坑。security-patcher 技能补上了这"最后一公里":检测到漏洞后,一键完成修复与验证。
快速上手:安装扩展与运行首次扫描
要求 Gemini CLI v0.4.0 及以上版本,在终端执行安装命令(仓库地址见本页顶部):
gemini extensions install <项目仓库地址>
安装后,进入你的项目目录,运行安全扫描:
/security:analyze
默认分析当前分支相对 origin/HEAD 的改动,也可以直接用自然语言自定义范围,或用 --json 输出结构化报告:
💡 顺带一提:/security:scan-deps 命令可借助 OSV-Scanner 扫描依赖项的已知漏洞。
扫描结束后,扩展会询问你想对哪些漏洞采取行动:生成 PoC 或 直接打补丁。选择"打补丁"后,security-patcher 技能即刻接管——整个过程你只需一句话,例如"帮我修复 VULN-001"。
security-patcher 一键修复漏洞的 7 步流程 🔍
技能定义在 skills/security-patcher/SKILL.md,它被设计为用户请求修复漏洞时的第一个动作。完整流程如下:
第 1 步:前置检查——报告与测试基线
- 检查
.gemini_security/目录是否已有安全报告;若没有,先触发一次security:analyze扫描构建上下文 - 运行仓库现有测试套件(
npm test、pytest、go test ./...等)建立健康基线,证明动手改代码之前环境是正常的
第 2 步:收集补丁上下文
调用 security_patch_context MCP 工具(源码见 mcp-server/src/tools/security_patch_context.ts),一次性聚合四类信息:
| 上下文 | 说明 |
|---|---|
| 知识库修复规则 | 对应漏洞类型的 Remediation 文档,由 mcp-server/src/knowledge.ts#L24-L36 按类型加载 |
| 目标文件内容 | 待修复文件的完整源码 |
| PoC 文件 | 已有的漏洞验证脚本路径 |
| 漏洞上下文 | 漏洞描述与所在行号 |
例如路径穿越类漏洞会命中 mcp-server/src/knowledge/path_traversal.md,内含"脆弱 vs 安全"的对照代码模式。
第 3 步:分析并生成补丁
将知识库中的安全编码模式应用到目标文件,形成修复方案,输出完整的修复后文件或补丁,供你审查——技能不会擅自改动代码。
第 4 步:确认验证意图
通过 ask_user 询问是否要先验证补丁(Yes/No)。选择"否"可直接跳到应用补丁。
第 5 步:打补丁前,先证明漏洞真实存在 🧪
若不存在 PoC,走 security:setup_poc 流程自动生成一个;然后在应用补丁之前执行 run_poc 工具,确认漏洞可复现。这一步保证你修的是"真 bug"而不是误报。
第 6 步:应用补丁
将生成的补丁写入目标漏洞文件。
第 7 步:打补丁后,再次回归验证
- 重新运行 PoC,确认漏洞已失效
- 运行现有测试文件,确保补丁没有破坏文件的主功能
修复前验证 + 修复后回归的双向验证,是这个技能最核心的设计。
背后的配角:PoC 技能与 MCP 工具
一键修复并非 solo 作战,它调度了一整套技能与工具:
| 组件 | 路径 | 职责 |
|---|---|---|
| poc 技能 | skills/poc/SKILL.md | 搭建 PoC 工作区,生成并执行漏洞验证脚本 |
| dependency-manager 技能 | skills/dependency-manager/SKILL.md | 为 PoC 沙箱隔离安装依赖,避开全局锁定 |
security_patch_context |
mcp-server/src/tools/security_patch_context.ts | 聚合知识库规则与文件内容 |
poc_context |
mcp-server/src/tools/poc_context.ts | 按项目语言创建 .gemini_security/poc/ 目录,生成 poc_<类型>_<时间戳>.<扩展名> |
run_poc |
mcp-server/src/tools/run_poc.ts | 执行 PoC 并返回 stdout/stderr,拦截越界行为 |
| 知识库 | mcp-server/src/knowledge/path_traversal.md | 路径穿越的修复策略与安全编码模式 |
所有中间产物(报告、TODO、PoC)都统一放在工作区的 .gemini_security/ 目录下,不会污染你的代码库。
触发方式与上手建议 ✅
触发方式:/security:analyze 的收尾交互会询问选择哪些漏洞(按 ID)以及"生成 PoC"还是"直接打补丁",选择后技能即被编排执行;你也可以在对话中直接说"修复 VULN-001",技能定义要求它必须作为第一个动作被调用。相关编排逻辑见 commands/security/analyze.toml#L77-L86。
几条让修复更稳的建议:
- 先建立测试基线:没有绿底测试,"修好后没跑挂"就没有说服力
- 审查补丁再应用:补丁基于知识库的安全编码模式生成,通读一遍再确认
- 善用白名单:对不认同的结论写入
.gemini_security/vuln_allowlist.txt,后续扫描自动跳过 - 保持清醒:安全报告是"首轮分析"而非完整审计,关键系统请结合人工复核
总结
gemini-cli-security 把安全闭环做成了两步:/security:analyze 负责检测,security-patcher 技能负责一键修复——从报告生成、PoC 双向验证到补丁落地与回归测试,7 个步骤全自动编排。对新手来说,只需记住一句话:先扫描、再修复,让 PoC 替你把关。

