Human-workflow-v0.0.7
Human Workflow — плагин для работы с ИИ-агентом над заданиями, проектами и отчётами. Он помогает сохранить требования, понять, что действительно сделано и проверено, получить объяснение результата и продолжить работу после паузы или передачи другому исполнителю.
Например, можно передать агенту методичку, исходные данные и образец отчёта. Workflow связывает поручение, выполненную работу, проверки и документ, а доступные навыки для Word, Excel, PDF или кода помогают выполнить операции с конкретными форматами. Качество результата зависит также от исходников, возможностей среды и фактических проверок.
Как проходит работа
Прикрепите задание, исходные материалы или существующий проект и напишите: «Давай начнем выполнение задачи». Для явного выбора процесса можно назвать Human Workflow и md-word. Описанный порядок применяется, когда агент выбрал и загрузил нужный скил.
Ниже — полный сценарий работы. Состав задания определяет, какие этапы нужны: можно выполнить ядро и подготовить отчет, получить только пошаговые инструкции или сопровождать работу без итогового отчета.
1. Разобрать задачу и определить состав сдачи
Агент изучает методичку, вариант, исходные данные, образец, текущие файлы и решения пользователя. Выделяет основную работу — ядро — и определяет обязательные результаты: программу, SQL-скрипт, таблицу, JSON, отчет, дополнительные ответы или демонстрацию. Необходимость отчета, теории и промежуточных материалов устанавливается по заданию.
2. Сформировать понятное ТЗ
Агент использует существующее техническое задание либо составляет рабочее ТЗ из исходного поручения и согласованных уточнений. В нем фиксируются цель, обязательные требования к ядру, входные данные, среда и ограничения, состав сдачи, форматы, критерии готовности и материалы для объяснения.
Для небольшой задачи достаточно нескольких пунктов в рабочей заметке; для большой работы ТЗ может быть отдельным документом. Агент показывает рабочую основу и уточняет существенные неоднозначности. Дальнейшее исполнение идет по выбранной редакции ТЗ; изменения требований записываются отдельно от сведений о фактически выполненном.
3. Выполнить ядро по ТЗ
Агент определяет, какую часть может выполнить с доступными знаниями, инструментами и доступом, кратко сообщает об этом и приступает к порученной работе. Выполнимое здесь ядро — например, расчет, таблицу, JSON, SQL или небольшую программу — текущий агент выполняет сам и проверяет доступными средствами.
Результаты и нужные промежуточные материалы сохраняются по ходу выполнения. Подготовленный файл, выполненный расчет и запуск в целевой среде учитываются отдельно: написанный SQL еще не означает, что запросы исполнялись в базе.
3.1. Продолжить обширное ядро через шаги или другого исполнителя
Большую работу можно разделить на последовательные этапы и продолжать с текущим агентом. Если часть действий агент не может выполнить непосредственно, он обозначает эту часть и подготавливает человекочитаемые шаги. Пользователь может выполнить их сам, передать другому агенту или продолжать с текущим агентом, последовательно получая инструкции.
В каждом шаге понятны объект и исходное состояние, точное действие, его назначение, ожидаемый результат, проверка и материалы возврата. Текущий агент получает фактические результаты, соотносит их с ТЗ, отмечает выполненное и готовит следующий этап. Для ограниченного поручения другому исполнителю передаются нужные требования, исходники и границы работы; весь прежний разговор ему не требуется.
4. Сохранять ход работы и текущее состояние
На протяжении работы агент ведет понятный журнал фактических действий: какие данные получены, что изменено, какие результаты и проверки получены, какие решения приняты. Отдельно поддерживается краткое состояние: что готово, что заблокировано, что осталось и какое действие следующее.
Сведения от пользователя и других исполнителей сохраняются с указанием источника. Значимые результаты и состояние для продолжения сохраняются перед затратными или прерываемыми этапами; фактическое сохранение и облачная синхронизация учитываются отдельно.
5. Сверить результаты с ТЗ
Полученные результаты сопоставляются с требованиями независимо от того, кто выполнял ядро. Для существенных требований прослеживается связь: требование → выполненный шаг → результат и его версия → проверка и ее ограничения.
Агент изучает доступные материалы, отмечает расхождения, недостающие подтверждения и оставшуюся работу. Подходящие прежние подтверждения сохраняют силу в пределах своей версии и области проверки.
6. Подготовить человекочитаемый отчет в Markdown
Если отчет требуется, агент составляет связное объяснение: цель → исходные данные → метод и необходимая теория → выполненные действия → результаты → проверки → вывод. Текст основывается на фактической работе и требованиях задания; необходимые иллюстрации, примеры и источники включаются по их назначению.
Журнал помогает восстановить ход работы, а отчет объясняет решение читателю. Markdown становится содержательной основой для оформления итогового документа. При сопровождении без отчета сохраняются необходимые объяснение и состояние.
7. Согласовать содержание
Для нового отчета с последующим переносом в Word агент показывает актуальную редакцию Markdown или дает доступную ссылку и фиксирует ожидание согласования. Пользователь может уточнить содержание или одобрить перенос этой редакции. Независимая разрешенная работа может продолжаться.
Одобрение относится к конкретному содержанию и повторно не запрашивается, если уже покрывает выбранную редакцию. Существенные изменения требуют согласования измененной части; правка только оформления сама по себе не запускает весь процесс заново. Явное поручение прямой конвертации или пропуска промежуточного согласования учитывается с сохранением его источника, если требования задачи это допускают.
8. Оформить итоговый документ
Агент использует доступные средства для подготовки DOCX, PDF или другого требуемого формата. Оформление основной части и титул выбираются независимо; допустим явный вариант без отдельного титула. Сохраняются согласованный образец, выбранная актуальная версия и ручные изменения пользователя.
Проверяются содержание, структура и внешний вид в пределах доступных инструментов. Возможности конвертации, рендера и целевого редактора зависят от среды; недоступные проверки остаются явно обозначенными ограничениями.
9. Сохранить и передать результат
Агент сохраняет обязательные файлы, проверяет результат сохранения и передает доступные материалы с кратким описанием выполненного и оставшихся ограничений. Одобрение содержания, передача файлов, отправка на сдачу и приемка преподавателем или заказчиком учитываются отдельно.
После завершения агент один раз запрашивает краткую обратную связь, используя уже полученные ответы. Отсутствующая оценка остается неизвестной и не задерживает передачу результата.
10. Продолжить после паузы или смены исполнителя
Для продолжения сохраняются актуальное ТЗ, выбранные версии и источники содержания и оформления, выполненные действия, результаты проверок, состояние согласования, открытые вопросы и следующий шаг. По этим материалам работу может продолжить текущий агент, новый чат, другой агент или пользователь.
При продолжении учитываются реальные текущие файлы и расхождения; уже выполненная работа сохраняется. Доступность сохраненных материалов зависит от выбранного места и возможностей среды.
В версии 0.0.7 явный этап согласования Markdown закреплен для Word; тот же переход для прямой сборки PDF пока отдельно не закреплен в инструкциях.
Два скила
| Скил | Для каких задач |
|---|---|
md-word | Выполнить и сопровождать практическую или проект, подготовить отчёт по методичке и образцу, продолжить работу, сохранить состояние, материалы и решения |
human-step | Подготовить точные шаги для человека или агента, выполнить порученный пакет, проверить изменения и передать результат |
Оба скила можно использовать вместе. Подготовка инструкции не означает разрешения выполнить её. Сопровождение задачи возможно без итогового отчёта; общий вопрос или отдельная обычная правка не должны запускать весь процесс.
Что предоставить
Для начала нужны само поручение, исходные материалы и требования к результату. Для учебной работы это могут быть методичка, вариант и данные; для проекта — задача и актуальные файлы. Сведения, которых нет, агент не должен придумывать.
Свой Word-шаблон необязателен. Если нужно оформление вашего вуза или организации, приложите актуальный DOCX-образец и требования. Можно явно выбрать встроенный нейтральный пресет. Оформление основной части и титульник выбираются отдельно: свой титул, титул из полного образца либо нейтральный. Встроенный пресет не является универсальным стандартом учреждения. Для сопровождения без Word-отчёта шаблон не нужен. Оформление и титульник.
Установка
Один репозиторий для Codex и Claude: https://github.com/i7daydepressed/Human-Workflow.
Claude Code:
claude plugin marketplace add https://github.com/i7daydepressed/Human-Workflow
claude plugin install human-workflow@workflow-tools
Codex CLI:
codex plugin marketplace add https://github.com/i7daydepressed/Human-Workflow --json
codex plugin add human-workflow@workflow-tools --json
В интерфейсе плагинов Claude: Customize → Plugins → Add → Add marketplace, затем ссылка на репозиторий и установка Human Workflow. Наличие этого интерфейса зависит от клиента и настроек аккаунта. После установки используйте новую сессию. Чат без инструментов установки не может установить плагин только по ссылке.
Техническое имя плагина — human-workflow, версия — 0.0.7, отображаемое имя — Human-workflow-v0.0.7. Для существующей установки workflow-tools-preview нужна контролируемая миграция. Подробности установки.
Как начать
-
Прикрепляешь задачу и пишешь'Давай начнем работу над этой задачей'. Дополнительно если сам ознакоимся с задачей можно прямо сказать чтобы агент выполнил ядро или использовал субагента для выполнения ядра.
-
Я обычно использую работу в work/cowork чате и интеграцию с облачным хранилищем(google disk), это может съедать дополнительные токены но это удобно. Иначе агент будет тебе при малейшем изменении присылать новый zip-архив.
-
После работы хорошая практика ставить оценку отчету в виде баллов. 1 балл = "то что нужно", >1 = "именно этот результат я и желал, получилось лучше ожаданий", <1 = "не очень понравился отчет и процесс его формирования"
Можно попросить: «Используй md-word, выполни практическую по приложенной методичке и подготовь отчёт по образцу». При проверке установки полезно явно назвать human-workflow:md-word и попросить сообщить пути прочитанных инструкций. Видимость названия в списке ещё не подтверждает чтение workflow. Автоматический выбор скила не гарантирован.
Другие примеры: «Сопровождай задачу и сохрани состояние, отдельный отчёт не нужен»; «Используй human-step: подготовь проверяемые шаги для исполнителя, пока ничего не изменяй».
Рабочие инструкции доступны на английском и русском. По умолчанию выбираются английские; instruction_language: ru явно выбирает русские. Языки результата и журнала задаются независимо.
Состояние, журналы и личные настройки
Агент сохраняет существенные действия, проверки, решения и следующий шаг в выбранной рабочей папке, используя существующие правила проекта. Иначе предусмотрен agent-logs/<run-id>.md. Журналы не входят в сдаваемый отчёт; полные диалоги, секреты и лишние личные сведения записывать не следует. Запрет на изменение файлов распространяется и на журнал.
Необязательный приватный профиль хранит выбранные языки, предпочтения и собственные Word-ресурсы вне установки и кеша плагина. Профиль нужно явно указать. Обновление продукта не должно его перезаписывать; перенос профиля исключает историю и локальный путь рабочей папки. Профиль.
Плагин не запускает фоновый сбор данных и автоматически не отправляет журналы разработчику. Собственная облачная синхронизация и постоянная память между чатами не предоставляются: продолжение зависит от сохранённых файлов и доступа среды. Обработка данных самим клиентом регулируется его настройками и условиями.
Возможности среды и проверки
Кандидат 0.0.7 сохраняет генерируемые ресурсы внутри каждого скила и добавляет согласование редакции Markdown, раннее сохранение состояния, запрет записи задач внутрь установки и сведения о содержащем пакете. Загрузка, поведение и миграция идентичности в реальном клиенте остаются неподтверждёнными. Область проверок.
Основные помощники используют стандартную библиотеку Python; дополнительная сборка титула требует lxml. Плагин не устанавливает Word, Excel, шрифты или универсальный рендерер. Наличие файла или успешный расчёт не заменяют проверку в нужном приложении и визуальный просмотр.
Лицензия
Материалы кандидата 0.0.7, которыми распоряжается издатель, предоставляются по Apache License 2.0 в пределах его прав. Коммерческое использование разрешено на её условиях без отдельной платной лицензии и ограничения числа пользователей. Сохраняйте применимые сторонние лицензии и уведомления; обработка плагином профилей, личных оригиналов и результатов задач сама по себе не распространяет на них эту лицензию. Прежние выпуски сохраняют исторические условия. Область действия и обязанности.
Для разработчиков: общие исходники и генерация ресурсов.