SuperAPI AI 工具集

plugin-integration-checker

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

用途:在创建或修改技能后,检查该技能是否属于 Claude Code 插件,并验证其与命令(commands)和智能体(agents)的集成是否符合三层架构模式。当技能路径包含 .claude-plugins/ 或 plugins/,或用户要求检查插件集成时使用。

主要能力:

  1. 检测插件上下文:从技能目录向上查找 .claude-plugin/plugin.json,未找到则判定为独立技能并退出。
  2. 读取插件元数据:用 jq 提取插件名称与版本。
  3. 检查关联命令与智能体:在 commands/ 和 agents/ 目录中搜索引用该技能名的 Markdown 文件。
  4. 分析集成质量:按命令、智能体、技能三层清单逐项核对,如命令是否含前置检查、用户交互、智能体委派、结果验证;智能体是否明确能力、引用技能、含错误处理与迭代;技能是否含 API 文档、最佳实践、示例、故障排查,且不包含工作流逻辑。
  5. 生成集成报告:包含插件信息、集成状态、架构合规性(符合/部分/较差)与具体改进建议,并计算集成评分(命令质量×0.4 + 智能体质量×0.3 + 技能质量×0.3)。

使用方式:示例命令为 /check-integration ~/.claude/plugins/my-plugin/skills/my-skill。报告生成后可向用户展示,并可选地创建或更新插件根目录的 ARCHITECTURE.md 与 README.md。

适用场景:插件内技能的开发与维护、架构合规审查、集成问题排查。

限制:资料未提供该技能的安装方式、收费信息、支持平台及具体运行环境要求;其检测依赖插件目录结构与 plugin.json,非插件技能会被直接判定为独立。