fizzy_account

Получает, задаёт или перечисляет аккаунты для API-вызовов. Управляет сессионным значением по умолчанию, чтобы не нужно было передавать `account_slug` при каждом вызове инструмента. **Когда использовать:** - Вывести список доступных аккаунтов, чтобы узнать, к чему у вас есть доступ - Установить рабочий аккаунт после получения списка - Проверить текущее значение по умолчанию перед операциями **Не используйте, когда:** нужно работать одновременно с несколькими аккаунтами — вместо этого передавайте `account_slug` явно. **Аргументы:** - `action` (обязательный): «get» — проверить текущее значение по умолчанию, «set» — изменить его, «list» — вывести список доступных аккаунтов - `account_slug` (обязателен для set): идентификатор аккаунта (например, «897362094») **Возвращает:** - get: `{ "action": "get", "account_slug": "897362094" }` или `null`, если не установлен - set: `{ "action": "set", "account_slug": "897362094" }` - list: `{ "action": "list", "accounts": [{ "slug": "...", "name": "...", "id": "..." }] }` **Связано:** Большинство инструментов автоматически определяют аккаунт через переменную окружения FIZZY_ACCOUNT или автоопределение единственного аккаунта.

Параметры

actionenumобязательный
Action: get | set | list. Use 'get' to check current, 'set' to change, 'list' to see available.
getsetlist
account_slugstring
Account slug (required for set action).

fizzy_boards

Выводит список досок в аккаунте с сводками по колонкам. Даёт обзор досок и их структуры колонок, включая количество карточек. **Когда использовать:** - Узнать идентификаторы досок и колонок для последующих операций - Посмотреть количество карточек по колонкам на всех досках - Найти нужную доску или колонку, чтобы создавать карточки или распределять **Соглашения о колонках Fizzy:** У каждой доски есть три неявные колонки, которые не возвращаются в массиве columns: - **Maybe?** (входящие): Нераспределённые карточки. У карточек здесь нет `column_id`. Новые карточки начинают тут. - **Not Now**: Отложенные карточки. Перемещаются сюда через `status: "not_now"` в `fizzy_task`. - **Done**: Закрытые карточки. Перемещаются сюда через `status: "closed"` в `fizzy_task`. Массив `columns` содержит только пользовательские рабочие колонки (например, "In Progress", "Backlog"). Чтобы переместить карточку из колонки обратно в Maybe?, используйте `fizzy_task` без `column_id` и без изменения статуса. **Аргументы:** - `account_slug` (необязательно): Использует сессионное значение по умолчанию, если опущен - `limit` (необязательно): Максимум элементов для возврата, 1-100 (по умолчанию 25) - `cursor` (необязательно): Курсор продолжения из предыдущего ответа **Возвращает:** JSON с элементами и метаданными пагинации. ```json {"items": [{"id": "board_1", "name": "Project", "columns": [{"id": "col_1", "name": "Backlog"}]}], "pagination": {...}} ``` **Связано:** Используйте идентификатор доски с `fizzy_task` для создания карточек. Используйте идентификаторы колонок для распределения.

Параметры

account_slugstring
Account slug. Uses session default if omitted.
limitinteger
Max items to return (1-100, default: 25).
cursorstring
Continuation cursor from previous response. Omit to start fresh.

fizzy_comment

Управляет комментариями на карточке: создаёт, выводит список, обновляет или удаляет. **Действия:** - `create` (по умолчанию): Публикует новый комментарий - `list`: Получает все комментарии на карточке - `update`: Редактирует существующий комментарий (требует `comment_id` + `body`) - `delete`: Удаляет комментарий (требует `comment_id`) **Аргументы:** - `action` (необязательно): "create" | "list" | "update" | "delete" (по умолчанию: "create") - `account_slug` (необязательно): Использует сессию по умолчанию, если не указан - `card_number` (обязательно): Номер карточки - `comment_id` (необязательно): Требуется для update/delete - `body` (необязательно): Текст комментария в Markdown. Требуется для create/update **Возвращает:** JSON с деталями комментария, списком комментариев или подтверждением удаления.

Параметры

actionenum
Action to perform.
createlistupdatedelete
account_slugstring
Account slug. Uses default if omitted.
card_numbernumberобязательный
Card number.
comment_idstring
Comment ID. Required for update/delete.
bodystring
Comment body in markdown (1-10000 chars). Required for create/update.

