1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | dwarf-expert-trailofbits-skills |
| 作者/维护者 | Trail of Bits(官方) |
| 来源链接 | https://github.com/trailofbits/skills/tree/main/plugins/dwarf-expert/skills/dwarf-expert |
| 许可证 | CC-BY-SA-4.0 |
| GitHub Stars / Forks | 7,948 / 686(所属仓库整体数字,不代表本技能自身热度;GitHub API,2026-11-06 读取) |
| 最新版本 | 无版本标签;仓库主分支最近一次提交 2026-11-03 |
| 安装方式 | 把技能目录复制进 agent 的 skills 目录;另需 dwarfdump / llvm-dwarfdump 或 readelf |
数据来源:上述数字取自 GitHub API;功能与评分依据来自技能正文与官方文档。
2. 功能介绍与亮点
一句话:把 DWARF 调试信息讲清楚——怎么读、怎么验、怎么写代码去解析它,并给出权威来源而不是凭记忆。
- 先分清工具:
dwarfdump有 libdwarf 与 LLVM 两套实现、选项不同,技能要求先看--version再决定命令。 - 解析与检索:DIE 树、
DW_TAG_/DW_AT_条目、.debug_*段,按需查而不是背。 - 完整性校验:用
llvm-dwarfdump --verify判断调试信息是否被裁坏。 - 写解析器:libdwarf、pyelftools、gimli 三条路线的用法要点。
- 来源优先:精度要求高时去查 dwarfstd.org 规范与 LLVM 参考实现,不靠模型记忆。
- 边界清楚:运行时调试交给 gdb/lldb,反编译交给 Ghidra/IDA。
3. 适用场景
所属分类:工程效率与代码质量。
- 发布产物 crash 了、需要从调试信息里还原符号与行号的工程师;
- 怀疑构建把调试信息裁坏、要做完整性校验的团队;
- 正在写 DWARF 解析器或符号化工具(libdwarf/pyelftools/gimli)的开发者;
- 需要准确回答 DWARF 规范问题、而不是凭印象的人。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能目录安装,按描述触发 |
| Codex | 需适配 | 技能正文通用,工具与命令需按平台调整 |
| OpenClaw | 需适配 | 需要平台支持技能目录并允许执行本地命令 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
DWARF 的坑很具体:同一个 dwarfdump 可能是两套实现、不同选项;调试信息被裁掉时不会报错,只会在崩溃现场变成问号。这份技能把「先确认工具、再解析、最后验证」的顺序写死,并指明规范与参考实现的位置——对做符号化与崩溃分析的人来说,这比泛泛的调试建议实用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Trail of Bits 官方出品;所属仓库 7,948 stars 是整个合集热度,不代表本技能自身热度 |
| 可用性 | 8 | 命令、工具差异与解析库用法都写清楚了;前置是手上有二进制与 dwarfdump |
| 安全性 | 9 | 见下方清单;只读分析本地二进制,不联网外发 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 调用 dwarfdump/readelf 读取调试信息,作用域限于目标文件 |
| ② 联网外发 | 仅在需要查规范时访问 dwarfstd.org 等公开文档,不上传二进制 |
| ③ 凭据 | 不需要任何 key |
| ④ 可疑指令 | 未见注入或夹带推广 |
| ⑤ 作者信誉 | Trail of Bits 是公开的安全研究机构,仓库提交历史完整 |
| ⑥ License | CC-BY-SA-4.0,全文可查(注意 share-alike) |
| ⑦ 维护时间 | 2026-11-03 仍在更新 |
扣分点:需要本地工具链;不同编译器的 DWARF 生成差异仍需实测确认。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| burpsuite-project-parser-trailofbits-skills | 解析 Burp 项目文件 | 面向 Web 抓包数据;本技能面向编译产物里的调试信息 |
| codeql-trailofbits-skills | 源码级污点分析 | 需要源码;本技能处理已编译的二进制 |
| differential-review-trailofbits-skills | 审查一次改动 | 面向 diff;本技能面向符号与行号还原 |
核心差异:同类要么看源码、要么看抓包,它专门处理「没有源码时怎么把符号和行号找回来」。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价(2026-11-06)。
9. 其他补充
- 技能标注 effort 为 medium,允许读文件、执行命令与联网查文档。
- 属于
trailofbits/skills合集(近百个技能),可按需只装这一条。
10. 安装使用方式
git clone https://github.com/trailofbits/skills
mkdir -p ~/.claude/skills
cp -r skills/plugins/dwarf-expert/skills/dwarf-expert ~/.claude/skills/
装好后说「这个 core dump 里的栈都是问号,帮我看调试信息是不是被裁了」,它会先验证再解析。
11. 注意事项
- 需要
dwarfdump/llvm-dwarfdump或readelf,先确认是哪一套实现。 - 不负责运行时调试与反编译,那属于 gdb/lldb 或 Ghidra/IDA。
- 编译器差异会影响 DWARF 质量,结论需结合具体工具链。
- CC-BY-SA-4.0:再分发或改写要保留署名并以相同许可共享。