skill-doctor 是做什么的?
代理技能、钩子与子代理诊断工具,附带可视化诊断面板。
概述
本技能为 AI 代理(如 Claude Code、Coder 等)提供了一套完整的诊断与调试解决方案。它允许你检查代理的技能(skill)注册情况、钩子(hook)的执行状态以及子代理(subagent)的调用行为,所有诊断结果均通过一个捆绑的可视化仪表盘展示。
功能特性
- 技能诊断:列出并验证当前代理环境中所有已注册的技能及其状态。
- 钩子诊断:检查钩子函数的注册、触发与执行情况,帮助排查事件处理中的问题。
- 子代理诊断:追踪子代理的创建、调用与返回流程,分析多层代理间的交互。
- 可视化仪表盘:内置 Web 仪表盘,以图形化方式展示诊断数据,无需手动解析日志。
工作原理
该技能通过注入轻量级检测代码,在代理运行时自动捕获关键事件(如技能调用、钩子触发、子代理生成等)。捕获的数据被整理为结构化格式,并通过一个捆绑的 HTTP 服务提供可视化界面。用户只需通过浏览器访问指定端口,即可实时查看诊断结果。
使用方法
- 将本技能添加到你的代理配置中。
- 启动代理,技能会自动开始监控。
- 在浏览器中打开诊断仪表盘的 URL(默认端口请参考配置说明)。
- 查看技能、钩子、子代理的实时状态与历史记录。
支持平台
- Claude Code
- Coder
- 其他兼容 AI 代理(通过标准技能接口集成)
配置说明
仪表盘端口可以通过环境变量 DOCTOR_DASHBOARD_PORT 进行自定义(默认值为 8080)。诊断记录的采样频率可通过环境变量 DOCTOR_SAMPLE_INTERVAL 调整(以秒为单位)。
注意事项
- 确保诊断仪表盘的端口未被其他服务占用。
- 在生产环境中,建议仅在调试阶段启用本技能,以避免性能开销。
- 诊断数据不会持久化,重启代理后数据将被清除。
贡献与支持
如果你遇到问题或有改进建议,请访问 GitHub 仓库 提交 Issue 或 Pull Request。
注意:本技能仅供开发和调试使用,请勿将其用于未经授权的监控。