# humbleagents

![humbleagents](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/assets/humble-agents-hero.png)

[English](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/README.md) · [Русский](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/README.ru.md) · [Čeština](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/README.cs.md) · [Français](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/README.fr.md)

Plugin pro navrhování rozhraní v Claude Code a Codexu. Proměňte zadání v návrhy obrazovek: vyzkoušejte různé přístupy, sestavte design systém, vytvořte prototypy a zhodnoťte výsledek. K dispozici také pro Gemini CLI a Cursor.

## Instalace

Potřebujete Node.js 20 nebo 22 a npm 10.

```sh
npm install --global @humbleteam/humbleagents@next --ignore-scripts
```

Vytvořte složku pro plugin a níže nahraďte `/path/to/humbleagents` její úplnou cestou. Vyberte aplikace, které používáte:

```sh
humbleagents install --location "/path/to/humbleagents" --profile core --runtime claude,codex --yes
```

**Claude Code**

```sh
claude --plugin-dir "/path/to/humbleagents/runtimes/claude"
```

**Codex CLI**

```sh
codex plugin marketplace add "/path/to/humbleagents"
codex plugin add humbleagents@humbleagents-local
```

Zahajte novou relaci ve svém projektu. Pokud v nabídce příkazů Codexu chybí `/humble:*`, vyberte dovednost **humble** a napište příkaz.

Postup pro Gemini CLI, Cursor a instalaci ze zdrojového kódu najdete v [návodu k instalaci](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/hosts-and-updates.md).

## Co můžete dělat

- **Začít projekt.** Z poznámek a zadání sestavte požadavky a určete směr návrhu.
- **Navrhnout funkci.** Vyzkoušejte různá rozvržení, definujte komponenty a vytvořte funkční prototyp.
- **Zkontrolovat návrh.** Před předáním ověřte obrazovky a průchody rozhraním.
- **Vytvořit reklamní návrhy.** Rozpracujte koncepty, vygenerujte varianty a porovnejte je.

Agenti pracují se společnými referenčními materiály k designu a se zadáním, rozhodnutími a design systémem vašeho projektu.

## Příkazy

| Příkaz | Co dělá |
| --- | --- |
| `/humble:setup` | Připraví zadání a určí směr návrhu |
| `/humble:canvas` | Prozkoumá různé přístupy k návrhu |
| `/humble:design-system` | Definuje styly, tokeny a komponenty |
| `/humble:product` | Vytvoří obrazovky a průchody produktem |
| `/humble:review` | Zhodnotí rozhraní |
| `/humble:references` | Najde referenční návrhy |
| `/humble:ads` | Vytvoří a posoudí reklamní návrhy |
| `/humble:improve` | Navrhne vylepšení sdílených znalostí |
| `/humble:create` | Naplánuje projekt podle týmové šablony |
| `/humble:access` | Ověří váš přístup k projektu |
| `/humble:agents` | Zobrazí dostupné pracovní postupy |
| `/humble:doctor` | Zkontroluje instalaci a připojení |
| `/humble:help` | Zobrazí nápovědu |

## Příklady

Pro [připojený projekt](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/project-workspaces.md) s názvem `bookshop`:

```text
/humble:setup project=bookshop -- Zpracuj zadání do požadavků pro internetové knihkupectví.
/humble:design-system project=bookshop -- Definuj typografii, barvy a opakovaně použitelné komponenty.
/humble:product project=bookshop -- Vytvoř proces dokončení objednávky s využitím design systému projektu.
/humble:review project=bookshop -- Zhodnoť proces dokončení objednávky a navrhni opravy hlavních problémů s použitelností.
```

Popište požadovaný výsledek a přiložte související soubory, obrazovky nebo odkazy.

## Další informace

- **Projekty:** každý projekt má vlastní repozitář na GitHubu. Instalace veřejného pluginu neuděluje přístup k soukromým projektům ani oprávnění vytvářet repozitáře v organizaci týmu. [Připojení projektu a synchronizace kontextu](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/project-workspaces.md).
- **Připojení:** Gmail a Granola lze používat přes připojení MCP ve vaší aplikaci. Volitelně můžete připojit také Figmu a Mobbin. [Nastavení připojení](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/project-workspaces.md).
- **Aktualizace:** [aktualizace, návrat k předchozí verzi nebo změna instalace](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/hosts-and-updates.md). Před aktualizací dokončete rozpracovaný úkol.
- **Řešení problémů:** spusťte `/humble:doctor`. Viz [podporovaná prostředí a známá omezení](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/verification.md).

## Odinstalace

Pokud jste Claude Code nastavili podle postupu výše, spusťte jej bez `--plugin-dir`.

Pro Codex:

```sh
codex plugin remove humbleagents@humbleagents-local
```

Poté odstraňte nainstalované soubory a CLI:

```sh
humbleagents uninstall --location "/path/to/humbleagents" --yes
npm uninstall --global @humbleteam/humbleagents
```

Data projektů se ukládají odděleně od pluginu. [Podrobnosti o odinstalaci](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/hosts-and-updates.md#uninstall).

## Jak přispět

Založte issue nebo pošlete pull request s konkrétní změnou. Změny sdílených znalostí o designu navrhujte přes `/humble:improve`. Do příspěvků nezahrnujte data klientů ani přístupové údaje.

Při změnách kódu nainstalujte závislosti a spusťte testy:

```sh
npm ci --prefix platform --ignore-scripts
npm test --prefix platform
```

[Pokyny pro vývoj a vydávání verzí](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/publication.md) · [Informace o součástech třetích stran](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/THIRD_PARTY_NOTICES.md)