Pashov Solidity 安全技能包
为 AI 编码助手装上专业级 Solidity 安全审计、模糊测试与审计前扫描能力。
- Star 数
- ★ 1.3k
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- JavaScript
- FA 评分
- 45/100 · 缺口较多
30 秒速览
- 可在哪里用
- 兼容但需适配Codex · Claude CodeChatGPT(部分支持)
- 开始前需要
- 典型场景
- 智能合约开发者在上主网前,想快速自查代码中的高危漏洞。
- 主要局限
- 仓库实际是给其他 AI 助手用的技能提示文件,本身不含模型或运行时,能力上限取决于所接入的 AI 平台。
- 维护状态
- 近半年有提交最近提交 2026-10-21最新版本 v05102026(2026-10-05)近 7 天每天 +2.0 ★
这个 Agent 能做什么,适合哪些场景?
这是 Pashov Audit Group 开源的一套 AI 技能(skills)集合,面向 Solidity 智能合约安全。仓库包含三个技能目录:solidity-auditor 负责 AI 安全审计,fizz 为 Foundry 或 Hardhat 项目生成完整的 Echidna/Medusa 模糊测试套件,x-ray 做审计前扫描并输出威胁模型、不变量、入口点与 git 分析。使用方式是把仓库安装到支持 skills 的 AI 编程平台(Claude Code、Cursor、Codex、GitHub Copilot、Windsurf),再用自然语言提示触发对应技能。它本身不提供托管的审计服务,运行在你的本地开发环境中,依赖所选 AI 平台的模型。项目以 MIT 协议开源。
安装后,用户的提示词(例如“run an x-ray on the codebase”“run the solidity auditor with all the different agents possible on *specified files*”“run fizz on the codebase”)会触发对应技能。x-ray 在正式审计前扫描代码库,产出威胁模型、不变量、入口点和 git 历史分析;solidity-auditor 使用多个 agent 并行对 Solidity 代码做安全审计,README 称可发现数百个 Critical/High 级别漏洞;fizz 读取 Foundry 或 Hardhat 项目,生成可直接使用的 Echidna/Medusa 模糊测试套件。技能通过“update skills to latest version”这类提示进行更新。所有分析在 AI 平台内执行,结果以对话输出形式返回,仓库本身没有独立的 CLI 或 API。
- 智能合约开发者在上主网前,想快速自查代码中的高危漏洞。
- 安全研究员需要为新接手的协议快速建立威胁模型和不变量清单。
- 审计团队在正式人工审计前,用 x-ray 做一轮预扫描以确定重点区域。
- 已用 Foundry 或 Hardhat 开发的项目,需要自动生成 Echidna/Medusa 模糊测试用例。
- 使用 Claude Code 或 Cursor 的 Web3 团队,希望把安全审查嵌入日常编码流程。
如何安装或部署这个 Agent?
在支持安装技能或插件的 AI 编码平台中,直接把仓库地址交给助手。README 给出的安装提示为:
Install https://github.com/pashov/skills/ and run an x-ray on the codebase也可先克隆仓库,再按平台的方式挂载技能目录:
git clone https://github.com/pashov/skills.gitREADME 未说明各平台的具体安装命令、目录位置或所需凭据,这部分信息缺失。
如何使用这个 Agent?
安装完成后,在项目目录内用自然语言提示触发技能:
run an x-ray on the codebaserun the solidity auditor with all the different agents possible on *specified files*run fizz on the codebase更新到最新版本:
update skills to latest version需要已配置可用的 AI 平台账号与模型访问权限。
这个 Agent 有哪些优点和局限?
- 三个技能分工明确:审计前扫描(x-ray)、多 agent 审计(solidity-auditor)、模糊测试生成(fizz)形成完整链条。
- 明确列出支持 Claude Code、Cursor、Codex、GitHub Copilot、Windsurf 五个平台,覆盖面广。
- fizz 直接针对 Foundry 或 Hardhat 项目生成 Echidna/Medusa 套件,与现有 Solidity 工具链衔接。
- 由专注智能合约安全的 Pashov Audit Group 维护,采用 MIT 协议,可自由修改和商用。
- 仓库实际是给其他 AI 助手用的技能提示文件,本身不含模型或运行时,能力上限取决于所接入的 AI 平台。
- README 未给出各平台的具体安装命令和目录约定,安装步骤需要自行摸索。
- solidity-auditor“发现数百个 Critical/High 漏洞”的说法缺少可验证的基准测试数据支撑。
- 不提供独立的 CLI、API 或托管服务,无法接入 CI 流水线做自动化审计。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Pashov Solidity 安全技能包 当前 | 45 · 缺口较多 | — | ★ 1.3k | 1 个月前 | JavaScript | Codex · Claude Code |
| Cloudflare 安全审计技能 | 84 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 76k | 2 个月前 | JavaScript | — |
| RAMPART | 78 · 表现良好 | 代码库 / SDK免费 + 模型费 | ★ 427 | 1 天前 | Python | — |
| OrchestKit AI 开发工具箱 | 70 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 305 | 今天 | TypeScript | Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
技能以只读方式扫描代码库,但 x-ray 会执行 curl 拉取远程 VERSION、运行 forge/npx 覆盖命令并写入 x-ray/ 与 .solidity-auditor/ 目录,属于外部副作用,未见对网络请求或写入范围的显式授权说明,故 least_privilege 与 external_effects 仅给 1。fizz 提供 guided/automatic 模式与成本确认检查点,用户确认有实质设计,给 2。数据流透明度仅靠零散说明,无统一的数据去向声明,给 1。敏感数据处理仅 CLAUDE.md 一句“无密钥/个人数据”,无机制,给 1。依赖安全完全未涉及(forge、npx、python3、Echidna/Medusa 均无版本锁定或校验),给 0。回滚仅 fizz-convert 提到构建失败回滚,范围窄,给 1。来源归属有 README 品牌与 MIT 版权行,但发布者身份未验证,给 1。
SKILL.md 内部规则自洽(模式解析、硬规则、动作矩阵清晰),给 2。依赖可用性仅提示缺失工具时报告,无版本约束或安装校验,给 1。失败信息设计较好(步骤失败即停并报告阻塞、工具缺失说明尝试内容),给 2。
面向 Foundry/Hardhat 的 Solidity 审计场景,受众与场景明确,给 2。能力边界通过排除模式、参数、模式切换界定清楚,给 2。触发词在 frontmatter 中列举具体,给 2。环境适配仅覆盖 Foundry/Hardhat 与特定 AI 平台,未见对其他环境的适配说明,给 1。
信息架构清晰(README 表格、分技能目录、CLAUDE.md 结构),给 2。安装说明仅为自然语言提示词,无版本固定或校验步骤,给 1。命名稳定性有 VERSION 与自动 bump 工作流,但仅覆盖 solidity-auditor,其他技能无版本,给 1。示例与 FAQ 仅有调用提示词,无输出示例或常见问题,给 1。已知限制几乎未声明,给 1。许可证为完整 MIT 文本,给 2。版本与变更日志仅有 VERSION 数字自增,无 changelog,给 1。维护责任指向 GitHub 个人资料与社区渠道,但发布者未验证,给 1。
输出可用性较好(报告文件、PROPERTIES.md、x-ray 目录结构明确),给 2。边际价值依赖具体项目,README 宣称“数百个严重漏洞”无证据支撑,给 1。成本收益方面 fizz 有成本确认与模型分级,但整体 token/子代理开销大且无量化,给 1。
声明可追溯性弱:README 的漏洞数量宣称无引用,给 1。跨源佐证有限,技能间引用一致但无外部验证,给 1。事实与推断分离在 SKILL.md 中有一定体现(如“预期失败”说明),但整体混杂宣称与事实,给 1。
- 源码中未见:依赖安全审查安装前固定版本并做一次依赖扫描(如 npm audit、pip-audit);优先放在容器里运行。
- x-ray 技能会执行 curl 拉取远程 VERSION 并运行 forge/npx 覆盖命令,属于外部网络与执行副作用,使用前应确认网络与工具链权限。
- 依赖(forge、npx、python3、Echidna/Medusa)无版本锁定或完整性校验,环境差异可能导致行为不一致。
- README 宣称“发现数百个严重漏洞”缺乏证据支撑,不应作为质量保证。
- 发布者身份未经 FollowAgents 验证,维护责任与更新路径仅指向个人 GitHub 资料。
- 版本管理仅覆盖 solidity-auditor,其他技能无版本号或变更日志。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
What's Changed * Update Fizz demo GIF by @0xfirefistt in https://github.com/pashov/skills/pull/38 * fizz: remove shipped self-test and de-hardcode eval paths (#33) by @0xfirefistt in https://github.com/pashov/skills/pull/39 * solidity-auditor: v4 — loop mode, scan memory, shell-assembled report by @0xfirefistt in https://github.com/pashov/skills/pull/48 * solidity-auditor: keep mental tools internal, drop mandatory marker protocol by @0xfirefistt in https://github.com/pashov/skills/pull/49 * solidity-auditor: bump VERSION to 4.1 by @0xfirefistt in https://github.com/pashov/skills/pull/52 …在 GitHub 查看 ↗
常见问题
使用这套技能需要付费吗?
它能替代人工安全审计吗?
支持哪些技术栈的代码库?
代码会被发送到外部吗?
Pashov Solidity 安全技能包 开源吗?
Pashov Solidity 安全技能包 还在维护吗?
Pashov Solidity 安全技能包 是谁开发的?
谢谢反馈,我们会据此改进页面。