Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

proqi-debug

/proqi-debug

Diagnozuje zgłoszoną awarię Proqi na podstawie lokalnej diagnostyki z zaczernionymi treściami, stabilnych błędów CLI i udokumentowanego modelu SQLite, także do przygotowania zgłoszenia.

Repozytorium
proqi ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 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ść35 / 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
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

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

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Diagnozuje zgłoszoną awarię Proqi na podstawie lokalnej diagnostyki z zaczernionymi treściami, stabilnych błędów CLI i udokumentowanego modelu SQLite, także do przygotowania zgłoszenia.

Oryginalny opis (EN)

Diagnose a reported Proqi failure using its content-redacted local diagnostics, stable CLI errors, and documented SQLite model. Use only when the user explicitly asks to debug Proqi or prepare a Proqi issue.

Jak działa

  1. Workflow
  2. Local files
  3. Prepare an issue
  4. Boundaries
Sekcje z nagłówków SKILL.md, w oryginale · 120 linii, 843 słów
Podgląd SKILL.md
---
name: proqi-debug
description: Diagnose a reported Proqi failure using its content-redacted local diagnostics, stable CLI errors, and documented SQLite model. Use only when the user explicitly asks to debug Proqi or prepare a Proqi issue.
---

# Proqi Debug

Diagnose one reported failure safely. Begin read-only and minimize access to
scratchpad content.

## Workflow

1. Run `proqi --version` and `proqi --json capabilities`. Require the supported
   JSON schema, `doctor` in `data.commands`, and the exact diagnostic operation
   before using it. If the installed version does not advertise a command,
   report that limitation instead of guessing. Then run the read-only health
   report `proqi --json doctor`. Preserve every doctor check ID, status, and
   remediation exactly. Doctor never repairs, migrates, initializes, or
   recreates canonical Proqi state.
2. Record the installed
   version, CLI schema version, operating system, terminal, exact invocation,
   approximate failure time, and smallest reproduction.
3. Preserve the exact stable `error.code`, `error.message`, and `error.details`
   from JSON commands. Do not strengthen an intermittent symptom into a
   confirmed defect.
4. Ask before collecting local diagnostics. In explicitly authorized unattended
   QA mode, this approval is satisfied only for diagnostics produced from the
   run's isolated QA state. Never collect from the user's normal Proqi state in
   unattended mode. Use an explicit private output path that does not already
   exist:

   ```console
   proqi diagnostics collect --output proqi-diagnostics.json
   ```

5. Review the bundle locally before quoting or attaching it. It is designed to
   omit thought text, clipboard content, session names, workspace paths, pane
   identifiers, and raw external responses, but it retains typed identifiers
   and timestamps.
6. Correlate lifecycle events, command failures, and submission transitions by
   time and typed identifier. Never infer delivery failure merely from a later
   agent readiness state.
7. Reproduce with the smallest safe test session where practical. Do not read
   unrelated sessions or copy the user's live database merely for convenience.
8. Read [references/storage.md](references/storage.md) only when the failure
   involves persistence, migrations, leases, undo history, or submissions.
   For history reports, first identify the scope: Browser history owns session
   rename, trash, and restore; Board history owns item and transformation
   operations inside one session; editor history owns exact replacements for
   one thought.
9. Classify the result as expected behavior, configuration or environment,
   unsupported integration, unconfirmed defect, confirmed defect, or security
   concern. State the evidence and any missing verification.

## Local files

Proqi uses the operating system's native application data directory. Diagnostic
segments are inside its `diagnostics` subdirectory, and the database is
`proqi.sqlite3` in the data directory.

- macOS: `~/Library/Application Support/proqi/`
- Linux: `${XDG_DATA_HOME:-~/.local/share}/proqi/`

Prefer `proqi diagnostics collect` over reading JSONL segments directly. Never
edit the live database, its `-wal` or `-shm` files, lock metadata, backups, or
diagnostic logs. Never run repair SQL against user data.

