Kaiten

Kaiten API

Скилл для работы с Kaiten API через готовые bash-скрипты.

Покрывает:

• карточки (CRUD, перемещение, назначение исполнителей, теги, чеклисты)
• комментарии
• доски, колонки, дорожки (lanes)
• пространства (spaces)
• пользователи, теги, типы карточек
• произвольные запросы к любому endpoint Kaiten

When to Apply

• «Создай карточку в Kaiten…»
• «Перенеси карточку в колонку Done / на доску X»
• «Покажи мои карточки / найди карточку по названию»
• «Добавь комментарий к карточке N»
• «Покажи доски пространства X / колонки доски Y»
• Любой запрос «в Kaiten …»

Base URL & Auth

Base URL: https://{KAITEN_DOMAIN}/api/latest
Auth:     Authorization: Bearer {KAITEN_TOKEN}

• KAITEN_DOMAIN — хост инсталляции, например mycompany.kaiten.ru.
• KAITEN_TOKEN — персональный API-токен. Как получить: Kaiten → аватар → Профиль → API → Create new API token.

Credentials

Креды лежат в config/.env внутри скилла (файл в .gitignore):

KAITEN_DOMAIN=mycompany.kaiten.ru
KAITEN_TOKEN=eyJhbGciOi...

scripts/_common.sh загружает их автоматически и валит запрос с понятной ошибкой, если не заданы.

Если config/.env нет — агент обязан запустить onboarding: спросить у пользователя KAITEN_DOMAIN и KAITEN_TOKEN, предложить ДВА варианта:

• Вариант 1: передать в чат (агент сам создаст config/.env из config/.env.example, подставит значения, chmod 600).
• Вариант 2: пользователь выполняет локально: cp config/.env.example config/.env и редактирует вручную.

Env-переменные переопределяют config/.env для one-off вызовов: KAITEN_DOMAIN=... KAITEN_TOKEN=... ./scripts/methods/current-user.sh.

Как получить токен: см. config/README.md.

Documentation References

• references/auth.md — авторизация, переменные окружения, типовые ошибки
• references/api.md — основные endpoint'ы (cards, boards, spaces, columns, comments, users, tags)

Scripts

Все скрипты лежат в scripts/. Общая точка входа для произвольных запросов — kaiten-request.sh.

Which Script to Use

• «Создай карточку …» → card-create.sh (payload обязательно содержит title + board_id или column_id).
• «Перемести карточку …» → card-move.sh. Нужны column_id (и lane_id) — получи через columns-list.sh/lanes-list.sh.
• «Обнови карточку …» → card-update.sh с payload {"title":...,"description":...,"due_date":...}.
• «Добавь комментарий …» → card-comment.sh.
• «Покажи доски / колонки …» → boards-list.sh → columns-list.sh.
• «Найди мои карточки / по доске / по автору» → cards-list.sh с фильтрами (board_id, space_id, owner_id, member_ids, query, condition, archived).
• Любой другой endpoint → kaiten-request.sh.

Conventions

• Base URL всегда https://{KAITEN_DOMAIN}/api/latest.
• Content-Type: application/json.
• Ответы — JSON, пайпи через jq для чтения.
• Пагинация: limit (макс. обычно 100) + offset.
• Идентификаторы — целые числа.

Error Codes

• 200/201 — успех
• 400 — невалидный payload
• 401 — нет/невалидный токен
• 403 — нет прав
• 404 — объект не найден
• 429 — rate limit
• 5xx — ошибка сервера