Перейти к содержимому

Паттерн рабочего пространства

Назначение

Создание выделенной директории рабочего пространства для выполнения 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-2145
  • auth-fix-20251212-0930
  • api-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 workflow
agent_temp_files_local/

Рабочие пространства — это временные рабочие директории, которые не следует коммитить.

Восстановление

При прерывании workflow агент может:

  1. Прочитать handoff и process-id.txt принадлежащего задаче workspace.
  2. Убедиться, что выполнение относится к этой задаче и не отменено и не заменено.
  3. Через 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 должна проверять необходимые файлы на диске.

Связанные паттерны