开发 Claude Code 插件时，先做一个可验证的最小结构，再逐步加入 Hook、MCP 或子智能体。这样能把“清单错误”和“组件逻辑错误”分开。
创建最小目录
先创建只包含名称和一个 Skill 的最小插件，不要一开始加入 Hook 或外部服务。清单固定放在 .claude-plugin/plugin.json；其他组件目录放在插件根目录，而不是 .claude-plugin 里面。
my-plugin/
├─ .claude-plugin/
│ └─ plugin.json
└─ skills/
└─ review/
└─ SKILL.md{
"name": "my-review-plugin",
"version": "0.1.0",
"description": "提供一个只读代码审查 Skill"
}写一个可验收的 Skill
Skill 应说明触发场景、输入、步骤和输出格式。第一版只读 diff 并输出风险清单，不运行外部命令、不写文件，便于安全测试。
验证清单与路径
运行 claude plugin validate ./my-plugin；只有 Validation passed 才进入加载测试。
claude plugin validate ./my-plugin
claude --plugin-dir ./my-plugin在临时仓库调用插件命令，确认名称空间、说明和只读输出。再故意改错一个路径，确认验证器能报告问题，随后恢复。
发布前检查
- 所有相对路径以插件根为基准且不能逃出目录。
- 敏感配置使用用户配置或环境变量，不写进仓库。
- Hook 和 MCP 增加新的执行能力时重新做安全审查。
本地验证通过只说明结构可加载，不代表插件逻辑安全或适合发布。
资料与适用范围
目录结构参考 官方插件概览，字段与验证命令参考 插件清单参考。示例插件未发布到市场，也未在你的环境运行。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/30900.html
