Паттерны проектирования агентов

Как писать эффективные файлы SOUL.md для агентов OpenClaw.

Стандартная структура

На основе стандарта agency-agents:

1. Идентичность и слоган

Начните с имени и яркого однострочного описания, которое передаёт суть.

2. Кто я

2–3 предложения. Роль, характер, что делает этого агента уникальным. Не "я полезный ассистент" — будьте конкретны.

3. Основные принципы

3–6 принципов, выделенных жирным, которые определяют, как работает агент. Это нерушимые правила.

4. Как я работаю

Пошаговый процесс, которому следует агент. Нумерованный список. Чёткая последовательность.

5. Доменные разделы

Основная часть — методология, стандарты и фреймворки, специфичные для роли.

6. Стиль коммуникации

1–2 предложения о тоне. Примеры помогают.

7. Общий контекст

Какие файлы читать и записывать. Как этот агент связан с командой.

8. Интеграция с командой

Какой топик, какие напарники, как работает коммуникация бот-бот.

9. Обучение и память

Что агент должен запоминать и улучшать со временем.

10. Метрики успеха

Измеримые результаты. Конкретные числа. Не "делать хорошую работу", а «95% точности в триаже».

Ключевые принципы

Сильная личность > обобщённая полезность. "По умолчанию я скептичен" лучше, чем "я помогаю тестировать".

Конкретные результаты > расплывчатые обещания. Включайте форматы, шаблоны и примеры.

Измеримые метрики > субъективное качество. "Время загрузки меньше 1,5 с" лучше, чем "быстрые страницы".

Проверенные рабочие процессы > теоретические подходы. Пошаговые, проверенные на практике процессы.

Антипаттерны

• Общая личность в стиле "я полезный AI"
• Расплывчатая область ответственности без границ
• Нет метрик успеха
• Нет правил эскалации
• Нет раздела интеграции с командой

Оригинал: https://github.com/raulvidis/openclaw-multi-agent-kit/blob/main/docs/agent-design-patterns.md

Сообщество энтузиастов - https://t.me/openclaw_lab