1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | writing-lean-proofs-trailofbits-skills |
| 作者/维护者 | Trail of Bits(官方) |
| 来源链接 | https://github.com/trailofbits/skills/tree/main/plugins/writing-lean-proofs/skills/writing-lean-proofs |
| 许可证 | CC-BY-SA-4.0 |
| GitHub Stars / Forks | 7,948 / 686(所属仓库整体数字,不代表本技能自身热度;GitHub API,2026-11-09 读取) |
| 最新版本 | 无版本标签;仓库主分支最近一次提交 2026-11-03 |
| 安装方式 | 把技能目录复制进 agent 的 skills 目录;另需 Lean 4 工具链与 Mathlib |
数据来源:上述数字取自 GitHub API;功能与评分依据来自技能正文与官方文档。
2. 功能介绍与亮点
一句话:按 Mathlib 的惯例写与审 Lean 4 证明——从定理结构到提取引理、补 sorry、配 linter,连证明变慢都有招。
- 工作流明确:先用「提取阶梯」把长
tactic证明拆成可复用的引理,再谈优化。 - 按 Mathlib 惯例:命名、结构、
instance写法都遵循社区规范,产出更容易被接受。 - 补洞:给出填
sorry的系统做法,而不是随手糊一个证明。 - 诊断慢证明:
maxHeartbeats超时、证明变慢时的定位与改法。 - 工程化:CI、linter、自定义 tactic 与宏的组织方式。
- 反套路清单:列出常见的自我合理化作法并要求拒绝。
3. 适用场景
所属分类:工程效率与代码质量。
- 要把数学或规格形式化到 Lean 4 的研究者与工程师;
- 维护 Lean 库、需要按 Mathlib 规范评审证明的维护者;
- 手上有一堆
sorry、需要系统性补齐的团队; - 证明编译超时、想定位
maxHeartbeats问题的开发者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能目录安装,按描述触发 |
| Codex | 需适配 | 技能正文通用,Lean 工具链需按平台配置 |
| OpenClaw | 需适配 | 需要平台支持技能目录并允许执行本地命令 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
Lean 证明的难点不是「能不能证出来」,而是「证出来之后别人能不能读、能不能复用、编译会不会超时」。这份技能按 Mathlib 的惯例给出结构与提取路径,把「能过」和「能维护」一起解决——对做形式化的团队,这比零散查文档省事。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Trail of Bits 官方出品;所属仓库 7,948 stars 是整个合集热度,不代表本技能自身热度 |
| 可用性 | 7 | 流程与反套路清单完整;前置是 Lean 4 与 Mathlib 环境,学习曲线陡 |
| 安全性 | 9 | 见下方清单;纯提示词与本地工具链,不联网外发 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 调用本地 lake/linter,作用域限于项目 |
| ② 联网外发 | 不联网(Mathlib 依赖下载由用户自行配置) |
| ③ 凭据 | 不需要任何 key |
| ④ 可疑指令 | 未见注入或夹带推广 |
| ⑤ 作者信誉 | Trail of Bits 是公开的安全研究机构 |
| ⑥ License | CC-BY-SA-4.0,全文可查(注意 share-alike) |
| ⑦ 维护时间 | 2026-11-03 仍在更新 |
扣分点:Lean 4 与 Mathlib 版本迭代快,示例可能需要按版本调整;受众很窄。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| differential-review-trailofbits-skills | 审查一次改动 | 面向普通代码 diff;本技能面向形式化证明 |
| codeql-trailofbits-skills | 源码污点分析 | 找漏洞;本技能证性质 |
| validate-bug-trailofbits-skills | 独立复核 bug 复现 | 面向安全研究流程;本技能面向数学形式化 |
核心差异:同类在找问题或在审代码,它在「把性质写成机器可检的证明」。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价(2026-11-09)。
9. 其他补充
- 属于
trailofbits/skills合集(近百个技能),可按需只装这一条。 - 内容提炼自 Mathlib 的社区实践,适合作为团队内部证明规范的起点。
10. 安装使用方式
git clone https://github.com/trailofbits/skills
mkdir -p ~/.claude/skills
cp -r skills/plugins/writing-lean-proofs/skills/writing-lean-proofs ~/.claude/skills/
装好后说「把这个定理的证明按 Mathlib 惯例重写,把长 tactic 拆成引理」,它会先给提取阶梯再动手。
11. 注意事项
- 需要 Lean 4 与 Mathlib;版本不匹配时先对齐
lean-toolchain。 - 它是写法与结构规范,不替你想证明思路。
sorry补齐后要跑 linter 确认没有遗留。- CC-BY-SA-4.0:再分发或改写要保留署名并以相同许可共享。