timeline — скилл для Claude Code: профилирование и установка
Скилл timeline для Claude Code показывает, на каких этапах GPU-ядро тратит время. Он строит временные ряды из .ncu-rep и считает циклы по сегментам ядра.
Apache-2.0 ★ 339 обновлён 2026-11-11
~/.claude/skills/timeline/SKILL.mdЧто делает timeline
Скилл анализирует временные затраты GPU-ядра двумя способами. pm_timeline_tools.py и pm_timeline_run.py превращают данные .ncu-rep в временные ряды с пониженной частотой выборки и сводку по фазам: ramp, plateau и drain. Скрипт запускает сбор с заданными параметрами; для ядер короче 0.5 ms в примере используется --interval 2048.
timeline_probe.py измеряет циклы по сегментам и ролям, а также показывает, кто кого ожидал. Для разметки студент добавляет в ядро точную пустую функцию _seg; драйвер заменяет её на отметки %clock64 только в проверочном запуске. Эталонное ядро не инструментируется, а копия дерева должна совпадать с копией в harness. Запуск сборщика: python3 notes/pm_timeline_run.py.
Какие задачи решает
- разложить профиль
.ncu-repна временные ряды - свести время GPU-ядра по фазам ramp, plateau и drain
- посчитать циклы по сегментам и ролям ядра
- найти, кто кого ожидал во время выполнения
Примеры запросов агенту
- Разбери временные затраты этого ядра по данным
.ncu-rep. - Покажи, сколько циклов уходит на каждый сегмент и роль.
- Найди в профиле фазы ramp, plateau и drain и сравни их.
Как установить timeline
Вручную: положить файлы
~/.claude/skills/timeline/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/timeline/
Вручную: положить файлы
.agents/skills/timeline/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/timeline/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install OpenBMB/ForgeKernel skills/timeline2Вручную: положить файлы
.github/skills/timeline/SKILL.mdКомандой платформы
gemini skills install https://github.com/OpenBMB/ForgeKernel --path skills/timelineВручную: положить файлы
.devin/skills/timeline/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о timeline
Как установить timeline в Claude Code?
Создай файл с инструкциями скилла по пути ~/.claude/skills/timeline/SKILL.md. Установка для других поддерживаемых платформ использует отдельные пути или команды.
Что делает timeline?
Он строит временные ряды и сводку фаз из .ncu-rep, а также измеряет циклы по размеченным сегментам GPU-ядра и показывает ожидания между ролями.
Как timeline измеряет время отдельных сегментов?
В ядро добавляют точную пустую функцию _seg. Драйвер заменяет её на отметки %clock64 только в проверочном запуске; эталонное ядро остаётся без инструментирования.
Исходный текст
SKILL.md · Apache-2.0
# timeline
When the time leaks, which the per-instruction ledger cannot say (it sums every phase that
touches the same instructions).
- `pm_timeline_tools.py` + `pm_timeline_run.py` -- the PM-sampling timeseries of a
`.ncu-rep` as downsampled per-series timelines and a phase summary (ramp, plateau,
drain), between `=== PM TIMELINE BEGIN ===` / `=== PM TIMELINE END ===`, ending in
`PMTL-OK` or `PMTL-FAIL`. The run script freezes the collection recipe (sampling interval,
launch count, profiling window): `python3 notes/pm_timeline_run.py`, `--interval 2048`
for kernels under 0.5 ms.
- `timeline_probe.py` -- a per-segment clock account of the student's kernel on the GPU.
The student places markers, no-ops in the shipped kernel:
```python
def _seg(site, row=0): # keep this exact no-op definition
return None
```
and the driver rewrites them into `%clock64` stamps in the probe only, then prints cycles
per segment and per role and who waited on whom. The reference is never instrumented.
The tree's copy must equal the harness copy; the driver says so when it does not.
© OpenBMB · Apache-2.0 · OpenBMB/ForgeKernel