fizzy_get_card

Получает полные данные карточки по её номеру или ID. Извлекает все данные карточки: описание, количество шагов и метаданные. **Когда использовать:** - Нужно получить полное описание или метаданные для конкретной карточки - Проверить статус выполнения шагов или просмотреть все теги/исполнители **Не используйте, когда:** Просматриваете несколько карточек — сначала используйте `fizzy_search`. **Аргументы:** - `account_slug` (необязательный): использует значение из сессии по умолчанию, если не указан - `card_number` (рекомендуется): читаемый номер `#` из URL-адресов/списков (например, 42) - `card_id` (альтернатива): UUID из ответов API. По возможности используйте `card_number`. **ВАЖНО:** Укажите `card_number` (целое число) ИЛИ `card_id` (строка UUID), но не оба. `card_number` - это `#`, видимый в интерфейсе (например, #42). `card_id` - внутренний UUID. **Возвращает:** JSON с id, number, title, description (markdown), status, board_id, column_id, tags (массив), assignees (массив), steps_count, completed_steps_count, comments_count, url, created_at, updated_at, closed_at (null, если открыта). Пример: `{"id": "card_abc", "number": 42, "title": "Fix bug", "status": "open", "steps_count": 3, ...}` **Связанные инструменты:** Используйте `fizzy_comment` или `fizzy_step` для более глубокого взаимодействия.

Параметры

account_slugstring
Account slug (e.g., 'acme-corp'). Uses session default if omitted.
card_numbernumber
Card number - the human-readable # from URLs/UI (e.g., 42). Preferred over card_id.
card_idstring
Card UUID from API responses. Use card_number instead when you have the # visible in the UI.

fizzy_search

Поиск карточек с фильтрами. Находит карточки по критериям или просматривает содержимое доски. **Когда использовать:** - Поиск карточек по тегу, исполнителю или доске - Фильтрация по категории индекса (closed, stalled, golden и т.д.) **Не используйте, если:** номер карты уже известен - используйте `fizzy_get_card`. **Аргументы:** - `account_slug` (опционально): использует сессионное значение по умолчанию, если не указан - `board_id` (опционально): фильтр по карточкам на этой доске - `indexed_by` (опционально): фильтр по категории индекса: closed | not_now | all | stalled | postponing_soon | golden - `tag_ids` (опционально): фильтр по карточкам, у которых есть ВСЕ эти идентификаторы тегов - `assignee_ids` (опционально): фильтр по карточкам, назначенным на ЛЮБОГО из этих пользователей - `sorted_by` (опционально): сортировка: newest | oldest | recently_active - `terms` (опционально): поисковые запросы для фильтрации карточек по текстовому содержимому - `limit` (опционально): максимум элементов, 1-100 (по умолчанию 25) - `cursor` (опционально): курсор продолжения из предыдущего ответа **Возвращает:** JSON с элементами и метаданными пагинации. ```json {"items": [{"number": 42, "title": "...", ...}], "pagination": {"returned": 25, "has_more": true, "next_cursor": "..."}} ``` **Связанное:** Используйте номер карты с `fizzy_get_card` для получения полной информации.

Параметры

account_slugstring
Account slug (e.g., 'acme-corp'). Uses session default if omitted.
board_idstring
Filter to cards on this board ID.
indexed_byenum
Filter by index category: closed | not_now | all | stalled | postponing_soon | golden.
closednot_nowallstalledpostponing_soongolden
tag_idsstring[]
Filter to cards with ALL these tag IDs.
assignee_idsstring[]
Filter to cards assigned to ANY of these user IDs.
sorted_byenum
Sort order: newest | oldest | recently_active.
newestoldestrecently_active
termsstring[]
Search terms to filter cards by text content.
creator_idsstring[]
Filter to cards created by these user IDs.
closer_idsstring[]
Filter to cards closed by these user IDs.
card_idsstring[]
Filter to specific card IDs.
assignment_statusenum
Filter by assignment status: unassigned.
unassigned
creationenum
Filter by creation date range: today | yesterday | thisweek | thismonth | last7 | last14 | last30.
todayyesterdaythisweekthismonthlast7last14last30
closureenum
Filter by closure date range: today | yesterday | thisweek | thismonth | last7 | last14 | last30.
todayyesterdaythisweekthismonthlast7last14last30
limitinteger
Max items to return (1-100, default: 25).
cursorstring
Continuation cursor from previous response. Omit to start fresh.

fizzy_step

Создаёт, завершает, обновляет, отменяет завершение или удаляет шаг на карточке. **Определение режима:** - `step` отсутствует → CREATE (требует `content`) - `step` присутствует, других параметров нет → COMPLETE (действие по умолчанию) - `step` + `content` → UPDATE content - `step` + `completed: false` → UNCOMPLETE - `step` + `delete: true` → DELETE **Аргументы:** - `account_slug` (необязательный): использует значение сессии по умолчанию, если не указан - `card_number` (обязательный): номер карточки, содержащей шаг - `step` (необязательный): подстрока содержимого для поиска ИЛИ индекс (начиная с 1) для идентификации существующего шага - `content` (необязательный): текст шага для создания или обновления - `completed` (необязательный): задаёт состояние завершённости (true или false) - `delete` (необязательный): удаляет шаг **Возвращает:** JSON со статусами `id`, `content`, `completed` шага. **Примеры:** - Создание: `{card_number: 42, content: "Write tests"}` - Завершение: `{card_number: 42, step: "Write tests"}` - Отмена завершения: `{card_number: 42, step: 1, completed: false}` - Обновление: `{card_number: 42, step: 1, content: "Write unit tests"}` - Удаление: `{card_number: 42, step: "Write tests", delete: true}`

Параметры

account_slugstring
Account slug. Uses default if omitted.
card_numbernumberобязательный
Card number containing the step.
stepany
Step to act on: content substring or 1-based index. Omit to create.
contentstring
Step text for create or update.
completedboolean
Set completion state.
deleteboolean
Delete the step.

fizzy_task

Создаёт или обновляет карточку с полным контролем над статусом, тегами, шагами и размещением в колонке. **Определение режима:** - `card_number` отсутствует → режим СОЗДАНИЯ (требует `board_id` + `title`) - `card_number` присутствует → режим ОБНОВЛЕНИЯ **Режим создания:** Создаёт карточку, затем по мере возможности: добавляет шаги, переключает теги, направляет в колонку. **Режим обновления:** Обновляет заголовок/описание, если переданы. Меняет статус (open/closed/not_now). Управляет тегами — добавляет или удаляет. Перемещает карточку в колонку (из входящих или другой колонки). Перемещения в ту же колонку пропускаются. **Соглашения о колонках Fizzy:** - **Maybe?** (входящие): Карточки без `column_id`. Сюда попадают новые карточки. - **Not Now**: Установите `status: "not_now"`, чтобы переместить сюда (откладывает карточку). - **Done**: Установите `status: "closed"`, чтобы переместить сюда (завершает карточку). - **Пользовательские колонки**: Используйте `column_id` из `fizzy_boards`, чтобы направлять в колонки рабочего процесса. **Аргументы:** - `account_slug` (опционально): Использует значение по умолчанию из сессии, если опущен. - `card_number` (опционально): Номер карточки для обновления. Опустите, чтобы создать новую. - `board_id` (опционально): ID доски. Обязателен для режима создания. - `title` (опционально): Заголовок карточки. Обязателен для режима создания. - `description` (опционально): Тело карточки в Markdown. - `status` (опционально): open | closed | not_now — изменяет состояние жизненного цикла карточки. - `column_id` (опционально): Перемещает карточку в эту колонку (работает из входящих или других колонок; пропускается, если уже там). - `position` (опционально): top | bottom (по умолчанию: bottom) — позиция в колонке. - `add_tags` (опционально): Названия тегов для добавления. - `remove_tags` (опционально): Названия тегов для удаления. - `steps` (опционально): Элементы списка задач для создания (только в режиме создания). **Возвращает:** JSON с полями `mode`, `card` (id, number, title, url, status), сводка `operations`, массив `failures`. **Примеры:** Создание: `{board_id: "...", title: "New task", steps: ["Step 1", "Step 2"]}` Обновление: `{card_number: 42, status: "closed", add_tags: ["done"]}`