触发条件
当 Claude Code 执行以下操作时,本技能会被自动触发:
- •频繁使用工具 - 连续使用 5+ 次文件操作或命令执行
- •操作失败 - 检测到工具调用失败
- •慢操作 - 单次操作耗时超过 5 秒
- •用户询问 - 用户提到"性能"、"效率"、"耗时"、"慢"等关键词
监控内容
实时监控
- •✅ 操作计数(总数、成功、失败)
- •✅ 平均耗时统计
- •✅ 慢操作检测(> 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)
技术实现
本技能通过以下方式与监控插件集成:
- •读取缓存:
~/.claude/ai-insights/current-session.json - •计算指标:调用 Analyzer 获取实时统计
- •格式化输出:使用 Renderer 生成友好提示
- •触发报告:必要时建议用户使用
/perf-report
约束
- •不记录敏感信息(代码内容、用户数据)
- •仅分析操作元数据(工具名、路径、耗时)
- •性能数据仅存储在本地(
~/.claude/ai-insights/) - •不主动上传数据到外部服务