# Kernoscope

> 在拿不到硬件性能计数器的受限/多租户 GPU 上，为 CUDA kernel 优化提供「每个数字都标注出处」的性能证据；CLI 与 ncu 兼容，缺依赖时优雅降级并给出下一步。

## 改这个仓库（贡献者 agent）

- [AGENTS.md](AGENTS.md): 开发入口与硬规则（≤40 行，先读这个）
- [CONTRIBUTING.md](CONTRIBUTING.md): 首屏是索引表：改哪类东西 → 改哪个文件 → 跑哪条门禁
- [tools/dev_index.py](tools/dev_index.py): 索引的单一真源；`--brief` 短版、`--gates` 提交前全跑

## 用这个工具分析 kernel（优化 agent）

- [skills/kernoscope/SKILL.md](skills/kernoscope/SKILL.md): 触发条件、硬规则、闭环脚本（先读这个）
- [COVERAGE.md](COVERAGE.md): 三态覆盖矩阵与能力分层

## 人读

- [README.md](README.md): 首屏定位与局限
- [PROVENANCE.md](PROVENANCE.md): 出处体系（exact/measured/estimated/…）
- [CALIBRATION.md](CALIBRATION.md): 本机峰值标定
- [CHANGELOG.md](CHANGELOG.md): 接口层变化

## Optional

- [bench/artifacts/README.md](bench/artifacts/README.md): 真机产物登记表
