AgentSkillsCN

performance-monitor

自动监控Claude Code的各项性能指标,包括操作耗时、失败率、效率评分,并提供语义化的洞察分析。

SKILL.md
--- frontmatter
name: performance-monitor
description: 自动监控 Claude Code 性能指标,包括操作耗时、失败率、效率评分,并提供语义化洞察

触发条件

当 Claude Code 执行以下操作时,本技能会被自动触发:

  1. 频繁使用工具 - 连续使用 5+ 次文件操作或命令执行
  2. 操作失败 - 检测到工具调用失败
  3. 慢操作 - 单次操作耗时超过 5 秒
  4. 用户询问 - 用户提到"性能"、"效率"、"耗时"、"慢"等关键词

监控内容

实时监控

  • ✅ 操作计数(总数、成功、失败)
  • ✅ 平均耗时统计
  • ✅ 慢操作检测(> 5s 标记,> 30s 红色警告)
  • ✅ 失败率计算

语义化分析

  • ✅ 操作分类(config/bugfix/feature/refactor/test)
  • ✅ 模块分组(自动提取文件路径模式)
  • ✅ 会话主题生成(基于高频操作)

效率评分

  • ✅ 成功率权重(40%)
  • ✅ 速度评分(30%,对比历史)
  • ✅ 稳定性评分(30%,方差)

响应策略

主动提示(可选)

当检测到性能问题时,可以主动提醒:

code
⚠️ 检测到性能问题:
- 最近 5 次操作平均耗时 8.2s(高于正常值 2.1s)
- 2 个操作失败(file_not_found)
- 建议:检查文件路径是否正确

使用 /perf-report 查看详细报告

被动响应

用户询问时,提供当前性能概览:

code
当前会话性能:
- ✅ 成功率: 95.2%
- ⏱️ 平均耗时: 1.8s
- 📊 效率评分: 85/100
- 🐌 慢操作: 3 个
- ❌ 失败: 2 个

使用 /perf-report 查看详细分析

使用示例

用户:为什么这么慢?

响应:

code
检测到以下慢操作:
1. npm install (45s 🔥)
2. git clone repo (28s 🐌)
3. Read large-file.json (12s 🐌)

可能原因:
- 网络下载依赖速度慢
- 仓库较大,克隆耗时
- JSON 文件较大,解析时间长

建议:
- 使用 npm 镜像源加速
- 考虑浅克隆 (git clone --depth 1)
- 大文件考虑分块处理

用户:我的效率怎么样?

响应:

code
当前会话效率评分:85/100 ⭐⭐⭐⭐

细分得分:
- 成功率: 95% ⭐⭐⭐⭐⭐
- 速度: 良好 ⭐⭐⭐⭐
- 稳定性: 一般 ⭐⭐⭐

改进建议:
- 减少重复读取相同文件(可使用缓存)
- 部分操作耗时较长,可考虑优化

历史对比:
- 高于历史平均 (78/100)
- 低于最佳会话 (92/100)

技术实现

本技能通过以下方式与监控插件集成:

  1. 读取缓存~/.claude/ai-insights/current-session.json
  2. 计算指标:调用 Analyzer 获取实时统计
  3. 格式化输出:使用 Renderer 生成友好提示
  4. 触发报告:必要时建议用户使用 /perf-report

约束

  • 不记录敏感信息(代码内容、用户数据)
  • 仅分析操作元数据(工具名、路径、耗时)
  • 性能数据仅存储在本地(~/.claude/ai-insights/
  • 不主动上传数据到外部服务