performance-monitor

---

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

触发条件

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

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

监控内容

实时监控

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

语义化分析

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

效率评分

• ✅ 成功率权重（40%）
• ✅ 速度评分（30%，对比历史）
• ✅ 稳定性评分（30%，方差）

响应策略

主动提示（可选）

当检测到性能问题时，可以主动提醒：

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

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

被动响应

用户询问时，提供当前性能概览：

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

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

使用示例

用户：为什么这么慢？

响应：

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

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

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

用户：我的效率怎么样？

响应：

Copy当前会话效率评分：85/100 ⭐⭐⭐⭐

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

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

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

技术实现

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

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

约束

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