SuperAPI AI 工具集

claude-plugin-converter

智能体与模型

查看项目

更新于 10-16 01:19

技能介绍

用途:将 Claude Code 插件(.claude-plugin/plugin.json 清单及各类组件)转换为自包含、可安装的 Hermes 插件,输出 plugin.yaml、init.py 以及打包的技能与钩子。

主要能力:采用两阶段流程。发现阶段运行 python3 {SKILL_DIR}/scripts/analyze.py <claude_plugin_dir> --output <output_dir>/analysis.json,分析并给出各组件可转换性(可干净转换、部分转换、无对应项)。转换阶段运行 python3 {SKILL_DIR}/scripts/convert.py <claude_plugin_dir> --analysis <output_dir>/analysis.json --output <output_dir>/<plugin_name>,生成完整插件目录,含 plugin.yaml、init.py、schemas.py、tools.py、hooks.py、skills/、engines/、foundations/、connectors/、mcp_config.yaml、CONVERSION_REPORT.md、MANUAL_STEPS.md。

组件映射:清单直接映射;技能经 frontmatter 重映射并 ctx.register_skill();命令转 ctx.register_command();钩子约 30 个事件中约 10 个有对应;agents 转为委托技能;MCP 配置翻译;LSP 无对应被跳过;monitors 记为手动 cron 设置。

安装与验证:cp -r <output_dir>/<plugin_name> ~/.hermes/plugins/ 后执行 hermes plugins enable <plugin_name>,重启;有 MCP 时合并 mcp_config.yaml 或用 hermes mcp add;用 HERMES_PLUGINS_DEBUG=1 hermes plugins list 检查发现。插件技能为可选启用,通过 skill_view("plugin-name:skill-name") 加载,不出现在 available_skills 中属正常。

已知限制:$ARGUMENTS、disable-model-invocation、prompt/agent 钩子类型及 LSP 无对应;agent 行为与 Claude 不完全一致;Monitors 概念不同需手动设置;部分钩子事件无法转换。安全上仅转换可信来源,启用前须审查 hooks.py 中的 subprocess.run 与 CMD* 变量、init.py 注册内容、mcp_config.yaml 与 MANUAL_STEPS.md。资料未提供收费或价格信息。