# Úkoly (https://docs.vitrinka.ai/cs/pm/tasks) ## Společná evidence úkolů [#engine] Úkoly jsou uložené v samostatné evidenci, kterou používají nástěnky, prohlížeč i agenti. Karta úkolu na nástěnce zobrazuje tento společný záznam a server ji průběžně aktualizuje. U úkolu je uložený jeho autor. Určuje se z přihlašovacích údajů použitých při založení — `system`, `eve`, `agent` nebo `human` — a později se nemění. **Origin** samostatně zaznamenává, kdo práci požadoval: agent zapisující požadavek člověka zachová lidský původ. Dřívější práce s neznámým původem zůstává Unknown. Změny se zapisují do historie (`task_events`), ze které se také aktualizují pohledy projektu. ## Co úkol nese [#fields] | Pole | Hodnoty | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Stav | Jeden z konfigurovatelných stavů projektu; každý stav patří do pevné skupiny: `backlog` · `unstarted` · `started` · `completed` · `cancelled`. Projekt začíná se stavy `backlog` · `todo` · `in_progress` · `in_review` · `done` · `cancelled`. | | Typ | `task` · `bug` · `story` · `epic` pro plánovanou práci; `qa` (testovací plán funkce) a `journey` (jedna uživatelská cesta pod ním); `meeting` (nahraná schůzka povýšená z deníku); `todo` (osobní připomínka, která dozraje podle podmínky). Nadřazený úkol shrnuje své podúkoly. | | Kategorie | Trvalé zařazení ve workspace, například Chyby, Funkce nebo Údržba. Správce ji může přejmenovat nebo deaktivovat; identita zůstává. | | Původ | `human` · `agent` · `system` · `unknown` — kdo práci požadoval, nezávisle na autorovi zápisu, kategorii a přijetí. | | Priorita, odhad | `urgent` · `high` · `medium` · `low`; číselný odhad | | Termíny | Začátek, konec a termín splnění | | Řešitelé | Jeden hlavní a libovolný počet dalších — lidé nebo agenti | | Štítky | Volné štítky projektu, vznikají prvním použitím, dají se vnořovat | | Pořadí | Ruční řazení nezávislé na prioritě — měníte ho tažením v seznamu, backlogu i na nástěnce; seznam a backlog se v něm čtou, pokud nezvolíte jiné řazení | | Podúkoly a vazby | Každý úkol může mít potomky; typované vazby: `blocks` · `relates` · `duplicates` · vlastní | | Vlastní pole | Typovaná pole projektu pro jeden typ úkolu nebo pro všechny, která definuje správce ([Nastavení → Projekty → Fields](/cs/pm/projects#fields), `vitrinka project fields`) a nastavují se ve vlastnostech úkolu nebo přes `vitrinka task field set`; pole typu výběr filtrují jako kterýkoli jiný aspekt | | Kroky a brány | Checklist přímo na úkolu — kroky, lidské brány čekající na jmenovanou osobu, datové brány, které se odškrtnou, když nastane jejich den, akční položky; podmínka `when` položku odškrtne sama | | Komentáře | Markdown s vlákny odpovědí; `@mention` vloží úkol do **Waiting on you** zmíněné osoby v briefu a na domovské stránce workspace a `@eve` odpoví ve vlákně | | Přílohy | Typované, verzované odkazy — nahrané sezení, screenshot, nástěnka, soubor, pull request nebo commit, běh AI, transkript, předávka, decision log, brief, finální stránka — každý s označením, zda ho agent čte hned, na požádání, nebo nikdy | | Sprint, milník | Úkol může patřit nejvýše do jednoho sprintu a k jednomu milníku | Epik popisuje konečný výsledek; pro průběžné třídění použijte kategorii. [Sprinty](/cs/pm/sprints) mají volitelná data a mohou běžet souběžně. Dokončení sprintu nejprve ukáže výslovně vybrané úkoly a cíl, než přesune nedokončenou práci. Názvy jsou v projektu jedinečné; sprinty a milníky lze přejmenovat a změnit jejich data, ale nelze je smazat. ## Uspořádání stávající práce [#organize] Vyberte existující úkoly a před potvrzením si prohlédněte změny kategorií nebo nadřazených úkolů. Náhled přesně ukáže, kterých záznamů se změna týká; souběžná úprava vyžaduje novou kontrolu. Potvrzení zachová ID úkolů, odkazy, stav i [historii](/cs/pm/history). Nedoplňuje odhadem neznámý původ ani hromadně nepřijímá návrhy z [Příjmu](/cs/pm/intake). ### Schůzky jako úkoly [#meetings] Schůzka nahraná ve vašem deníku zůstává soukromá, dokud ji nepovýšíte do projektu — přes **Promote to project…** na kartě schůzky, ze Snapu nebo příkazem `vitrinka me diary promote --project `. Vznikne úkol typu `meeting`, který nese zvuk a transkript jako přílohy, účastníky, datum a checklist rozhodnutí. S AI backendem nechá `vitrinka task meeting-notes ` Eve sepsat poznámky a rozhodnutí a navrhnout akční body jako drafty v [příjmu](/cs/pm/intake); `--board` navíc složí nástěnku schůzky. Jak ji nahrát, popisuje [váš den](/cs/use/day#meetings). ## Příjem: návrhy před úkoly [#intake] Příjem shromažďuje návrhy úkolů například z anotací, nahraných sezení a od agentů. Návrh se do běžných seznamů dostane až po přijetí; můžete ho také odmítnout nebo sloučit s existujícím úkolem. Úkoly lze zakládat i přímo. Schválení hlášení založí přijatý úkol a GitHub připojuje odkazy na pull requesty k existujícím úkolům — [příjem](/cs/pm/intake). ## Hledání práce [#finding] Stránka projektu se otevírá na Přehledu, v jehož čele je časová osa sprintů, a svá zobrazení úkolů sdružuje pod Work, Plan a Record, všechna nad jedním filtrem. Váš vlastní stůl napříč projekty je na domovské stránce Work pod tabulkou projektů — **Waiting on you** a **In flight**. Rozsah jednotlivých zobrazení a podporované textové zkratky popisují [pohledy a filtry](/cs/pm/views). Kategorie, původ a přijetí jsou nezávislé filtry; [Historie produktu](/cs/pm/history) uchovává původní důkazy. ## Automatizace [#rules] Pravidlo určuje spouštěč, podmínky a akce. Než ho zapnete, můžete ho vyzkoušet nanečisto nad nedávnou historií. Jedenáct pravidel je zapnutých od začátku: sedm běží bez AI backendu a čtyři předávají práci Eve a bez backendu zůstávají nečinná. Pravidla zapisuje a zapíná správce; číst je a zkoušet může každý člen — [pravidla](/cs/pm/rules). ## Zrcadlení trackeru [#mirror] Úkoly projektu můžete synchronizovat s Jirou. Nastavení určuje, která strana je zdrojem pravdy; při konfliktu její verze přepíše druhou a změna se zaznamená do historie. Připojení i synchronizaci spravuje administrátor — [zrcadlení Jiry](/cs/pm/mirror). ## Kde to sledujete [#dashboard] Stránka projektu ukazuje stavy úkolů, řešitele, sprinty a blížící se termíny přímo z evidence úkolů. Timeline kreslí úkoly s daty jako pruhy v okně až jednoho roku — značky měsíců, čára dneška a lomené spojnice závislostí mezi blokujícím a blokovaným úkolem; přetažením pruhu úkol přeplánujete. Karta úkolu na nástěnce ukazuje název, stav, řešitele a termín splnění; kliknutím na stav změníte přímo úkol. ## Prohlížeč a přístup pro agenty [#hands] V prohlížeči pracujete s pohledy, podrobnostmi úkolů, návrhy čekajícími na přijetí a nastavením projektu. Automatizační pravidla a synchronizaci úkolů s Jirou nastavíte přes [HTTP API](/cs/dev/api/http); dostupné nástroje pro agenty uvádí [přehled MCP](/cs/reference/mcp-tools). Z terminálu spravujete úkoly, sprinty a návrhy pomocí `vitrinka task`, `vitrinka sprint` a `vitrinka intake`.