1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | semgrep-trailofbits-skills |
| 作者/维护者 | Trail of Bits(官方) |
| 来源链接 | https://github.com/trailofbits/skills/tree/main/plugins/static-analysis/skills/semgrep |
| 许可证 | CC-BY-SA-4.0 |
| GitHub Stars / Forks | 7,948 / 686(所属仓库整体数字,不代表本技能自身热度;GitHub API,2026-11-04 读取) |
| 最新版本 | 无版本标签;仓库主分支最近一次提交 2026-11-03 |
| 安装方式 | 把技能目录复制进 agent 的 skills 目录;另需本机安装 Semgrep CLI |
数据来源:上述数字取自 GitHub API;功能与评分依据来自技能正文与官方文档。
2. 功能介绍与亮点
一句话:把「跑一遍 Semgrep」做成有审批、有规则清单、有失败登记的安全扫描流程,并且默认关掉遥测。
- 先报计划、再动手:识别语言、列出规则集与扫描范围,必须等用户明确同意才开扫——原始那句「扫一下这个仓库」不算同意。
- 规则集不止官方库:Trail of Bits、0xdea、Decurity 的规则会被纳入,官方注册表覆盖不到的问题类型靠它们补。
- 遥测默认关闭:所有命令强制
--metrics=off,--config auto也不联网,避免审计过程中把代码信息带出去。 - 失败要登记:
scans.json记录哪些规则集没跑成、哪些被跳过;把局部扫描说成完整扫描比不扫更糟。 - Pro 能力先探测:有 Semgrep Pro 就启用跨文件污点分析,没有就明说,不假装覆盖了跨文件路径。
- 两种模式:「全部规则」求覆盖,「仅重要」求高置信度、中高影响。
3. 适用场景
所属分类:安全与合规。
- 合并前给仓库做一次静态安全扫描的安全团队;
- 代码评审前想先跑一遍已知漏洞模式的开发者;
- 需要可复核的扫描记录(跑了哪些规则、哪些没跑成)的合规场景;
- 已有 Semgrep Pro、想把它接进 agent 工作流的团队。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能目录安装,按描述触发 |
| Codex | 需适配 | 技能正文通用,脚本调用与目录约定需按平台调整 |
| OpenClaw | 需适配 | 需要平台支持技能目录并允许执行本地命令 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
Semgrep 的好用和危险在同一个地方:它很便宜,于是很容易随手跑一遍、看到一堆结果、然后既不知道漏了什么也不知道规则从哪来。这个技能把审批、规则来源、遥测关闭和失败登记都做成了流程的一部分,让一次扫描的结果可以被复核,而不是「一堆 JSON」。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Trail of Bits 官方出品;所属仓库 7,948 stars 是整个合集热度,不代表本技能自身热度 |
| 可用性 | 8 | 文档完整、脚本把命令生成都包了;前置是装好 Semgrep CLI |
| 安全性 | 9 | 见下方清单;官方开源,且主动关闭遥测、不把代码带出本机 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 通过本地 semgrep 与脚本扫描,作用域限于目标代码库 |
| ② 联网外发 | 明确强制 --metrics=off;规则集克隆是唯一的联网动作,目标透明 |
| ③ 凭据 | 不需要 API key;Pro 能力取决于用户自己的许可 |
| ④ 可疑指令 | 未见注入或夹带推广 |
| ⑤ 作者信誉 | Trail of Bits 是公开的安全研究机构,仓库提交历史完整 |
| ⑥ License | CC-BY-SA-4.0,全文可查(注意 share-alike) |
| ⑦ 维护时间 | 2026-11-03 仍在更新 |
扣分点:需要安装并配置 Semgrep;规则集多时扫描耗时较长;结果仍需人工判断误报。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| semgrep-rule-creator-trailofbits-skills | 编写自定义 Semgrep 规则 | 管「写规则」;本技能管「跑规则集扫描并登记结果」 |
| codeql-trailofbits-skills | CodeQL 跨函数污点分析 | 更重、更深的跨文件分析;Semgrep 更快、更适合第一遍 |
| static-analysis-trailofbits-skills | 静态分析工具选型入口 | 负责选工具;本技能是把 Semgrep 这条路径跑完整 |
核心差异:同类要么写规则、要么选工具、要么上更重的引擎,它把「快速扫一遍且结果可复核」做成了闭环。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价(2026-11-04)。
9. 其他补充
- 技能自带
scripts/run-scans.sh,命令由脚本生成,减少手写命令时漏掉参数的可能。 - 属于
trailofbits/skills合集(近百个技能),可按需只装这一条。
10. 安装使用方式
git clone https://github.com/trailofbits/skills
mkdir -p ~/.claude/skills
cp -r skills/plugins/static-analysis/skills/semgrep ~/.claude/skills/
# 另需安装 Semgrep CLI(官方文档)
装好后说「给这个仓库跑一次安全扫描,只要中高置信度的问题」,它会先报规则计划、等你确认再开扫。
11. 注意事项
- 需要本机安装 Semgrep;没有 Pro 许可就没有跨文件污点分析。
- 首次扫描会克隆第三方规则集,需要网络。
- 结果有误报,报告里的「没跑成」清单同样要读。
- CC-BY-SA-4.0:再分发或改写要保留署名并以相同许可共享。