Паттерн рабочего пространства
Назначение
Создание выделенной директории рабочего пространства для выполнения workflow. Все рабочие файлы (планы, результаты, отчёты, резервные копии) хранятся в одном месте, сохраняя чистоту проекта.
Структура
./agent_temp_files_local/moira-ws/{workspace-name}/├── process-id.txt # ID выполнения workflow для восстановления├── development-plan.md # Планы и спецификации├── step-1/ # Результаты конкретных шагов│ └── step-results.md├── *.backup.json # Файлы резервных копий└── ... # Прочие рабочие файлыРасположение рабочего пространства
Используйте назначенную проектом игнорируемую рабочую директорию. Например:
./agent_temp_files_local/moira-ws/{workspace-name}/Соблюдайте правила проекта и вызывающей стороны. Не создавайте произвольную директорию в корне проекта и не используйте workspace другого выполнения.
Соглашение об именовании
Формат: {short-name}-{YYYYMMDD}-{HHMM}
short-name: Краткое описание задачи (макс. 20 символов, kebab-case)- Дата и время создания
Примеры:
wmf-edit-20251211-2145auth-fix-20251212-0930api-refactor-20251215-1400
Реализация
Владелец рабочего пространства
Существующая ранняя ответственность определяет канонический путь рабочего пространства. Если последующим нодам нужен общий workspace_path, объявите строковую запись реестра и перенесите ответ владельца через globalInputs. Нода, единственная задача которой выбрать или создать
директорию, добавляет ход, но не добавляет суждения.
Если стабильные файлы берутся из default-значений реестра workflow, сразу после этого владельца
разместите ноду materialize. Она выдаёт инструкции доставки одного неизменяемого архива владельца. Агент выполняет поддерживаемую команду распаковки либо объявленный context fallback; сам переход из ноды не доказывает создание файлов.
Этот общий фрагмент объявления не является объявлением встроенного Workflow Management Flow.
Он предполагает строковые записи реестра workspace_process_id_file и workflow_reference
со стабильными телами в default, заданный workspace_path и последующую ноду create-plan:
{ "id": "materialize-workspace-bootstrap", "type": "materialize", "basePath": "{{workspace_path}}", "files": [ { "path": "process-id.txt", "from": "workspace_process_id_file" }, { "path": "workflow-reference.md", "from": "workflow_reference" }, { "path": "plans/.keep", "content": "" } ], "connections": { "success": "create-plan" }}Указанные записи реестра служат источником истины для стабильного содержимого workflow. Владелец содержательной работы по-прежнему записывает динамические контракты задачи, анализ, планы и отчёты в том же ходе, где определяет их содержание. Возвращённый путь сам по себе ничего не доказывает: completion condition первого потребителя должна требовать существования и полноты нужных файлов.
Полный контракт объявления, архива, путей, безопасности и ошибок описан в разделе Материализация файлов.
Использование пути рабочего пространства
Ссылайтесь на {{workspace_path}} в последующих директивах. Если путь использует current_step, объявите и инициализируйте этот номер для фактического потребителя.
{ "directive": "Save development plan to {{workspace_path}}/development-plan.md"}{ "directive": "Create step results in {{workspace_path}}/step-{{current_step}}/step-results.md"}Что хранить в рабочем пространстве
Включайте:
process-id.txt— ID выполнения для восстановления workflow- Планы и спецификации (файлы
.md) - Результаты и отчёты по шагам
- Резервные копии перед редактированием
- Временные результаты анализа
Исключайте:
- Исходный код проекта
node_modulesили зависимости- Большие бинарные файлы
- Секреты и учётные данные
Настройка Git
Назначенная директория должна игнорироваться Git. Используйте локальный exclude, если политика проекта не разрешает изменение tracked ignore-файла. Для примера выше:
# Рабочие пространства Moira workflowagent_temp_files_local/Рабочие пространства — это временные рабочие директории, которые не следует коммитить.
Восстановление
При прерывании workflow агент может:
- Прочитать handoff и
process-id.txtпринадлежащего задаче workspace. - Убедиться, что выполнение относится к этой задаче и не отменено и не заменено.
- Через
executionпроверить текущий статус и шаг; продолжать из состояния движка в пределах разрешённого восстановления.
{ "directive": "Inspect the task-owned workspace handoff and execution status. Resume only the matching active execution when authorized; a found process ID alone is not permission to resume."}Пример Workflow Management Flow
Workflow Management Flow определяет workspace_path, материализует ID процесса, тематические
справочники и стартовые шаблоны для обеих веток и затем выбирает создание или редактирование:
get-action-type -> materialize-workspace-bootstrap -> route-action-type | create -> gather-workflow-requirements | edit -> prepare-edit-workflowАрхив записывает process-id.txt, тематические Markdown-файлы в reference/ и стартовые JSON
workflow в reference/templates/. Их тела задают строковые defaults workflow_reference_* и
workflow_template_*. Каждый потребитель читает файлы, названные его директивой; затем владельцы
веток create и edit записывают свои требования и provenance, не дублируя стабильные справочники.
Пример материализации
показывает фактические bootstrap-пути и источники реестра.
Перевод ручного bootstrap
Перенесите стабильные тела workflow в default-значения строковых записей реестра и доставляйте их
одной нодой materialize. Удалите из директив агента только соответствующие инструкции записи
статических файлов. Динамические файлы оставьте ответственности, определяющей их содержание, а её
completion condition должна проверять необходимые файлы на диске.
Связанные паттерны
- Минимальный граф - что оправдывает отдельный ход агента
- Динамические файлы - Использование
{{workspace_path}}в путях файлов - Материализация файлов - Доставка стабильных файлов из реестра
- Верификация шагов - Хранение результатов верификации в рабочем пространстве