最近在做一个自动化逆向恶意软件的项目,我觉得直接基于 claude code的能力配置一些专用skill、mcp工具就可以,遂有了这篇文章。

Claude Code 插件开发与使用

插件结构


my-plugin/
├── .claude-plugin/
│   ├── plugin.json          # 必需:插件元数据
│   └── marketplace.json     # 可选:市场配置(用于分发)
├── commands/                # 可选:Slash 命令
├── agents/                  # 可选:子代理定义
├── skills/                  # 可选:Agent Skills
│   └── skill-name/
│       └── SKILL.md
├── hooks/                   # 可选:事件处理
└── .mcp.json                # 可选:MCP 服务器配置

编写插件

1. 创建 plugin.json

.claude-plugin/plugin.json 中定义插件元数据:

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "插件描述",
  "author": {
    "name": "作者名"
  }
}

2. 创建 Skill

skills/skill-name/SKILL.md 中定义技能:

---
name: skill-name
description: 简洁描述技能用途,Claude 会根据此决定何时调用
---
  
技能的具体指令内容...

3. 创建 Marketplace(可选)

.claude-plugin/marketplace.json 中定义市场:

{
  "name": "my-marketplace",
  "owner": {
    "name": "维护者"
  },
  "plugins": [
    {
      "name": "my-plugin",
      "source": "./",
      "description": "插件描述"
    }
  ]
}

安装插件

CLI 方式

# 添加市场
claude plugin marketplace add <路径或仓>
  
# 从市场安装
claude plugin install <插件>@<市场>
  
# 示例
claude plugin marketplace add D:/code/analyze
claude plugin install malware-analysis-tools@malware-analysis

Claude Code 内部方式

# 添加市场
/plugin marketplace add <路径或仓>
  
# 从市场安装
/plugin install <插件>@<市场>
  
# 示例
/plugin marketplace add D:/code/analyze
/plugin install malware-analysis-tools@malware-analysis

安装范围

# 用户级别(默认)
claude plugin install plugin@market
  
# 项目级别
claude plugin install -s project plugin@market
  
# 本地级别
claude plugin install -s local plugin@market

Windows 路径注意事项

使用相对路径安装目录形式的插件:

# 推荐使用相对路径
claude plugin marketplace add ./path/to/plugin
claude plugin marketplace add ../marketplace
  
# 避免使用绝对路径(可能因权限或路径格式问题失败)

临时加载(不安装)

# 临时加载插件目录(当前会话有效)
claude --plugin-dir ./path/to/plugin

更新插件

# CLI 方式
claude plugin update <插件>
  
# 更新所有插件
claude plugin update
  
# 内部方式
/plugin update <插件>

常用命令

# 查看已安装插件
claude plugin list
  
# 查看市场列表
claude plugin marketplace list
  
# 启用/禁用插件
claude plugin enable <插件>
claude plugin disable <插件>
  
# 卸载插件
claude plugin uninstall <插件>
  
# 验证插件配置
claude plugin validate <>

调试技巧

  1. 使用 --plugin-dir 临时加载测试
  2. 检查 skills 目录位置是否在插件根目录
  3. 确认 SKILL.md 文件名大写且包含有效的 frontmatter
  4. 验证 JSON 格式正确

参考资料