mc-skills/catalog

Fork 0

mc-skills c8e8049202 catalog: 更新 2026-04-06 19:01

2026-04-06 19:01:37 +08:00

12 KiB

Raw Blame History

Solidity智能合约AI技能包

Solidity 智能合约 AI编程助手 DeFi安全 Foundry EVM

solidity-agent-kit

经过实战检验的 Solidity 智能合约开发 AI 代理技能集

为你的编程代理装备专业级 Solidity 实践 —— 从编码规范到 DeFi 安全。

EVM 兼容链

什么是 solidity-agent-kit？

solidity-agent-kit 是一套 AI 代理技能集合，为你的编程代理注入专业级 Solidity 开发知识。无需每次手写提示词，也不必寄希望于 AI 代理自行了解最佳实践 —— 一次安装，即可在所有项目中获得一致、经过实战验证的开发行为。

为你的 AI 编程代理装备经过实战检验的 Solidity 开发实践 —— 从编码规范到 DeFi 安全。

未使用 solidity-agent-kit              使用 solidity-agent-kit
─────────────────────────              ─────────────────────────
AI 代理直接写代码...                    AI 代理调用 /solidity-coding
  ❌ 风格不一致                           ✅ 强制 NatSpec、自定义错误
  ❌ 遗漏安全检查                         ✅ 执行 /solidity-security 规则
  ❌ 无部署验证流程                       ✅ 强制部署前检查清单
  ❌ 测试覆盖率低                         ✅ 模糊测试、100% 分支覆盖
  ❌ 存在 DeFi 漏洞                       ✅ 反闪电贷、反鲸鱼操控保护

安装

快速安装

# 交互模式 —— 选择要安装的技能
npx skills add 0xlayerghost/solidity-agent-kit

# 一次性安装所有技能（无需确认）
npx skills add 0xlayerghost/solidity-agent-kit -y

自动检测机器上所有 AI 代理并逐一安装。会创建 .agents/、.claude/、.cursor/、.windsurf/ 目录 —— .agents/ 存放实际文件，其余为符号链接。

指定代理安装

# Claude Code
npx skills add 0xlayerghost/solidity-agent-kit -y --agent claude-code

# Cursor
npx skills add 0xlayerghost/solidity-agent-kit -y --agent cursor

# Windsurf
npx skills add 0xlayerghost/solidity-agent-kit -y --agent windsurf

安装后配置

将 CLAUDE.md 模板复制到项目根目录，技能将自动触发 —— 无需手动输入 /斜杠命令：

curl -sL https://raw.githubusercontent.com/0xlayerghost/solidity-agent-kit/main/CLAUDE.md.template -o CLAUDE.md

或手动将 CLAUDE.md.template 复制为项目根目录下的 CLAUDE.md。

CLAUDE.md 在每次 Claude Code 会话启动时自动加载，告诉代理何时自动调用各项技能。

添加到 .gitignore 保持仓库整洁：

# 代理技能（本地安装，不提交到仓库）
.agents/
.claude/
.cursor/
.trae/
.windsurf/

卸载

npx skills remove 0xlayerghost/solidity-agent-kit

内置技能

#	技能	触发时机	说明	链接
1	solidity-coding	编写/编辑 `.sol` 文件	Pragma 声明、命名规范、NatSpec 注释、自定义错误、反模式、OZ 导入	查看
2	solidity-security	编写/编辑任意合约	私钥保护、访问控制、重入防护、Gas 限制	查看
3	solidity-testing	编写/编辑 `*.t.sol`	测试布局、覆盖率 ≥90%、模糊测试、Foundry 不变量测试	查看
4	solidity-deploy	编写 `*.s.sol` / 部署合约	部署前检查清单、环境变量、构造参数、部署后工作流	查看
5	solidity-debug	调试失败交易	Cast 调用数据解码、回滚分析、Gas 诊断、追踪读取	查看
6	solidity-audit	安全审计	手动审计检查清单：存储、访问控制、算术运算、ERC 兼容性	查看
7	defi-security	DeFi 协议开发	反鲸鱼、反闪电贷、上线检查清单、紧急暂停、MEV 防护	查看
8	git-workflow	提交/PR 前	约定式提交、分支命名、Solidity 项目 PR 模板	查看
9	claude-code-usage	每次 `/clear` 后	上下文恢复、子代理策略、计划模式、TodoWrite 使用模式	查看

EVM 链支持

技能专为 EVM 兼容链设计，与 Foundry 多链工具链开箱即用：

