Community编程与开发github.com

Looperswag/skill-doctor

代理技能、钩子与子代理诊断工具,附带可视化诊断面板。

skill-doctor 是什么?

Looperswag/skill-doctor 是一款专为 AI 代理(如 Claude Code、Coder 等)设计的诊断与调试工具。它集成了技能(skill)、钩子(hook)和子代理(subagent)的检查能力,并附带一个可视化的诊断仪表盘。开发者可以通过该技能快速定位代理运行时的行为异常、检查钩子执行状态、以及分析子代理的调用链路。其核心价值在于,无需手动翻阅日志或编写额外检测脚本,即可获得直观的调试信息。该技能支持多种主流代理平台,工作原理是通过注入轻量级检测代码,实时捕获代理运行时的关键事件,并通过一个捆绑的 Web 仪表盘展示结果。这让调试过程变得高效且可视化,尤其适合开发复杂代理工作流或需要频繁调整代理行为的场景。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add Looperswag/skill-doctor

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

skill-doctor 是做什么的?

代理技能、钩子与子代理诊断工具,附带可视化诊断面板。

概述

本技能为 AI 代理(如 Claude Code、Coder 等)提供了一套完整的诊断与调试解决方案。它允许你检查代理的技能(skill)注册情况、钩子(hook)的执行状态以及子代理(subagent)的调用行为,所有诊断结果均通过一个捆绑的可视化仪表盘展示。

功能特性

  • 技能诊断:列出并验证当前代理环境中所有已注册的技能及其状态。
  • 钩子诊断:检查钩子函数的注册、触发与执行情况,帮助排查事件处理中的问题。
  • 子代理诊断:追踪子代理的创建、调用与返回流程,分析多层代理间的交互。
  • 可视化仪表盘:内置 Web 仪表盘,以图形化方式展示诊断数据,无需手动解析日志。

工作原理

该技能通过注入轻量级检测代码,在代理运行时自动捕获关键事件(如技能调用、钩子触发、子代理生成等)。捕获的数据被整理为结构化格式,并通过一个捆绑的 HTTP 服务提供可视化界面。用户只需通过浏览器访问指定端口,即可实时查看诊断结果。

使用方法

  1. 将本技能添加到你的代理配置中。
  2. 启动代理,技能会自动开始监控。
  3. 在浏览器中打开诊断仪表盘的 URL(默认端口请参考配置说明)。
  4. 查看技能、钩子、子代理的实时状态与历史记录。

支持平台

  • Claude Code
  • Coder
  • 其他兼容 AI 代理(通过标准技能接口集成)

配置说明

仪表盘端口可以通过环境变量 DOCTOR_DASHBOARD_PORT 进行自定义(默认值为 8080)。诊断记录的采样频率可通过环境变量 DOCTOR_SAMPLE_INTERVAL 调整(以秒为单位)。

注意事项

  • 确保诊断仪表盘的端口未被其他服务占用。
  • 在生产环境中,建议仅在调试阶段启用本技能,以避免性能开销。
  • 诊断数据不会持久化,重启代理后数据将被清除。

贡献与支持

如果你遇到问题或有改进建议,请访问 GitHub 仓库 提交 Issue 或 Pull Request。


注意:本技能仅供开发和调试使用,请勿将其用于未经授权的监控。

相关技能