---
name: trello-integration-skill
description: Этот навык позволяет работать с учётной записью Trello: получать списки досок и колонок и автоматически создавать карточки.
---

# Навык интеграции с Trello

Навык интеграции с Trello связывает ИИ-агента с учётной записью Trello пользователя. Агент может самостоятельно получать существующие доски и списки и создавать карточки задач в выбранных колонках по запросу пользователя.

## Возможности
- **Получение досок:** список всех доступных пользователю досок Trello с названием, ID и URL.
- **Получение списков:** все списки выбранной доски (например, колонки «Сделать», «В работе», «Готово»).
- **Создание карточек:** автоматическое создание карточек с заголовком и описанием в указанных списках.

---

## Настройка и предварительные условия

Для локального использования навыка нужны учётные данные Trello Developer API.

1. Создай учётные данные на [портале разработчиков Trello (Power-Ups Admin)](https://trello.com/app-key).
2. Создай ключ API.
3. Сгенерируй секретный токен с доступом на чтение и запись.
4. Добавь эти значения в корневой файл проекта `.env`:

```env
# Trello Integration
TRELLO_API_KEY=your_api_key_here
TRELLO_TOKEN=your_token_here
```

---

## Использование и устройство

Навык использует автономные скрипты Node.js из каталога `.agent/skills/trello_skill/scripts/`.

### 1. Получить все доски
Получи все доски пользователя, прошедшего аутентификацию, чтобы выбрать нужный `boardId`.

**Команда:**
```bash
node .agent/skills/trello_skill/scripts/list_boards.js
```

### 2. Получить колонки (списки) доски
Получи списки нужной доски, чтобы найти точный `listId` (например, ID колонки «Сделать»).

**Команда:**
```bash
node .agent/skills/trello_skill/scripts/list_lists.js <boardId>
```

### 3. Создать карточку
Создай карточку в указанном списке.

**Команда:**
```bash
node .agent/skills/trello_skill/scripts/create_card.js <listId> "<Card Title>" "<Optional Description>"
```
*(Всегда заключай заголовок и описание карточки в двойные кавычки, чтобы оболочка не разделила их на отдельные аргументы.)*

---

## Порядок действий ИИ-агента

Когда пользователь просит управлять задачами в Trello или добавить задачу, действуй следующим образом:
1. **Определи место назначения:** если `listId` неизвестен, сначала запусти `list_boards.js` и найди нужный `boardId`, затем запусти `list_lists.js <boardId>` и получи соответствующий `listId` (например, для колонки «Сделать»).
2. **Выполни команду:** запусти скрипт `create_card.js <listId> "Task Title" "Task Description"`.
3. **Сообщи результат:** подтверди успешное создание карточки и дай пользователю прямой URL новой карточки Trello.