SuperAPI AI 工具集

create-plugin

智能体与模型

查看项目

更新于 10-16 08:00

技能介绍

用途:按 create-plugin 技能工作流脚手架生成一个新的 Claude Code 顶层插件目录。不用于创建单个技能(应使用 create-skill),也不用于为已有插件添加 MCP 集成。

主要能力:分阶段完成发现用途与插件类型、规划组件表(skills / commands / agents / hooks / MCP)、按组件追问澄清问题、生成目录结构与 plugin.json、用相应子技能实现各组件、验证、测试与文档。可选参数 $ARGUMENTS 传入 kebab-case 插件名;省略则从发现阶段开始。

必要用法:每次脚手架技能、智能体、命令和钩子后,必须读取 .claude-plugin/plugin.json,核对各生成目录与文件是否出现在对应列表中,缺失项立即补上。随后生成 plugin.yaml 以兼容 hermes-agent,字段含 name、version、description、author、kind(backend 或 standalone)、platforms、provides_tools、skills;仅当 scripts/ 含可调用工具脚本时才写 provides_tools。若插件含可调用 Python 脚本,需在根目录生成 init.py 并提供 register(ctx) 函数,为每个技能调用 register_skill(),仅在需要时添加 register_tool() 与 register_hook();缺少该文件 hermes 会提示 No init.py 且插件无法激活。

共享脚本:技能调用插件内共享 Python 辅助脚本时,应在技能 scripts/ 下创建指向插件根目录规范副本的文件级符号链接,不要复制文件。示例命令:ln -s ../../../scripts/<canonical_name>.py <symlink_name>.py,或使用 symlink_manager.py create --src ... --dst ...。Windows 或 core.symlinks 为 false 时符号链接会退化为纯文本文件,需运行 bulk_symlink_fixer.py 修复并手动核验。

输出:包含 .claude-plugin/plugin.json、组件目录、README.md 及 .claude/settings.json 存根的插件目录。完成后可运行 /agent-scaffolders:audit-plugin 校验结构。通过 marketplace.json 分发时,条目应显式设置 strict: true,并确保插件自带 plugin.json。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;架构标准可参考 references/ADRs/ 中的决策记录。