一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | sharp-edges（合集仓库子技能，完整标识见下） | 合集仓库子目录名 |
| 所属合集仓库 | trailofbits/skills（Trail of Bits Skills Marketplace，官方安全技能市场） | GitHub API |
| 作者/维护者 | Trail of Bits（plugin.json 声明，联系邮箱 opensource@trailofbits.com） | 插件 plugin.json |
| 来源链接 | https://github.com/trailofbits/skills/tree/main/plugins/sharp-edges | — |
| 许可证 | CC-BY-SA-4.0（署名-相同方式共享，仓库根目录确认） | GitHub API |
| 合集仓库整体 Stars/Forks | 6,407 / 553（注：该数字属整个合集仓库，不代表本技能自身热度，仅供了解所属市场规模） | GitHub API |
| 该技能自身活跃度 | 初始随仓库于 2026-01-14 发布；2026-04-29 新增配套 sharp-edges-analyzer 子代理（PR #81）；此后仅随仓库级批量提交（如统一元数据格式）涉及，无更晚的自身专属内容更新 | GitHub API（按路径过滤提交历史 + PR 记录） |
| 插件版本 | v1.1.1 | plugin.json |
| 安装方式 | Claude Code / Codex 插件市场一条命令安装（见第十章） | 官方 README |
二、功能介绍与亮点
sharp-edges 是一个 API / 配置“防呆”分析技能：识别那些容易被开发者误用、从而制造安全问题的接口设计、危险默认值与配置陷阱（footgun）。核心理念是“pit of success”——安全的用法应该是阻力最小的路径，而不是需要开发者仔细读文档才能避开的坑。
- 六大类易错模式：算法/模式选择型 footgun（如 JWT
alg: none）、危险默认值（如timeout=0语义歧义）、原始类型 vs 语义类型混淆、配置悬崖（一个开关全盘失守）、静默失败（校验函数返回布尔而非抛异常）、字符串化的安全值（权限用逗号拼接字符串表示） - 四阶段分析流程：识别安全相关的接口面 → 对每个选择点做零值/空值/负值/类型混淆探测 → 用“恶意者/懒惰开发者/困惑开发者”三种对手视角做威胁建模 → 复现误用场景并验证是否真的可被利用
- 配套 11 种语言专属参考文档（C/C++、Go、Rust、Swift、Java、Kotlin、C#、PHP、JavaScript、Python、Ruby）与加密 API、配置模式、鉴权模式、真实案例研究四份专题参考文档，内容详实、非占位文件
- 配有可独立调用的
sharp-edges-analyzer子代理，工具权限仅限只读的 Read/Grep/Glob
三、适用场景
固定分类：安全与合规
适合在设计新 API 或加固现有服务配置时，负责代码评审、安全设计评审的工程师与安全团队使用——尤其是评估加密库调用接口是否好用又不好误用、审计配置 schema 中是否存在会被意外触发的危险选项、或在鉴权/会话管理接口评审中确认“最容易走的那条路”是不是安全的那条路。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方安装方式即 Claude Code 插件市场机制（.claude-plugin/plugin.json + /plugin install），SKILL.md 遵循 Claude Agent Skills 标准格式 |
| Codex | 原生支持 | 仓库根 README 明确写明“Codex supports Claude plugin marketplaces directly”，并给出 codex plugin marketplace add 专用安装命令（已抓取原文验证） |
| OpenClaw | 未验证 | 已抓取材料未提及 OpenClaw 支持，未为此单独搜索 |
| Hermes Agent | 未验证 | 已抓取材料未提及 Hermes 支持 |
五、推荐理由
传统代码审查与静态扫描擅长抓“已经写错的代码”，但很难抓“接口设计得太容易被写错”这类问题——一个 timeout=0 到底是“立即过期”还是“永不过期”，往往要等到出事故才被发现。sharp-edges 把这种经验性的设计直觉，转成一套可复用、覆盖 11 种主流语言的系统化检查流程：六类易错模式加三种对手视角的威胁建模，帮团队在 API/配置定稿前就把“最容易走的路”钉死在安全的那一边。技能本身纯只读、无需任何外部依赖，复制即用。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 合集仓库整体热度不计入本技能个体分；安全媒体 Snyk 在其公开评测文章《Top 9 Claude Skills for Cybersecurity》中点名介绍本技能，并被 claudepluginhub、skillsovermcp 等多家第三方插件目录独立收录 |
| 可用性 | 8 | SKILL.md 结构清晰，配 15 份分语言/分主题参考文档与独立子代理，/plugin install 一条命令安装，无需 API Key 或付费依赖；本技能自身最近一次内容更新为 2026-04-29，距今约 3 个月，本子技能近期未见新内容改动 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | SKILL.md 声明 allowed-tools: Read Grep Glob，无 Bash、无写入权限，范围最小 |
| ② 运行时联网外发 | 纯本地文件读取分析，未发现任何网络请求或数据外发行为 |
| ③ API Key/凭据 | 不涉及，技能本身不接触任何凭据 |
| ④ 可疑指令排查 | 已完整抓取并阅读 SKILL.md 全文及子代理定义，未发现 prompt injection 或隐藏指令迹象 |
| ⑤ 作者/组织信誉 | Trail of Bits——知名安全研究与审计公司，plugin.json 具名声明官方作者与联系邮箱 |
| ⑥ License | CC-BY-SA-4.0，仓库根目录明确声明；提示：衍生分发需遵守“相同方式共享”条款 |
| ⑦ 最近维护 | 仓库整体高频维护（含今日提交）；本技能自身最近一次专属内容更新为 2026-04-29 |
未给可用性满分的原因：属纯提示词/只读分析类技能、无代码执行，文档与参考资料齐全，但作为合集子技能，其自身内容更新节奏慢于仓库整体的持续提交频率。
七、跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本 skill 的差异 |
|---|---|---|
| insecure-defaults（同市场） | 检测代码里已经写死的不安全默认值、硬编码凭据、fail-open 模式 | 面向“代码里已经存在的具体缺陷”；本 skill 面向“API/配置设计本身是否会诱导误用”，评审对象是设计而非已落地的代码缺陷 |
| vulnerability-triage-brocards（同市场） | 对已发现的漏洞做分诊分级，判断严重程度与优先级 | 处理“漏洞报告之后”的分诊环节；本 skill 处理“漏洞发生之前”的设计预防环节，两者服务于审计流程的不同阶段 |
| 通用安全 linter（如 Semgrep 规则） | 匹配预先定义的不安全代码语法模式 | 依赖既有规则库，难以覆盖“配置语义歧义”（如 timeout=0 到底是立即过期还是永不过期）这类需要人类式推理的场景；本 skill 用三种对手视角的威胁建模覆盖这类语义级风险 |
核心差异化：市面上的安全审查类技能大多聚焦“找出已经存在的漏洞代码”，本 skill 走的是“预防性设计评审”路线——在 API/配置还没定稿、还没被写成有漏洞的实现之前，先判断这个设计本身好不好被误用，与同市场的漏洞检测类技能形成互补而非重叠。
八、用户评价
安全媒体 Snyk 在其公开发布的《Top 9 Claude Skills for Cybersecurity, Hacking, and Vulnerability Scanning》评测文章中点名介绍 sharp-edges，将其描述为“识别那些不会以传统漏洞形式出现、但会给开发者制造 footgun 场景的易错 API 与危险配置”，文章同时称 Trail of Bits 整个技能集合是“该领域的黄金标准”。目前未发现来自 Reddit、Hacker News 等社区平台的具名用户评价。
九、其他补充
所属 trailofbits/skills 市场同时收录 insecure-defaults、audit-context-building、vulnerability-triage-brocards 等安全审计类技能，SKILL.md 明确将 sharp-edges 定位为“API/配置设计评审”这一专项，与市场内其他偏“漏洞检测”或“漏洞分诊”的技能功能互补、可组合使用。
十、安装使用方式
Claude Code 插件市场（推荐）：
/plugin marketplace add trailofbits/skills
/plugin install trailofbits/skills/plugins/sharp-edgesCodex：
codex plugin marketplace add trailofbits/skills
codex plugin add sharp-edges@trailofbits安装后注意事项： 安装无需重启，且不需要任何额外配置或凭据。就绪后把待评审的 API 设计、配置 schema 或加密库调用代码交给 Agent，用“footgun”“misuse-resistant”“secure defaults”等触发词描述需求即可触发；也可直接调用 sharp-edges-analyzer 子代理执行完整四阶段分析流程。
十一、注意事项
- 明确排除的场景：本技能不处理具体实现漏洞（如内存破坏、注入攻击）与业务逻辑缺陷，也不做性能优化评估——这些超出“接口/配置设计层面的误用风险”这一定位；
- License 为 CC-BY-SA-4.0，企业二次分发衍生内容前建议法务确认“相同方式共享”条款的适用范围；
- 该技能是“合集仓库中的一个子技能”，来源链接与安装命令务必使用本报告给出的子目录级路径，而非仓库根链接；
- 除 Claude Code / Codex 外，OpenClaw、Hermes Agent 的兼容性尚无可验证材料，如需在其他 Agent 环境使用请自行测试。