1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Variant Analysis |
| 作者/维护者 | Axel Mierczuk（Trail of Bits） |
| 来源链接 | https://github.com/trailofbits/skills/tree/main/plugins/variant-analysis |
| 许可证 | CC-BY-SA-4.0（数据来自 GitHub API，适用于整个 trailofbits/skills 仓库） |
| GitHub Stars | 7,074（数据来自 GitHub API；为合集仓库整体热度，不代表本技能个体热度） |
| Forks | 605（数据来自 GitHub API，合集仓库整体） |
| 最新版本 | 2.0.2（数据来自插件清单 plugin.json） |
| 安装方式 | Claude Code Marketplace 插件安装（见第 10 章） |
2. 功能介绍与亮点
Variant Analysis 解决的是安全审计中一个具体且高频的场景：已经找到一个漏洞，如何确认代码库里还有没有同根因的“兄弟漏洞”。它把这件事拆成五个步骤——提炼根因、写出只匹配已知实例的精确模式、逐要素泛化模式、对候选结果做真假阳性分诊、最后产出报告与防回归的 CI 规则。
核心亮点：
- 提供两种使用形态：一是可直接对话触发的技能本体（“这里还有类似的 bug 吗？“这类自然语言提问即可激活），二是
/variant-analysis:variants工作流命令，用并行子代理沿多个泛化方向（变量名、函数名、汇聚点 API 等）同时扫描，适合大代码库或根因表现形式多的场景。 - 内置五种语言的现成模板：
resources/codeql/与resources/semgrep/分别为 Python、JavaScript、Java、Go、C++ 预置了查询模板，省去从零编写规则的成本。 - 强调“泛化节奏”这一容易翻车的环节：正文专门列出五类失败模式（范围太窄、模式太窄、只追一种漏洞类型、只测 happy path、一次性泛化多个要素导致噪音无法归因），并配套分步骤的参考文档（root-cause.md / searching.md / triage.md / reporting.md）。
- 作为 Trail of Bits 官方技能市场自 2026 年 1 月首批发布的 16 个插件之一，2026-08-19 仍有针对性维护提交（统一命令的可运行性），持续活跃。
3. 适用场景
所属分类：安全与合规
面向已经在做代码安全审计、渗透测试或漏洞研究的用户——典型场景是在人工审计、CodeQL/Semgrep 初筛或第三方漏洞报告中发现一个具体问题后，需要系统性回答“这个模式在代码库别处还出现过吗”，而不是就手头这一处提交修复。也适用于把一次性发现沉淀为可复用的 CodeQL/Semgrep 规则、或对一批“看起来像”的候选做真假阳性分诊。不适合用于没有任何已知问题线索的初次代码审查——技能正文明确写明这种情况应改用专门的初始发现类技能。
4. 跨 Agent 兼容性
- Claude Code：原生支持。仓库即 Claude Code 插件市场标准结构，
/plugin marketplace add trailofbits/skills安装。 - Codex：原生支持。仓库 README 明确写明“Codex supports Claude plugin marketplaces directly”，并给出
codex plugin marketplace add专用安装命令，无需额外适配层。 - OpenClaw：未验证。仓库文档未提及该平台。
- Hermes Agent：未验证。仓库文档未提及该平台。
5. 推荐理由
它填补的是“发现一个漏洞之后怎么办”这个安全审计流程里容易被跳过的环节——大多数人找到一个问题就直接去修，很少系统性回头检查代码库里的其他实例。Variant Analysis 把这套方法论产品化：五步流程有明确的失败模式清单，避免生搬硬套；提供五种主流语言的现成规则模板，降低从“知道原理”到“能用起来”的门槛；且同时支持对话式驱动与并行工作流两种使用方式，小范围手动排查和大代码库自动化扫描都能覆盖。作为 Trail of Bits 官方技能市场的早期核心插件，机制经过近八个月的迭代打磨。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Trail of Bits 是公认的一线安全研究机构，长期为区块链、开源基础设施等承接第三方安全审计并公开发布审计报告，其发布的 Semgrep/YARA 规则集已是业界常用参考；未查到该子技能自身独立的第三方评价或采用数据 |
| 可用性 | 9 | 单条插件安装命令即可用；SKILL.md 正文 + 四份分步参考文档 + 五语言 CodeQL/Semgrep 模板齐全；仓库 2026-08-19 仍有针对本技能的维护提交；无任何付费依赖 |
| 安全性 | 9 | 技能本身只做本地静态模式匹配（ripgrep/Semgrep/CodeQL），不联网、不需要凭据；正文与脚本未见可疑指令；官方出品、完全开源可审计；License 明确 |
综合评分：8.33
安全检查清单逐项结果：① 执行范围明确的本地搜索命令（ripgrep/Semgrep/CodeQL 静态分析），无破坏性操作 ② 运行时不联网外发数据 ③ 不要求任何 API key 或凭据 ④ SKILL.md 与参考文档中未发现可疑指令或隐蔽外发迹象 ⑤ 作者为 Trail of Bits 官方，信誉良好 ⑥ License 明确（CC-BY-SA-4.0） ⑦ 最近一次维护提交为 2026-08-19，处于活跃维护状态。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与 Variant Analysis 的差异 |
|---|---|---|
| CodeQL（工具本身） | 通用的跨语言静态分析查询引擎 | 是底层工具而非流程方法论，不提供“如何从一个已知实例逐步泛化出完整模式家族”的分步指导，也不内置失败模式清单 |
| Semgrep（工具本身） | 轻量级模式匹配工具 | 同样是执行层工具，Variant Analysis 把它（连同 CodeQL、ripgrep）作为可选后端，核心价值在于选型策略与泛化方法，而非替代工具本身 |
| 通用代码审查类技能 | 面向“看一遍代码找问题”的宽泛审查 | 定位是初次发现，而 Variant Analysis 明确聚焦“已有一个确定根因，找它的其他实例”这一更窄、更后置的环节，两者互补而非替代 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。相关社区提交（如 awesome-claude-code 仓库对 Trail of Bits 安全技能合集的资源推荐 issue）由 Trail of Bits 官方账号自行提交，未见独立用户跟帖讨论。
9. 其他补充
技能提供两种入口：直接对话触发的技能本体，与 /variant-analysis:variants 并行工作流命令。据作者文档描述，在实测代码库中，Claude 更倾向于主动选用工作流入口；如需自己把控每一步泛化决策，需在对话中明确点名要求使用技能本体而非工作流。
10. 安装使用方式
Claude Code：
/plugin marketplace add trailofbits/skills
/plugin install trailofbits/skills/plugins/variant-analysis安装后无需重启，直接在对话中描述“这里还有类似的漏洞吗”即可触发技能本体；如需并行工作流扫描大代码库，显式调用 /variant-analysis:variants。
Codex：
codex plugin marketplace add trailofbits/skills
codex plugin add variant-analysis@trailofbits11. 注意事项
- 技能要求手头已有一个明确的已知漏洞或坏模式作为起点，不适用于没有任何线索的初次代码审查。
- 深度依赖 CodeQL/Semgrep/ripgrep 等外部静态分析工具的可用性；若目标环境未安装 CodeQL 或 Semgrep，仅能退化为基于 ripgrep 的关键词/正则搜索，泛化精度会下降。
- OpenClaw、Hermes Agent 的兼容性未经验证，使用前建议先在小范围场景试用确认。