weeek-tasks

Управление задачами WEEEK через Public API (Task Manager): получать список задач, создавать/обновлять/завершать задачи, перемещать между досками/колонками, получать список досок и колонок. Использовать при интеграции с WEEEK API и работе с задачами/досками/колонками.

Security Scan

The code implements WEEEK Task Manager operations and matches the description, but the skill/registry metadata does not declare the required environment variables (WEEEK_TOKEN and optional WEEEK_USER_ID), which is an important inconsistency to resolve before trusting/installing.

Purpose & Capability

The skill's name/description (WEEEK task manager operations) align with the included script and reference docs: scripts/weeek_api.py implements listing/creating/updating/completing/moving tasks and listing projects/boards/columns against https://api.weeek.net/public/v1. The code and SKILL.md describe the same API endpoints and operations.

Instruction Scope

SKILL.md gives concrete CLI usage and explicitly instructs to set WEEEK_TOKEN (and optionally WEEEK_USER_ID) and to use the provided script. The instructions do not ask the agent to read unrelated files or call unexpected external endpoints — all network calls target the documented Public API base URL. No broad or vague 'gather whatever context you need' language is present.

Install Mechanism

There is no install spec (instruction-only) and no downloads; the package includes a small Python script and a package.json manifest. Nothing in the install surface writes or executes code from arbitrary remote URLs, so install risk is low.

Credentials

The SKILL.md and scripts require a secret: WEEEK_TOKEN (and optionally WEEEK_USER_ID). However, the registry metadata lists 'Required env vars: none' and 'Primary credential: none', which is inconsistent and problematic: the platform may not prompt for or protect the token correctly. Aside from those two variables, no unrelated credentials are requested.

Persistence & Privilege

The skill does not request always:true, does not modify other skills or global agent settings, and has no special persistence or privileged system access. It runs as an on-demand CLI-style script.

What to consider before installing

This skill's code appears to do exactly what its description says (talk to WEEEK Public API), but there is an important metadata mismatch: the script requires WEEEK_TOKEN (and optionally WEEEK_USER_ID) while the registry metadata declares no required env vars/credentials. Before installing or providing secrets: 1) Ask the publisher to correct the registry metadata to list WEEEK_TOKEN as the primary credential so the platform can handle it properly. 2) Verify you trust the publisher (homepage unknown) before supplying an API token. 3) Prefer creating a limited-scope token/account for automation rather than using a personal full-access token. 4) Optionally review the included scripts yourself (they are small) to confirm no unexpected network calls or data exfiltration. If the publisher cannot justify or fix the missing metadata, treat the skill with caution (do not provide high-privilege credentials).

WEEEK задачи

Быстрый старт

1. Установить переменные окружения:
   • WEEEK_TOKEN — токен авторизации
   • WEEEK_USER_ID — ваш ID в WEEEK (опционально)
2. Использовать scripts/weeek_api.py для операций.
3. Для справки по эндпоинтам читать references/api.md.

Скрипт

Получить задачи

python scripts/weeek_api.py list-tasks --day DD.MM.YYYY --board-id ID_доски --board-column-id ID_колонки

Создать задачу

python scripts/weeek_api.py create-task --title "Задача" --day DD.MM.YYYY --no-locations

Если нужна привязка к проекту/доске — передать project_id/board_id/board_column_id или JSON:

python scripts/weeek_api.py create-task --title "Задача" --locations-json '[{"boardId":ID_доски,"boardColumnId":ID_колонки}]'

Обновить задачу

python scripts/weeek_api.py update-task ID_задачи --title "Новый заголовок" --priority 2

Завершить / вернуть

python scripts/weeek_api.py complete-task ID_задачи
python scripts/weeek_api.py uncomplete-task ID_задачи

Переместить

python scripts/weeek_api.py move-board ID_задачи --board-id ID_доски
python scripts/weeek_api.py move-board-column ID_задачи --board-column-id ID_колонки

Списки проектов/досок/колонок

python scripts/weeek_api.py list-projects
python scripts/weeek_api.py list-boards --project-id ID_проекта
python scripts/weeek_api.py list-board-columns --board-id ID_доски

ID можно получить через list-projects, list-boards, list-board-columns.

Ограничения и вопросы

• Формат day в docs указан как string; точный формат подтвердить у пользователя.
• По умолчанию создаются «датные» задачи без привязки к проектам/доскам (--no-locations).
• Если задан WEEEK_USER_ID, он автоматически ставится в userId и assignees при создании.