Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Planowanie

task-tracker

/task-tracker

Prowadzi śledzenie zadań w folderze projektu z tablicą HTML: zależności, co zostało, co gotowe i wznowienie pracy.

Repozytorium
rafal-tools ↗
Licencja
MIT
Ostatnia zmiana repozytorium
11.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
10
Skrypty
5
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.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 sprawdzić przed instalacją
  • 5 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/chain-lib.mjs, scripts/chain.mjs, scripts/chain.test.mjs, scripts/tt.mjs, scripts/tt.test.mjs

Co robi i kiedy

Prowadzi śledzenie zadań w folderze projektu z tablicą HTML: zależności, co zostało, co gotowe i wznowienie pracy.

Wyzwalacze z opisu

track this
Oryginalny opis (EN)

Task tracking per project folder with an HTML board. Use for "track this", importing plan progress, resuming work, what is left/ready, task dependencies, the board, and every request where a [task-tracker] notice is present.

Jak działa

  1. 1. One task per independent unit
  2. 2. Record progress
  3. 3. Resume cheaply
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 702 słów
Podgląd SKILL.md
---
name: task-tracker
description: Task tracking per project folder with an HTML board. Use for "track this", importing plan progress, resuming work, what is left/ready, task dependencies, the board, and every request where a [task-tracker] notice is present.
---

# Task Tracker

`tt` = `node "<this skill's base directory>/scripts/tt.mjs"`; hook notices print the exact path. Never type `tt` literally. Write only through the CLI; `tt help` lists every command. Keep token use minimal: open reference files only when their topic comes up, and never read the tracker's data files directly.

| When | Do |
|---|---|
| Invoked with no request (e.g. bare `/rafal-tools:task-tracker`) | `tt usage`, show its output unchanged in a code block, then stop |
| "track this" / "track <folder>" | `tt init [dir] [--name ".."]`. After a first init, follow `references/import.md` unless the user wants to start empty. Never init a folder the user did not mark |
| Import or re-assess plans | `references/import.md` |
| Dependencies (also across projects) | `references/dependencies.md` |
| Board location, moving it, config | `references/data-location.md` |
| "What is left?" / "what is ready?" | `tt list` / `tt list --ready` |
| Change a task's goal, title or work-done text | `tt goal <ID> ".."` / `tt rename <ID> ".."` / `tt summary <ID> ".."` |
| Stop / resume tracking · board · all projects | `tt off` / `tt on` · `tt open` · `tt projects` |
| Archive / restore tasks | `tt archive <ID>...` / `tt unarchive <ID>...`; archived tasks are hidden and never hold up dependents. Mention tasks it reports as ready |
| Role chain (Opus, Codex, Sonnet, Haiku stages) | `tt chain new "Name" ["Description"]`. `tt chain run` needs the user's confirmations, so never run it yourself: give the user the exact command for their own terminal |

No `[task-tracker]` notice: with hooks installed the folder is untracked, so do nothing. Without hooks (other agents, standalone install), run `tt resume` once per session; "not tracked" means do nothing.

## 1. One task per independent unit
- Every request that changes the project maps to at least one task. Questions and read-only turns need no tracker call.
- A plan with N tasks becomes N tasks sharing one `--group`. For more than 3, use `tt bulk <temp folder>/t.json` (scratchpad or OS temp, never the repo) with `[{"title","goal","group","next":[..],"deps":["#1"]}]`.
- A task is finishable and verifiable on its own. Split anything larger than a session.
- `--goal` holds the outcome and acceptance criteria in 1–2 sentences.
- A follow-up continues the existing task; never duplicate it.
- If a task needs another task's output, add `--dep T-004`.

## 2. Record progress
Use as few calls as possible; one per task per turn is usually enough. Unknown flags are rejected.
1. Before working: `tt start <ID>`, or for a new task `tt add "Title" --goal ".." --start`. Both refuse tasks that wait for dependencies; use `tt start --force` only if the user insists. `tt log` never changes the status; when it reminds you that a task is still todo and you are working on it, run `tt start`.
2. Before ending a turn, for every task you touched: `tt log <ID> "what was done" --next "step" [--next ".."] [--note "durable context"]`. `--next` replaces the next steps, so make them concrete (files, functions, commands). `--note` keeps decisions and gotchas.
3. Verified → `tt done <ID> --summary "what was built and where"`, then mention any tasks it reports as ready. Stuck → `tt status <ID> blocked --note "why"`.
4. The stop hook checks only turns that edited project files. If those edits were not task work → `tt skip`.

## 3. Resume cheaply
1. Use the session-start list or `tt resume`.
2. Pick, in this order: the task the user names, the first in-progress task, the first ready todo. Never pick one marked `WAITS FOR`; name its dependencies and offer to do them first.
3. Load only that task with `tt show <ID>`. It shows the last 5 log entries; use `--full` only if needed. Do not reload the original plan when the task file suffices.
4. Phrases:
   - "continue" → the first in-progress task;
   - "resume/start T-005" → `tt start` it if it is todo;
   - "T-004 is unblocked: …" → `tt log` the reason, then `tt start`.
5. Tell the user in one line which task you are resuming and its next step, then continue.
Pliki w paczce (10)
  • SKILL.md 4 KB
  • references/data-location.md 2 KB
  • references/dependencies.md 2 KB
  • references/import.md 2 KB
  • scripts/chain-lib.mjs 9 KB
  • scripts/chain.mjs 5 KB
  • scripts/chain.test.mjs 11 KB
  • scripts/tt.mjs 57 KB
  • scripts/tt.test.mjs 9 KB
  • templates/board.html 44 KB

Wersje

W bazie nie ma innych skilli o nazwie task-tracker.

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

  • 90build-tracker
    Pokazuje na żywo postęp wieloetapowej pracy na stronie HTML, z czasem zadań, zadaniami do zrobienia i szacowanym zakończeniem.
  • 95obsidian-tracker-task
    Tworzy nowe zadanie w projekcie Obsidian wraz z tablicą kanban.
  • 100agent-ticket-tracker
    Prowadzi plik TRACKER.md jako jedno miejsce dla właściciela repozytorium: co wymaga decyzji, co trwa i co zostało zrobione.
  • 100planning-and-progress-tracking
    Planuje długą pracę w folderze śledzenia: statusy zadań, zależności, decyzje, wybór modelu i wznawialne przekazania między sesjami.
  • 100harness-progress
    Generuje HTML z tablicą postępu sesji dla osób nietechnicznych: liczby zadań WIP, TODO i ukończonych, procent, czas, koszt i alerty dryfu, na podstawie Plans.md, z automatycznym odświeżaniem.
  • 100board
    Prowadzi tablicę zadań użytkownika na pulpicie: aktualizuje postęp, prośby o decyzję, blokady i zakończenia przez polecenie cstatus.

Uwagi i zgłoszenia

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