taskflow — плагин
Декларативные DAG-воркфлоу для кодинг-агентов: фазы в изоляции, проверка графа, возобновление и воспроизведение прогонов.
- 80 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Фазы запускают подагентов и скрипты, а записи в заявленные пути меняют файлы проекта.
Установка
- Работает в
Ручная установка
npm install --global pi-taskflow@1.0.0Первая команда установки в README. Для Codex есть `codex-taskflow`, для Claude Code `claude-taskflow`, плагин и MCP подключают по руководству хоста.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Фазы запускают подагентов и скрипты, а записи в заявленные пути меняют файлы проекта.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
taskflow описывает работу агента графом, проверяет его до запуска и выполняет фазы в изоляции. Промежуточные результаты остаются внутри среды выполнения, а в основной разговор возвращается только итоговый вывод. Доступны 12 типов фаз: `agent`, `parallel`, `map`, `reduce`, `script`, `gate`, `approval`, `loop`, `tournament`, `race` и другие, с бюджетами, повторами и таймаутами. В версии 1.0 граф еще и объявляет допустимые файловые эффекты: запись в заявленный путь проходит через транзакцию с откатом. Для Claude Code и Codex ставятся плагин и MCP-сервер, всего 20 инструментов `taskflow_*`, среди них `taskflow_plan`, `taskflow_verify`, `taskflow_trace`, `taskflow_replay` и `taskflow_recompute`. Pi, OpenCode, Grok Build и Hermes Agent подключаются своими адаптерами.
Для кого. Разработчикам, которые гоняют агентов по всему репозиторию, нескольким десяткам файлов или многошаговому процессу и хотят видеть, что запускается и во что обойдется.
Подходит, если
- Аудит кодовой базы дробится на параллельные подзадачи с общим итогом.
- Перед запуском нужен план: какие фазы пойдут и сколько вызовов агента будет в худшем случае.
- Упавший прогон возобновляют с одной фазы с другой задачей или моделью.
- Лучший из нескольких вариантов выбирают фазой `tournament`.
Не подходит, если
- Задача укладывается в один запрос к агенту.
- Нужна песочница на уровне ОС: taskflow ее не создает.
- Среда выполнения моложе Node.js 22.19.
Пример запроса к агенту
Раздели аудит этого репозитория на параллельные подзадачи по модулям, покажи план через `taskflow_plan` и запусти после моего подтверждения.Ограничения
Нужен Node.js 22.19 или новее. Эффекты `effects[]` — это объявление и проверка, а не песочница ОС: запись в необъявленный путь зависит от политики хоста. В Claude Code фазы с записью по умолчанию отклоняются, потому что у режима без интерфейса нет песочницы, их разрешают явно и только для доверенных потоков. Подробности установки плагина и MCP лежат в руководствах по хостам на сайте проекта. Веб-консоль управления работает локально через Unix-сокет, поддержка Windows там пока не объявлена. Версия 1.0.0, проверенный объем указан в таблице приемки репозитория.
Как отключить. Удалите плагин командой `/plugin uninstall` для Claude Code или уберите MCP-запись taskflow из конфигурации агента. Глобальные пакеты снимает `npm uninstall --global`. Сохраненные прогоны лежат в каталоге проекта и удаляются вручную.
Частые вопросы
Как подключить taskflow к Claude Code?
Пакет `claude-taskflow` дает MCP-сервер и запуск подагентов, а плагин распространяется через маркетплейс репозитория. Шаги описаны в руководстве по хосту на сайте проекта.
Сколько агентских вызовов стоит прогон?
Ответит `taskflow_plan`: он показывает порядок фаз, привязку аргументов и верхнюю границу числа вызовов без токенов и без запуска.
Можно ли возобновить упавший прогон?
Да. `taskflow_resume` создает дочерний прогон от упавшей фазы, при желании с другим заданием, моделью или таймаутами.
Видно ли, что делали подагенты?
По умолчанию в основной чат приходит только итоговый вывод. Промежуточное читают через `taskflow_peek` и `taskflow_trace`.
Что такое объявленные эффекты?
Фаза заранее указывает, какой путь она вправе записать. Среда проверяет метки и пересечения, пишет во временную область и фиксирует результат либо откатывает его. Причину решения объясняет `taskflow_why_effect`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныВизуальный конструктор воркфлоу для агентов: рисуете схему на канвасе и экспортируете ее в скиллы и команды Claude Code, Codex, Cursor и других
Скилл /codex-workflows: Claude Code пишет сценарий, а десятки агентов Codex выполняют его, и прогон виден на карте
Maestro-Flow по цели строит цепочку от анализа до тестов и гоняет через нее Claude Code, Codex, Gemini и других агентов
Плагин Roboflow дает агенту навыки по компьютерному зрению: данные, обучение, проверка моделей, инференс и вызовы API.
Frink запускает до четырех агентов в своих worktree и собирает Flow-автоматизации из одной фразы со своим скиллом редактора.
Среда запуска JavaScript-сценариев, которые раздают работу десяткам агентов Codex, Gemini, Qwen, Kimi и Claude Code.
Коротко о README
Репозиторий излагает контракт объявленных эффектов, 12 типов фаз, нулевые по токенам операции проверки и воспроизведения, список адаптеров хостов и прямо перечисляет границы безопасности.