Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

pfb-spec-implement

/pfb-spec-implement

Wdraża funkcję według specyfikacji, wykonując zadania z pliku tasks.md po kolei i odhaczając ukończone.

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

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

Wdraża funkcję według specyfikacji, wykonując zadania z pliku tasks.md po kolei i odhaczając ukończone.

Argumenty

/pfb-spec-implement <spec folder, e.g. specs/0006-direct-osm-download>
Oryginalny opis (EN)

Implement a feature from its specification in specs/NNNN-feature-name/ by executing tasks.md in order, checking off tasks as they are completed. Use when the user asks to build or implement a spec.

Jak działa

  1. Inputs
  2. Rules
  3. Execution loop
  4. Recording findings
  5. When the spec is wrong or incomplete
  6. Finish
Sekcje z nagłówków SKILL.md, w oryginale · 93 linii, 662 słów
Podgląd SKILL.md
---
name: pfb-spec-implement
description:
  Implement a feature from its specification in specs/NNNN-feature-name/ by
  executing tasks.md in order, checking off tasks as they are completed. Use
  when the user asks to build or implement a spec.
argument-hint: "<spec folder, e.g. specs/0006-direct-osm-download>"
disable-model-invocation: true
---

# pfb-spec-implement

You are a senior software engineer implementing a feature using
Specification-Driven Development (SDLD).

## Inputs

The spec folder given as argument. If none is given, list the `specs/NNNN-*/`
folders at the root and in each workspace member (excluding cancelled `*-yanked`
ones) whose `tasks.md` has unchecked items and ask which one. Read all three
documents fully before changing any code:

- `requirements.md` is the source of truth for **behavior**.
- `design.md` is the source of truth for **architecture and constraints**.
- `tasks.md` is the source of truth for **file structure and sequencing**.

If the folder name ends with `-yanked` or it contains `yanked.md`, the feature
was cancelled: stop and tell the user.

Also read the project's `CLAUDE.md` / `AGENTS.md`, and the member's if it has
one, for conventions and the quality command (e.g. `just ci`, `cargo test`,
`npm test`). Grep the frontmatter (`title`, `tags`, `modules`) in
`specs/learnings/` (if present), in the feature's member and at the root, for
the modules you will touch, and open only the entries that match. If the folder
has a `spike.md` or a `findings.md` from earlier work, read them too.

## Rules

- Do not invent functionality not described in the requirements.
- Do not skip or reorder tasks unless strictly necessary for correctness; say so
  when you do.
- Write production-quality code: no placeholders, no TODOs, full typing where
  the language supports it, matching the surrounding code's style.
- Enforce every correctness property in `design.md`; handle the error and edge
  cases it lists (errors, permissions, partial state).
- Tests are part of each task, not an afterthought. Cover main flows and failure
  cases.
- Never write planning or spec material under `docs/`; it is the published
  documentation website. Only touch `docs/` when a task explicitly calls for
  user-facing documentation changes.
- Never modify a `specs/README.md`.
- Do not commit or push unless the user asks.

## Execution loop

For each task in `tasks.md`, in order:

1. Implement it, editing files directly.
2. Run the relevant tests.
3. Tick its checkbox (`- [ ]` to `- [x]`) in `tasks.md`.
4. At each `Checkpoint` task, run the project's full quality command and fix
   failures before continuing.

## Recording findings

Keep `findings.md` in the spec folder as the record of everything non-obvious
learned while implementing: behavior that looks like a bug unless you know it is
deliberate, library and tooling traps, and techniques that worked. It explains
why the code behaves as it does after the conversation that produced it is gone.

- Create it from `assets/findings-template.md` (in this skill) the first time
  you learn something non-obvious; do not create an empty one.
- Add an entry as soon as you learn it, without waiting to be asked: what the
  rule is (with `path:line`), how it was caught, and what it cost, using
  measured numbers where you have them.
- When a later discovery proves an entry wrong or incomplete, correct the entry
  and say what changed, rather than adding a contradicting one.
- Skip the obvious: a typo or a routine fix is not a finding.

## When the spec is wrong or incomplete

If implementing a task reveals that the spec is ambiguous, contradictory or
infeasible:

- **Behavior changes** (anything in `requirements.md`): stop and ask the user.
- **Design or task changes** needed for correctness: explain the deviation, then
  update `design.md` and `tasks.md` to reflect reality. Specs must not be left
  outdated.

## Finish

- Run the full quality command one last time and report the result honestly,
  including failures.
- Summarize: tasks completed, deviations from the spec (and where the spec was
  updated), the entries added to `findings.md`, and anything left unchecked.
- Remind the user that a reviewer should read `findings.md` and give feedback
  before merging.
- Suggest `pfb-spec-review` for a spec-compliance review.
- Tell the user that the last step, once the reviewer approves and before
  merging, is `/pfb-learning <spec folder>`: it goes through `findings.md` and
  proposes which entries to keep as learnings.
Pliki w paczce (2)
  • SKILL.md 4 KB
  • assets/findings-template.md 1 KB

Wersje

W bazie nie ma innych skilli o nazwie pfb-spec-implement.

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

  • 100pfb-spec-review
    Sprawdza implementację względem jej specyfikacji i tworzy raport z ustaleniami, macierzą pokrycia wymagań i lukami w testach.
  • 90pfb-spec-new
    Przygotowuje nową specyfikację funkcji w trzech plikach, prowadząc rozmowę zaczynającą od pytań, zanim powstanie kod.
  • 100s08-08-spec-implement
    Wdraża zadania z tasks.md po kolei, korzystając z istniejących skilli kodowania, i oznacza postęp oraz wykonane kryteria na liście.
  • 90implement
    Realizuje zaplanowaną specyfikację funkcji zadanie po zadaniu, odhaczając każde dopiero po zaliczonym sprawdzeniu.
  • 82implement-spec
    Wykonuje zadania zatwierdzonej specyfikacji test-first, po jednym zadaniu na commit, z subagentami recenzji.
  • 90feature
    Implementuje funkcję na podstawie specyfikacji lub zgłoszenia: pisze kod i testy, uruchamia sprawdzenia i zostawia drzewo do przeglądu.

Uwagi i zgłoszenia

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