## Prepare an issue

For a confirmed non-security defect, first search existing Issues at
<https://github.com/oborchers/proqi/issues>. Then draft the exact issue title
and body in chat. Include:

- Proqi version and CLI schema version.
- Operating system and terminal.
- Minimal reproduction steps.
- Expected and observed behavior.
- Stable error code and a short content-redacted diagnostic excerpt.
- Whether the failure is reproducible and whether data was modified or lost.

Remove thought text, clipboard data, credentials, personal paths, session
names, pane identifiers, and identifiers that are not required to correlate the
failure. Do not attach the diagnostic bundle by default.

By default, obtain explicit approval of the complete issue text before running
`gh issue create`. Opening the issue is an external mutation. Report the issue
URL only after the command succeeds.

An unattended QA goal may provide advance authorization to create issues without
per-issue approval. Use that exception only when the goal explicitly names this
skill, restricts testing to an identified released binary, requires repeated
reproduction, defines a severity model, requires duplicate search, and authorizes
automatic GitHub issue creation. In that mode:

1. Create issues only for confirmed non-security defects reproduced at least
   twice on the identified released binary from isolated QA state.
2. Search open and closed issues first. Do not create a duplicate.
3. Use only existing repository labels. Do not create or edit labels, milestones,
   projects, repository settings, or releases.
4. Sanitize the complete title and body locally before creation.
5. Do not attach or upload diagnostics, logs, screenshots, databases, or other
   local evidence.
6. Create exactly one issue for each independently confirmed root defect, verify
   the created issue, and record its URL in the QA report.
7. If any prerequisite is uncertain, keep the finding local as unconfirmed or
   blocked instead of publishing it.

Never open a public issue for a suspected security vulnerability. Follow
`SECURITY.md` and use GitHub private vulnerability reporting instead. A private
security submission still requires explicit approval unless the unattended goal
separately and explicitly authorizes that exact channel.

## Boundaries

- Do not mutate SQLite or bypass Proqi's CLI, owner channel, or leases.
- Do not emulate a semantic mutation with TUI keys. Active and inactive JSON
  writes must converge through the same application owner and durable receipt.
- Do not upload logs, bundles, databases, screenshots, or thought content.
- Do not retry a submission whose durable state is `outcome_unknown`.
- Do not claim a fix or successful delivery without direct evidence.
- Do not open, comment on, or modify a GitHub issue without explicit approval,
  except for new issues created within the narrow unattended QA authorization
  above.
Pliki w paczce (3)
  • SKILL.md 6 KB
  • agents/openai.yaml 1 KB
  • references/storage.md 4 KB

Wersje

W bazie nie ma innych skilli o nazwie proqi-debug.

Migawka bazy z 13.11.2026 · wersja paczki e0536fd00861 (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

  • 100proqi
    Sprawdza lub aktualizuje jedną wskazaną przez użytkownika sesję notatnika Proqi przez JSON CLI zainstalowanej wersji, tylko po wyraźnym wywołaniu Proqi.
  • 100walkthrough
    Prowadzi krok po kroku przez implementację w worktree lub pull request, z pokazem działania terminala, gdy zachowanie jest wizualne.
  • 90debug-local-db
    Diagnozuje problemy z lokalnymi bazami danych, takimi jak PostgreSQL, SQLite czy kontenery Podman, w środowiskach tymczasowych.
  • 100debug-lumen
    Diagnozuje problemy z Lumen CLI i MCP: typowe błędy, kłopoty z SQLite, wyszukiwanie bez wyników i błędy kompilacji.
  • 96error-diagnostics-smart-debug
    Prawdopodobnie wspiera diagnozę błędów w trybie inteligentnym, na podstawie nazwy skilla.
  • 96error-diagnostics-smart-debug
    Prawdopodobnie wspiera inteligentną diagnostykę błędów i debugowanie kodu.

Uwagi i zgłoszenia

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