plugin-best-practices

此技能是 Claude Code 插件开发者的主要架构验证器。它提供自动化监督，确保插件符合既定的最佳实践、结构要求与界面模式。专为在 Claude Code 生态系统中构建专业代理、技能与 MCP 服务器的开发者所设计，此工具能强制执行整个插件生命周期的一致性，从清单文件建立到最终部署就绪。对于维持代码质量、确保通过渐进式揭露来遵守 Token 预算，以及验证工具调用是否符合安全与功能准则至关重要。

• 针对文件布局、目录命名与 kebab-case 规范的自动化结构验证。

• 根据架构要求与必要元数据字段进行全面的清单文件验证。

• 针对技能与代理组件进行严格的前置内容审计，确保使用第三人称语气与准确的触发短语。

• 工具调用分析，用于检测并解决隐式与显式工具调用之间的模式冲突。

• 渐进式揭露合规检查，确保 SKILL.md 文件保持在 5k Token 预算内，以便高效加载上下文。

• RFC 2119 要求等级执行，以确保技术文档明确无歧义。

• 开发者应在启动新插件项目或准备发布现有插件时触发此技能。

• 工作流程包含五个顺序检查：结构、清单、前置内容、工具调用与 Token 预算。

• 预期的输出包括详细记录通过检查的项目，以及针对检测到的任何违规事项的具体可执行修复建议。

• 整合方式无缝简便；只需透过提供的 Python 脚本执行验证器，或在开发环境中调用该技能即可。

• 限制条件包括严格遵守插件组件模型，其中指令型技能、知识型技能、代理与 MCP 服务器各有独特的实现要求。

• 请务必使用显式命名惯例（plugin-name:component-name），以确保跨插件引用的正确解析。