Kalokoby

Všichni průvodci › Nastavení pro tým

Nastavení pro tým

Jira, Linear, Slack a Teams: vrácené kroky tam, kde tým pracuje

Vrácený krok založíte jako úkol v Jiře nebo Linearu i se screenshotem a poznámkami, běhy propojíte s úkoly podle klíče a každý projekt bude hlásit do svého kanálu ve Slacku nebo Teams.

Kontrolující vrátí krok ve čtyři odpoledne. V pět už je poznámka zkopírovaná do Jiry, jen bez screenshotu, a vývojář se ve Slacku ptá, o kterou obrazovku šlo. Kaloko založí úkol přímo z kroku a dá vědět do správného kanálu.

Co nás pálí

Kontroluje se v jednom nástroji, plánuje v druhém a mluví ve třetím. Každým kopírováním se něco ztratí: screenshot, kritérium, jazyk, ve kterém chyba byla. Notifikace padají do jednoho rušného kanálu, kde je nikdo nečte.

Co se změní s Kalokem

Admin jednou v Nastavení → Integrace připojí Jira Cloud nebo Linear a chatovací nástroje a projekty v Kaloku přiřadí k projektům v Jiře nebo týmům v Linearu. Od té chvíle úkol vzniká z kroku a po dokončení se k němu vrátí, a každý projekt hlásí do kanálu, který jeho tým opravdu čte. Obojí je v plánu Team a vyšších.

Jak to funguje

  1. Připojte nástroj na úkoly

    admin v Nastavení → Integrace připojí Jira Cloud (OAuth nebo API token) či Linear (OAuth nebo API klíč) a každý projekt v Kaloku přiřadí k projektu a typu úkolu v Jiře, nebo k týmu v Linearu.

  2. Založte úkol z kroku

    na plachtě, v režimu kontroly nebo přes kaloko issue create --step checkout --to jira --criterion AC2. Úkol dostane screenshot, kritérium s důkazem, otevřené poznámky kontrolujících a odkaz zpět na krok.

  3. Nechte ho vrátit se

    když úkol v Jiře nebo Linearu dokončíte nebo zrušíte, komentář u kroku dostane odpověď a uzavře se; po znovuotevření se otevře i on. U Jiry admin přidá webhook, který mu Kaloko ukáže; Kaloko navíc stav kontroluje každých 30 minut.

  4. Propojte běhy podle klíče

    větev nebo název pull requestu s klíčem úkolu (feat/WEB-12-darkove-karty, u Linearu eng-42) propojí běh s úkolem a úkol při sdílení běhu dostane komentář.

  5. Vyberte kanály po projektech

    kanál ve Slacku přidáte tlačítkem *Add to Slack*, kanál v Teams přes adresu z Workflows. Každý kanál si zvolí události (nový běh, vrácení, přijetí, komentář, zmínka, zapsaný release) a tiché hodiny; zprávy, které přijdou v tichých hodinách, počkají, až skončí.

Skilly a prompty

Založ v Jiře úkol k vrácenému kroku checkout z posledního běhu TASK-123 i s neprošlým kritériem a napiš mi klíč úkolu.

Očekávaný výsledek: kaloko issue create proběhne pro ten krok jednou a agent odpoví klíčem a odkazem. Když není Jira připojená, řekne, že ji musí nastavit admin.

Vypiš otevřené úkoly z Kaloka ke scénáři checkout.

Očekávaný výsledek: kaloko issue list --scenario checkout --state open s klíči, kroky a stavy.

Co dostanete

Otázky

Potřebujeme Jiru i Linear zároveň?

Ne. Připojte ten, který používáte; CLI i plachta nabídnou jen to, co je připojené.

Kdo může úkoly zakládat?

Vývojáři a testeři, na plachtě nebo tokenem, který smí komentovat. Vieweři úkoly u kroků vidí.

Funguje dál kanál ve Slacku pro celou organizaci?

Ano. Kanály po projektech k němu přibydou.

Další průvodci

Firemní přihlášení: SAML nebo OIDC, SCIM a kontroly kolem nichAkceptace tasku s AI agentem přímo v pull requestuRegrese před releasem: porovnání běhu s přijatým referenčním během

Nainstalujte jednou, pak pracujte přes agenta

Kaloko běží tam, kde je váš kód a váš agent. Služba výsledky ukládá a verzuje, zobrazuje plachtu a sbírá schválení.

  1. Přidejte CLI do projektu
    npm install --save-dev kaloko

    Potřebuje Node 20 nebo novější. Aktualizace později přes npm update kaloko.

  2. Vytvořte konfiguraci a nainstalujte skill
    npx kaloko init --agent claude --org <your-org>

    Skill se zkopíruje do .claude/skills/kaloko. npx kaloko doctor ověří Chrome, konfiguraci a token.

  3. Založte organizaci a vytvořte token

    Založte organizaci, stanete se jejím adminem. Úvodní stránka nabídne token s rolí tester jedním kliknutím, později ho najdete v Nastavení → API tokeny. Uložte ho do .env projektu:

    KALOKO_TOKEN=qwk_…
    TYPESAFE_API_KEY=…   # optional: semantic evaluator

Pak už jen zadávejte agentovi

Skill naučí vašeho agenta celou smyčku: z úkolu napíše akceptační plán a scénář, projde obrazovky, vyhodnotí je, nasdílí plachtu, přečte si připomínky a opraví je. Příkazy psát nemusíte, vy jen projdete plachtu.

Co agent spouští (nebo spusťte sami, třeba v CI)

Stejná smyčka ručně:

npx kaloko start --scenario docs/tasks/TASK-123/qa/scenario.yml --env local
npx kaloko walk        # playwright steps; agent/manual steps: kaloko capture
npx kaloko evaluate
npx kaloko share --pr
npx kaloko feedback    # what reviewers said, with ids to answer