debug-formatter
/debug-formatter
Pomaga znaleźć błąd w formatterze SQL, gdy ktoś zgłasza nieprawidłowe formatowanie, na przykład złe odstępy, źle umieszczone komentarze albo puste linie.
- Autor
- lalitmaganti ↗
- Repozytorium
- syntaqlite ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 27.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Pomaga znaleźć błąd w formatterze SQL, gdy ktoś zgłasza nieprawidłowe formatowanie, na przykład złe odstępy, źle umieszczone komentarze albo puste linie.
Oryginalny opis (EN)
Debug a SQL formatter bug. Use when the user reports incorrect formatting, such as wrong whitespace, misplaced comments, or blank lines.
Jak działa
- Instructions
Podgląd SKILL.md
---
name: debug-formatter
description: Debug a SQL formatter bug. Use when the user reports incorrect formatting, such as wrong whitespace, misplaced comments, or blank lines.
user_invocable: true
---
# debug-formatter
Debug a SQL formatter bug using red-green testing and pipeline tracing.
## Instructions
### 1. Reproduce (RED)
Add a failing test to `syntaqlite/tests/fmt_comments.rs` (comment bugs) or the
relevant `tests/fmt_diff_tests/*.py` file. Always `eprintln!` the actual output:
```rust
#[test]
fn descriptive_name() {
let input = "...";
let out = fmt(input);
eprintln!("=== actual ===\n{out}=== end ===");
assert_eq!(out, "...\n");
}
```
Run it and confirm RED:
```sh
cargo test -p syntaqlite --features fmt,sqlite --test fmt_comments TEST_NAME -- --nocapture
```
### 2. Trace the pipeline
Work through these layers to find the root cause:
| Layer | File | What to check |
|-------|------|---------------|
| Grammar | `syntaqlite-buildtools/parser-nodes/*.synq` | `fmt { }` block; `clause("KW", field)` expands to `IF_SET → LINE → KEYWORD → NEST(LINE, CHILD)` |
| Bytecode compiler | `syntaqlite-buildtools/src/dialect_codegen/fmt_compiler.rs` | How `Fmt::Clause`, `Fmt::Keyword` compile to opcodes |
| Interpreter | `syntaqlite/src/fmt/interpret.rs` | Main loop in `interpret_node`; state = `running` (committed doc) + `pending` (deferred line breaks) |
| Comment drain | `syntaqlite/src/fmt/comment.rs` | `drain_before(offset)` respects `has_non_comment_text` guard; `drain_keyword_interior()` skips it for multi-word keywords |
| flush_drain | `interpret.rs` | Integrates `DrainResult { trailing, leading }` into running/pending; when `leading != NIL`, pending is dropped |
| Doc renderer | `syntaqlite/src/fmt/doc.rs` | Wadler-style; `hardline` always breaks, `line` breaks if group broken |
### 3. Common bug patterns
- **Blank line between comments**: Two consecutive drains both produce `hardline + comment + hardline`; back-to-back hardlines = blank line. Fix via `continuation` flag on `drain_keyword_interior`.
- **Comment on wrong side of keyword**: `flush_drain` for interior comments runs before keyword text is emitted. Check flush vs keyword append ordering in the `Keyword` match arm.
- **Comment lost**: `has_non_comment_text` guard stops `drain_before` when a keyword sits between the comment and target offset. Multi-word interiors need `skip_text_check: true`.
- **Pending dropped**: `flush_drain` with `leading != NIL` zeroes pending. If pending held a LINE from the clause template, that break is lost.
### 4. Fix and verify (GREEN)
```sh
cargo test -p syntaqlite --features fmt,sqlite --test fmt_comments TEST_NAME -- --nocapture
cargo test -p syntaqlite --features fmt,sqlite
cargo build -p syntaqlite-cli && tools/run-integration-tests
```
All 7 integration suites must pass (including ~650 idempotency checks).
Wersje
W bazie nie ma innych skilli o nazwie debug-formatter.
Migawka bazy z 13.11.2026 · wersja paczki d357746965b6 (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
- 95sql-formatter
Formatuje kod SQL, poprawia czytelność zapytań i pracuje na plikach .sql, także w dialekcie Oracle SQL. - 100commit-message-formatter
Pomaga formatować komunikaty commitów w ramach podstaw DevOps, uruchamia się automatycznie na frazy związane z formatowaniem komunikatów commit. - 100debug-deep
Diagnozuje dogłębnie przez analizę wieloagentową i dopasowanie wzorców błędów, gdy ktoś zgłasza błąd, crash albo nieoczekiwane zachowanie. - 100formatting
Stosuje konwencje Esposter dotyczące odstępów i komentarzy w plikach: gdzie wstawiać puste linie oraz co komentarz mówi i gdzie się znajduje. - 90code-style-lint
Ustala formatter jako źródło prawdy o stylu kodu, egzekwuje go przy commitach i w CI, oddzielając lintowanie od formatowania. - 100visual-rhythm
Porządkuje odstępy w kodzie: puste linie między sekcjami, zbyt ciasne lub przesadne odstępy, traktując kod jak prozę.