主网 / L2                     测试网
──────────────                ──────────────
Ethereum (ETH)                Sepolia
Polygon (MATIC)               Mumbai
Arbitrum One                  Arbitrum Sepolia
Optimism                      OP Sepolia
Base                          Base Sepolia
Avalanche C-Chain             Fuji
BNB Smart Chain               BSC Testnet
zkSync Era                    zkSync Sepolia
Linea                         Linea Sepolia

部署和调试技能中涵盖了链特定的 foundry.toml 配置、RPC URL 管理及 cast 命令。

架构说明

你的项目
    │
    ├── CLAUDE.md ◄── 技能自动触发规则
    │
    └── .agents/
        └── 0xlayerghost/
            └── solidity-agent-kit/
                ├── solidity-coding/    ──► 强制代码风格与 NatSpec
                ├── solidity-security/  ──► 访问控制与重入防护
                ├── solidity-testing/   ──► 模糊测试 + 不变量覆盖
                ├── solidity-deploy/    ──► 部署前后检查清单
                ├── solidity-debug/     ──► 基于 Cast 的交易分析
                ├── solidity-audit/     ──► 手动安全审计
                ├── defi-security/      ──► DeFi 特定攻击向量
                ├── git-workflow/       ──► 约定式提交与 PR
                └── claude-code-usage/  ──► 代理上下文策略


AI 代理工作流：
─────────────────────────────────────────────────────────────
 用户请求 ──► CLAUDE.md 检测任务类型
                       │
          ┌────────────┼────────────┐
          ▼            ▼            ▼
    编写 .sol      测试 .t.sol   部署 .s.sol
          │            │            │
   /solidity-coding  /solidity-   /solidity-deploy
   /solidity-security  testing    /defi-security
          │            │            │
          └────────────┴────────────┘
                       │
                  forge build
                  forge test
                       │
                  ✅ 验证通过

支持的代理

代理	状态	备注
Claude Code	✅ 完整支持	最佳体验 —— CLAUDE.md 自动触发
Cursor	✅ 完整支持	`.cursor/rules` 集成
Windsurf	✅ 完整支持	`.windsurf/rules` 集成
Trae	✅ 支持	`.trae` 集成
OpenCode	✅ 支持	—
Gemini CLI	✅ 支持	—
GitHub Copilot	🚧 部分支持	需手动调用
Codex CLI	✅ 支持	—

技术栈

工具	版本	用途
Solidity	`^0.8.20`	智能合约语言
Foundry	最新版	构建、测试、部署（`forge`、`cast`、`anvil`）
OpenZeppelin	`4.9.x`	安全合约标准（ERC20/721/1155/Governor）
Slither	最新版	静态分析（90+ 漏洞检测器）
skills.sh	最新版	技能包管理与分发

项目结构

solidity-agent-kit/
├── CLAUDE.md.template              ← 复制到项目根目录并重命名为 CLAUDE.md
├── skills/
│   ├── solidity-coding/            ← 编码规范与命名约定
│   │   └── SKILL.md
│   ├── solidity-security/          ← 安全最佳实践
│   │   └── SKILL.md
│   ├── solidity-testing/           ← 测试组织与覆盖率
│   │   └── SKILL.md
│   ├── solidity-deploy/            ← 部署工作流与检查
│   │   └── SKILL.md
│   ├── solidity-debug/             ← 链上交易调试
│   │   └── SKILL.md
│   ├── solidity-audit/             ← 手动安全审计检查清单
│   │   └── SKILL.md
│   ├── defi-security/              ← DeFi 特定攻击防护
│   │   └── SKILL.md
│   ├── git-workflow/               ← Solidity 项目 Git 规范
│   │   └── SKILL.md
│   └── claude-code-usage/          ← AI 代理上下文策略
│       └── SKILL.md
├── openai/
├── LICENSE
└── README.md

适用人群

使用 Foundry（forge、cast、anvil）的 Solidity 开发者
构建 DeFi 协议、NFT 项目和 DAO 治理的团队
希望获得一致、安全输出的 AI 编程代理用户
使用 Slither + 手动检查清单进行自动化审计的安全工程师
在 EVM 兼容链上部署合约的任何开发者

许可证

MIT —— 详见 LICENSE

由 0xlayerghost 构建

区块链与 Solidity 工程师

如果这个项目帮助你交付了更安全的合约，请给一个 ⭐

12 KiB Raw Blame History Unescape Escape