Agent Skills
返回列表
💻

Claude Code 插件分阶段触发评估

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/test-claude-code-plugin-and-skill-triggering-with-staged-eval-runs-using-cc-plugin-eval

技能介绍

要解决的具体问题

开发 Claude Code 插件时，组件触发时机是否正确往往是最隐蔽的问题。一个 skill 没被调用，是技能定义没生效，还是上下文匹配失败？一个 MCP 工具该出现时没出现，是配置遗漏还是 hook 拦截？靠人工反复试跑 prompt，既慢又不稳定，难以覆盖多种输入路径。

技能如何工作

cc-plugin-eval 通过分阶段评估把这件事自动化：它对插件目录运行一系列阶段性测试，逐项验证各类组件的触发行为。覆盖范围包括：

  • Skills：技能是否按预期被识别并调用
  • Agents：agent 定义是否可被加载
  • Commands：自定义命令是否注册成功
  • Hooks：钩子在对应事件上是否触发
  • MCP 组件：MCP server 是否按配置挂载

运行后可以拿到每阶段的评估结果，定位到具体是哪一类组件出了问题，而不需要靠猜。

适用边界与注意点

这套方法针对 Claude Code 插件的触发验证，前提是本地已有插件目录。它不做功能逻辑层面的单元测试，只回答「组件有没有在该触发时触发」。另外，评估依赖 Anthropic API，需要有效的 API key，且运行环境要求 Node.js 20+。如果你只是做纯文本 prompt 调试，这套分阶段流程并非必需。

使用场景

  • 改完 hooks 配置后，需要确认某个事件是否仍按预期触发插件命令。
  • 新增 skill 后，要验证在匹配上下文里会被 Claude Code 调用而不是被忽略。
  • 接入 MCP server 后，需要检查工具是否在插件运行阶段成功挂载并可被识别。
  • 发布插件前，想逐项跑一遍 skills、agents、commands、hooks、MCP 的触发检查。

适合人员

  • 开发 Claude Code 插件的工程师，需要验证组件在真实触发条件下是否生效。
  • 负责插件打包发布的维护者，想在发版前定位 skills 或 hooks 没触发的原因。
  • 为团队定制 agent/command 的工程师，需要确认自定义组件能在 Claude Code 中被加载。
  • 做 MCP 集成的技术负责人，想检查工具挂载失败是配置问题还是触发流程问题。