Przejdź do treści
Biblioteka skilli
Nauka i badania · Konwersja i formaty

port-finding

/port-finding

Zamienia wynik pomiaru z repozytorium TPU w sekcję notatnika, która mierzy wynik ponownie na czipie czytelnika.

Repozytorium
jax-dev ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
04.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 04.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Zamienia wynik pomiaru z repozytorium TPU w sekcję notatnika, która mierzy wynik ponownie na czipie czytelnika.

Oryginalny opis (EN)

Turn a measured finding from the ~/tpu-jax source rigs into a notebook section that re-measures on the reader's own chip. Use when writing notebook content from a REPORT.md result or a test in the source repo.

Jak działa

  1. 1. Find the primary source
  2. 2. Write the section into src/<stem>.py
  3. 3. Build and verify
Sekcje z nagłówków SKILL.md, w oryginale · 49 linii, 407 słów
Podgląd SKILL.md
---
name: port-finding
description: Turn a measured finding from the ~/tpu-jax source rigs into a notebook section that re-measures on the reader's own chip. Use when writing notebook content from a REPORT.md result or a test in the source repo.
---

Port a finding from `~/tpu-jax` into a notebook section. `$ARGUMENTS` names the finding (e.g.
"buffer donation", "int8 KV capacity") or a source file.

The rule this exists to enforce: **the notebook re-measures, it does not quote.** A reader on a v5e-1
must see their own number, not a v6e-1 number asserted at them.

## 1. Find the primary source

Locate the finding in `~/tpu-jax`. Findings have two halves and you usually need both:

- **The test** under `tests/` — proves correctness, and is the honest basis for the notebook's
  assertion cell (e.g. `test_donation.py`, `test_kv_cache_parity.py`, `test_quantized_kv.py`).
- **The report** under `benchmarks/runs/*/REPORT.md` — carries the measured number, the conditions it
  was measured under, and sometimes a correction that walked an earlier number back.

Read the surrounding section, not just the line with the number. Check
`2026-07-29-kv-quant-v6e1/REPORT.md` under "Corrections to earlier reporting" before citing any
capacity figure — several were withdrawn.

Do not cite `~/tpu-jax-{v5e1-2b,v6e1-2b,4b,12b,26b,31b,inf2}`; they are near-identical forks.

## 2. Write the section into `src/<stem>.py`

Structure each ported finding as:

1. **A markdown cell** stating what is being measured and why it matters, citing the source
   (`SOURCE: tests/test_donation.py and kv-quant REPORT section 1`).
2. **A code cell that measures it** on the live runtime. Keep it small enough to read. Use
   `jax.block_until_ready` around timed regions and report a median over several runs, not one sample.
   For memory claims read `jax.local_devices()[0].memory_stats()`.
3. **An assertion or comparison** derived from the test half — the thing that would catch a wrong
   answer, not just a slow one.
4. **A markdown cell interpreting the reader's result**, which states the source measurement as
   context and explicitly says the reader's number will differ by chip.

Never write the source number as the output of a cell. If a claim genuinely cannot be re-measured in
Colab (the perplexity study, the HTTP concurrency table), cite it as a reported result with its
conditions and say why it is not reproduced here.

## 3. Build and verify

`make build`, then `make check`. Then `make verify` to run it on a real TPU — this is the step that
catches a cell that raises, which reading the markdown never will. Consider `make verify-v5e1` too if
the section makes any capacity or memory claim, since that is where they break.

Report the number the run actually produced against the number the source reported. If they disagree
by more than the chip difference explains, say so rather than smoothing it over.

Wersje

W bazie nie ma innych skilli o nazwie port-finding.

Migawka bazy z 13.11.2026 · wersja paczki 205e605986ac (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 95new-notebook
    Tworzy nowy notatnik w repozytorium serii JAX na TPU i rejestruje go w pliku konfiguracyjnym.
  • 100lab-notebook
    Opisuje układ katalogów i formaty dla badań: STUDY.md, NOTEBOOK.md, sondy, wyniki i panel studium.
  • 100tpu-systolic-arrays
    Wyjaśnia architekturę TPU i przekłada ją na zasady pisania szybkiego kodu JAX i PyTorch-XLA: kształty, typy i jądra Pallas.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.