Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

issue-writer

/issue-writer

Zamienia luźne zgłoszenie błędu, pomysł lub skargę w użyteczne zgłoszenie, najpierw badając kod pod kątem kroków odtworzenia, oczekiwanego i faktycznego zachowania, lokalizacji i kryteriów akceptacji.

Repozytorium
dotclaude ↗
Licencja
MIT
Ostatnia zmiana repozytorium
25.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.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

Zamienia luźne zgłoszenie błędu, pomysł lub skargę w użyteczne zgłoszenie, najpierw badając kod pod kątem kroków odtworzenia, oczekiwanego i faktycznego zachowania, lokalizacji i kryteriów akceptacji.

Oryginalny opis (EN)

Turn a rough bug report, idea, or complaint into an actionable issue by investigating the codebase first for reproduction steps, expected vs actual behaviour, suspected location, and acceptance criteria, then filing it with gh or emitting paste-ready markdown. Use when asked to file or write up an issue, or when a bug mentioned in passing should be tracked.

Jak działa

  1. Step 1: Extract and classify
  2. Step 2: Investigate before writing
  3. Step 3: Write it
  4. Step 4: File or hand over
Sekcje z nagłówków SKILL.md, w oryginale · 54 linii, 573 słów
Podgląd SKILL.md
---
name: issue-writer
description: Turn a rough bug report, idea, or complaint into an actionable issue by investigating the codebase first for reproduction steps, expected vs actual behaviour, suspected location, and acceptance criteria, then filing it with gh or emitting paste-ready markdown. Use when asked to file or write up an issue, or when a bug mentioned in passing should be tracked.
---

An issue is a work order for someone with none of this conversation's context. Write it so that a developer who picks it up cold can reproduce the problem, knows when they are done, and starts in the right file - and do the investigating now, while the context exists, rather than leaving it to them. A two-minute look at the code turns "the export is broken" into an issue with a suspected cause and a pointer.

## Step 1: Extract and classify

From the user's description (and the current conversation - the bug being discussed right now is usually the subject), pin down:

- **Type:** bug, feature request, or task/chore. This decides the template below.
- **The one-sentence problem.** If you cannot state it in one sentence, you do not understand it yet; ask the one or two questions that resolve it. Do not interrogate - two questions maximum, then write with what you have and mark the gaps.
- **Severity signals** for bugs: data loss, wrong results, crash, cosmetic? Who hits it and how often?

## Step 2: Investigate before writing

Spend a short, bounded pass in the repo making the issue concrete:

- **Bugs:** find the code path involved (`grep` the error message, the feature name, the route). Note the suspected file/function. If reproduction is cheap - a failing command, a curl, a unit test - actually run it and record the real output. Check `git log` on the suspect file for a recent change that correlates.
- **Features:** find where the change would land, what patterns exist to follow, and any related prior art (an existing similar feature, an old TODO, a closed issue).
- **Duplicates:** when `gh` is available, search first - `gh issue list --search "<keywords>" --state all --limit 10`. A duplicate found now saves a triage round-trip; link it instead of filing twice.

Everything found goes in the issue as fact ("reproduced on `main` at `abc1234`, output below"), everything guessed goes in clearly marked as hypothesis ("possibly introduced by #118 - unverified").

## Step 3: Write it

**Title:** specific and searchable - symptom plus context, under ~70 chars. "CSV export drops rows with embedded newlines", not "Export broken".

**Bug body:**

```markdown
## Summary
<one sentence: who hits what, under which conditions>

## Reproduction
1. <exact steps, commands, or failing test - copy-pasteable>

**Expected:** <what should happen>
**Actual:** <what happens - real output/stack trace in a collapsed block if long>

## Environment
<version/commit, OS/browser/runtime - only the ones that matter>

## Notes
<suspected location (file:line), correlated change, workaround if any - hypotheses labelled as such>
```

**Feature body:** Problem (the need, not the solution), Proposed solution (concrete but open to alternatives), Acceptance criteria (checkboxes a reviewer can verify), Out of scope (the line that stops creep).

Respect the repository's own conventions: if `.github/ISSUE_TEMPLATE/` exists, fit its structure and answer its fields; reuse the labels the repo actually has (`gh label list`) instead of inventing new ones.

## Step 4: File or hand over

With `gh` and a confirmed target repo: show the final title and body, then file with `gh issue create --title ... --body ...` plus appropriate labels, and report the URL. Filing is outward-facing - show before sending unless the user already said to file directly.

Without `gh` or when the tracker is elsewhere (Jira, Linear): emit the finished markdown in a code block, ready to paste, with the labels/priority suggestion noted at the top.

Wersje

RepozytoriumWynikLicencja
Ta strona · khaledsaeed18/dotclaude100MIT
hinyc/armory90MIT

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

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

  • 100create-bug
    Zakłada dobrze sformatowane zgłoszenie błędu z kroków odtworzenia, oczekiwanego i faktycznego zachowania, środowiska i logów, zapisując je przez CLI ticketów.
  • 100bug-report
    Zamienia mglistą skargę, zrzut ekranu lub wątek w czytelny raport błędu z krokami odtworzenia i oczekiwanym wynikiem.
  • 100file-issue
    Przepisuje opis błędu lub pomysł na uporządkowane zgłoszenie GitHub do World of ClaudeCraft, z zrzutem ekranu tylko dla UI.
  • 90propose-issue
    Zamienia zgłoszony defekt w śledzony issue z opisem, kroków i oczekiwanego wyniku, bez naprawiania błędu.
  • 100create-bug-report
    Tworzy uporządkowane zgłoszenie błędu z poprawnymi krokami reprodukcji, gdy trzeba opisać defekt lub założyć issue.
  • 100gh-issue
    Zamienia skargę lub prośbę w poprawne zgłoszenie GitHub: sprawdza duplikaty, wypełnia szablon repozytorium i zakłada je przez gh.

Uwagi i zgłoszenia

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