mcpField
I
inspect-perf

inspect-perf

github.com/venhdev测试与质量153 次安装1 天前更新
代码仓库

关于 inspect-perf

inspect-perf 是面向代码审查的性能与资源效率技能，供需要评估指定文件、目录或子系统的开发者使用。它按性能规则检查结构性风险，并区分局部修复与架构级改造；未指定范围时会停止审查。

主要功能

  1. 01要求明确指定审查范围
  2. 02依据性能规则检查算法与 I/O 风险
  3. 03忽略微基准级优化问题
  4. 04区分局部修复与架构级改造
  5. 05输出结构化性能审查报告

适用场景

  1. 01审查指定模块的算法与资源使用
  2. 02识别可能放大 I/O 的代码路径
  3. 03为性能问题确定后续处理路线

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/venhdev/skills --skill inspect-perf

安装后在 Claude Code 中输入/inspect-perf确认已加载。

附带文件references/performance-rubric.md

详细介绍

inspect-perf — 语义性能与资源效率审计器

领域评估标准

1. 范围与可容忍性防护规则（忽略事项）
  • 强制目标范围：用户必须指定明确的目标路径（file、directory 或 subsystem）。如果未提供目标范围，立即停止当前轮次并提示用户指定范围；禁止对整个代码库进行推测性扫描。
  • 语义债务与微基准测试：严格将分析限定于结构性算法风险、I/O 倍增和资源滞留；忽略亚微秒级指令微优化、编译器内联细节或冷路径上的过早缓存。
  • 约束性参考：严格依据 references/performance-rubric.md 评估性能模式。
2. 决策分流：[LOCAL-FIX] 与 [ARCHITECTURAL-REFACTOR]
  • [LOCAL-FIX]（函数内局部优化）：在单个方法或文件中进行算法查找索引优化（$O(1)$ 集合/映射）、循环不变量提取或字符串构建器替换。将保持行为的候选项路由至 /simplify-audit；新增查询限制或改变结果语义则需要 /changeset。
  • [ARCHITECTURAL-REFACTOR]（系统性结构修复）：将笛卡尔连接拆分为拆分查询 / DataLoaders、提取事务发件箱以解耦网络 I/O 与数据库事务、卸载至工作线程，或引入有界分布式缓存。将修复工作路由至 /changeset。

规范输出约定

# Performance Audit Dossier: <Target Scope>

## 1. Executive Summary
- **Target Inspected**: `<directory_or_file_path>`
- **Health Rating**: <OPTIMAL | LOCALIZED_BOTTLENECK | CRITICAL_DEGRADATION>
- **Primary Bottleneck**: <Single-sentence summary of highest-latency or highest-risk resource hazard>

## 2. Load-Bearing Defect Catalog
### [<CRITICAL | MAJOR>] [<LOCAL-FIX | ARCHITECTURAL-REFACTOR>] <Dimension>: `<Target Symbol / Query>`
- **Offending Code**: [<file>#L<N>](file:///path/to/file#L<N>)
- **Violated Rubric**: [<spec_or_dimension>](references/performance-rubric.md#anchor)
- **Smell**: <Observable bottleneck, complexity multiplier, or resource leak description>
- **Action**: <[LOCAL-FIX] Local optimization OR [ARCHITECTURAL-REFACTOR] Separation / batching path>

*(Emit 'No load-bearing performance defects observed across rubric dimensions' if clean)*
路由
  • 可审计行为等价性的本地索引或构建器变更 →（通过 /simplify-audit）。
  • 改变结果语义或进行系统性拆分查询、发件箱、连接池或线程池重构 →（通过 /changeset）。

执行流程

  1. 接收请求与范围门槛：

    • 接收目标范围（file、directory 或 subsystem）。
    • 执行范围门槛：如果未提供明确范围，立即停止当前轮次并提示用户："Vui lòng chỉ định rõ phạm vi kiểm tra (file, thư mục hoặc subsystem) khi sử dụng /inspect-perf."
    • 阅读并以 references/performance-rubric.md 为依据。

  2. 根据规模调整的务实审计：

    • 当前轮次内执行（少于 10 个文件或属于内聚模块）：根据评估标准的各个维度直接审计代码。
    • 子 Agent 分派（范围较广的多包子系统）：启动 2–3 个 research 子 Agent（角色：Performance Inspector (<Slice>)），并提供切片坐标、已发现的锚点、领域评估标准和输出约定。
    • 执行第 1 节防护规则：忽略非热点路径上的微基准测试噪声；将每项发现明确归类为 [LOCAL-FIX] 或 [ARCHITECTURAL-REFACTOR]。

  3. 综合与轮次终止门槛：

    • 将发现汇总至规范输出约定。
    • 明确评定健康等级（OPTIMAL、LOCALIZED_BOTTLENECK、CRITICAL_DEGRADATION）。
    • 将完整审计报告呈现在对话中，并立即停止当前轮次。

评论

支持 Markdown