用途:把插件打包成可分发的 .zip 归档,适合导入 Claude Code(claude --plugin-dir)、分享给其他开发者或代码库、生成发布产物。
主要能力:打包时保留 agents/ 和 commands/ 目录的符号链接(--symlinks);排除 .DS_Store、pycache、.history/、node_modules/、*.pyc、.git/;输出命名为 <plugin-name>-v<version>.zip;打包前校验 plugin.json 模式。
使用方式:
- 校验插件:python3 plugins/plugin-manager/skills/package-plugin/scripts/package.py --validate-only --plugin <path-to-plugin>。校验内容包括 .claude-plugin/plugin.json 存在且为合法 JSON、name 为 kebab-case、version 为 semver、author 为对象而非字符串、至少存在一个 skills/*/SKILL.md。
- 打包:python3 plugins/plugin-manager/skills/package-plugin/scripts/package.py --plugin <path-to-plugin> --output <destination>,默认输出为 ~/Desktop/<plugin-name>-v<version>.zip。
- 可选校验包:python3 plugins/plugin-manager/skills/package-plugin/scripts/package.py --verify <path-to-zip>,会解压到 /tmp/package-verify/ 并确认结构完整。
限制与规则:打包前务必先校验;不要手动 zip 插件,应始终使用该脚本以保证正确的标志。来源透明度声明要求说明打包了哪个插件及输出路径。其它未提供的信息暂未说明。