Задачи и каталог интеграций

Две команды про одно и то же свойство: посмотреть, а не вспомнить. Обе читают общий источник и обе отказываются работать по памяти агента.

digit tasks — общая доска задач

Над одной базой .digitable-tasks работают сразу несколько агентов и владелец. Отсюда единственное существенное решение этой команды.

digit tasks list --project DIGIT
digit tasks add --project DIGIT 'что должно стать правдой'
digit tasks show <uuid>
digit tasks note <uuid> 'чем это подтверждается'
digit tasks done <uuid> --note 'чем это подтверждается'

Задача называется только uuid

Короткие позиционные номера Taskwarrior пересчитываются всякий раз, когда меняется множество открытых задач. Ссылка, прочитанная до закрытия, после закрытия указывает на другую задачу. Поэтому команда позиционные номера отвергает — с кодом возврата 2 — вместо того чтобы полагаться на память вызывающего.

Это неудобно ровно один раз: uuid приходится копировать. Взамен закрытие задачи не может попасть не в ту строку. Живой прогон:

$ digit tasks show 3
  refused: '3' is a positional id, not a uuid. Positional ids are recomputed
  whenever the pending set changes, so closing one task renumbers the rest and
  this reference can point at a different task than the one you read.
$ echo $?
2

Сам список печатает uuid первой колонкой, и позиционного номера в нём нет вовсе — копировать нечего, кроме верного:

$ digit tasks list --project DIGIT
  uuid                                  project     description
  ------------------------------------  ----------  --------------------------------
  917bbecf-1769-4d93-bd18-ebc8e96caaa0  DIGIT       DGT-DIGIT-02 — Инструменты Work…
  d6d85967-1e7c-4370-b6f1-a00066244893  DIGIT       DGT-DIGIT-03 — Разбор намерения…

Уточнения при создании: --project, --tag (можно несколько), --priority H|M|L. У list есть --status pending|completed|all (по умолчанию — открытые) и --json. Каталог базы берётся из tasks.data_dir в config.yaml, иначе из $TASKDATA, иначе ищется каталог .digitable-tasks вверх от рабочего.

Формулировка задачи — «что должно стать правдой», а не «что сделать»: у первой формы есть проверяемое условие завершения, у второй нет.

digit workbench — каталог интеграций

Карточки читаются прямо из репозитория портала (data/workbench-integrations.toml), поэтому путь установки и шаги подключения смотрятся, а не вспоминаются агентом.

digit workbench list
digit workbench list --category editors
digit workbench list --caveats
digit workbench show neovim
digit workbench search tmux
digit workbench categories

Живой прогон на текущем состоянии каталога:

$ digit workbench categories
  category      cards  title
  ------------  -----  ----------------------------------------
  terminals        12  Терминалы и мультиплексоры
  cli              15  CLI-инструменты
  editors           8  Редакторы и IDE
  apps             15  Приложения
  mcp               2  MCP-серверы

  52 integration(s)

Оговорка печатается выше шагов

Карточки, помеченные !, несут оговорку: цель, где скопировать файлы — не вся работа. Мод клиента против условий использования, расширение, которому нужна ваша собственная подпись, компонент, намеренно не входящий в платный архив. На момент этой страницы таких карточек 11 из 52, и show всегда печатает оговорку до шагов, а не примечанием внизу.

Пример карточки целиком:

$ digit workbench show neovim
  id          neovim
  category    editors (Редакторы и IDE)
  files       3 файла в `colors/`
  dest        ~/.config/nvim/colors/
  available   in archive

  steps
    1. Скопируйте схемы в каталог конфигурации: `cp colors/*.lua ~/.config/nvim/colors/`.
    2. Включите truecolor и выберите палитру в `init.lua`.
    3. Или переключайтесь на ходу: `:colorscheme digitable-focus-paper`.

search ищет не только по названиям, но и по шагам и оговоркам: чаще всего человек помнит не имя карточки, а то, что в ней написано.

Границы

digit tasks требует установленного Taskwarrior и доступной базы; без них команда отказывает, а не создаёт свою.

digit workbench показывает то, что лежит в каталоге портала на момент вашей копии: если репозиторий курсов не найден, путь к нему задаётся флагом --catalog или ключом workbench.catalog в config.yaml. Числа выше — 52 карточки и 11 оговорок — верны на дату этой страницы и меняются вместе с каталогом; команда всегда печатает свои.

Тот же каталог опубликован на портале: интеграции Workbench. Бесплатный гайд по подключению самого Digit — там же.