mcpField
I
inspect-perf

inspect-perf

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

关于 inspect-perf

inspect-perf 是针对指定文件、目录或子系统的性能审计技能，帮助开发者发现算法结构、I/O 和资源保留方面的风险，并区分局部修复与架构性处理。

主要功能

  1. 01要求明确指定审查范围
  2. 02依据性能标准并忽略微优化噪声
  3. 03检查算法、I/O 倍增和资源保留
  4. 04将问题区分为 [LOCAL-FIX] 或 [ARCHITECTURAL-REFACTOR]
  5. 05生成性能审计报告

适用场景

  1. 01审查指定文件或模块的性能风险
  2. 02区分局部优化与系统性处理
  3. 03检查子系统中的 I/O 或资源保留问题

安装

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

$npx skills add https://github.com/venhdev/zenforge --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]（系统性结构整改）：将笛卡尔连接拆分为 Split Queries / DataLoaders、提取 Transactional Outbox 以将网络 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）。
  • 改变结果语义，或系统性拆分查询、outbox、连接池或线程池的重构 →（经由 /changeset）。

执行协议

  1. 接收请求与范围关卡：

    • 接收目标范围（file、directory 或 subsystem）。
    • 强制执行范围关卡：若未提供明确范围，立即结束本轮并提示用户："Please specify an explicit target scope (file, directory, or subsystem) when invoking /inspect-perf."
    • 阅读并依据 references/performance-rubric.md 进行分析。

  2. 适配规模的实用审计：

    • 本轮内执行（少于 10 个文件或属于一个紧密关联的模块）：依据评估标准直接在本轮审计代码。
    • 子 Agent 扇出（范围广的多包子系统）：根据划分的切片或调用方声明的预算，动态扩展并发 research 子 Agent（角色：Performance Inspector (<Slice>)），并提供切片坐标、已发现的锚点、领域评估标准和输出约定（将详尽的性能分析跟踪结果写入 .agents/scratch/perf-<slice>-dossier.md）。
    • 执行第 1 节防护规则：忽略非热点路径上的微基准测试噪声；将每项发现明确归类为 [LOCAL-FIX] 或 [ARCHITECTURAL-REFACTOR]。

  3. 综合与本轮结束关卡：

    • 将发现汇总至规范输出约定，并附上任何外置档案的指针。
    • 给出明确的健康评级（OPTIMAL、LOCALIZED_BOTTLENECK、CRITICAL_DEGRADATION）。
    • 将完整档案呈现到对话流中，并立即结束本轮。

评论

支持 Markdown