AlekseiUL 🤖 Agent Builder — Создатель Persistent Agent-ов
Когда использовать
Пользователь говорит:
- "Создай агента X"
- "Новый агент для Y"
- "Сделай persistent agent Z"
- Описывает задачу агента который должен:
- Помнить контекст между разговорами
- Вести структурированные записи
- Иметь специализированную экспертизу
Не использовать
- Простые одноразовые скиллы без памяти
- Skills.sh скиллы (brainstorming, debugging и т.д.)
- Субагенты для параллелизации (это другое)
Процесс создания
1. Собери требования
Спроси владельца:
Обязательные:
- Имя агента (slug-format, напр.
auto-mechanic) - Роль/экспертиза (напр. "Автомеханик для Mazda CX-5")
- Триггеры (слова активации, напр. "машина", "масло", "ТО")
Опциональные:
- Кого/что обслуживает (напр. "Mazda CX-5 2019, 120K км")
- Какие данные хранить (напр. "журнал ТО", "пробег", "замены")
- Стиль общения (напр. "технический", "дружелюбный")
- Референсы (примеры ответов, стиль письма)
2. Создай структуру
~/.claude/skills/<agent-name>/
├── SKILL.md # триггеры + инструкции
├── data/
│ ├── profile.md # статический профиль (кто/что)
│ └── events/
│ └── log.md # хронология событий
└── references/ # примеры, стиль (опционально)
└── examples.md
3. Сгенерируй SKILL.md
Шаблон:
---
name: <agent-name>
trigger:
- <trigger1>
- <trigger2>
- ...
description: >
<краткое описание: кто, для кого, что делает>
---
# <Emoji> <Agent Title>
## Активация
При триггере:
1. Прочитай профиль: `data/profile.md`
2. Прочитай последние события: `data/events/log.md` (последние 10 записей)
3. Ответь как <роль>
## Роль
Ты — **<Agent Name>**, <детальное описание экспертизы>.
<Стандарты работы, если нужны>
Язык: русский. Тон: <стиль общения>.
## Профиль
Полная информация в `data/profile.md`.
## Автофиксация (ОБЯЗАТЕЛЬНО)
После КАЖДОГО взаимодействия с пользователем:
1. **Проверь чеклист:**
- ✅ Новая информация требующая записи? (диагноз, событие, дата, замена, покупка)
- ✅ Изменение существующих данных? (вес, пробег, статус, прогресс)
- ❌ Простой вопрос без новой информации
2. **Если ✅ → ОБЯЗАТЕЛЬНО запиши:**
- В `data/events/log.md` (хронология событий)
- Обнови `data/profile.md` (если изменились постоянные данные)
3. **Формат записи в log.md:**
```markdown
## YYYY-MM-DD — [Субъект]: [Событие]
- **Что:** краткое описание
- **Детали:** конкретика (пробег, вес, дата, стоимость)
- **Действия:** что было сделано/рекомендовано
- Используй Edit tool:
- НЕ используй Write (перезапишет файл целиком)
- Используй Edit для дописывания в конец:
Edit data/events/log.md old_string: (последняя строка файла) new_string: (последняя строка + \n\n## YYYY-MM-DD — [Субъект]: [Событие]\n- **Что:** ...)
Это НЕ опционально. Если информация соответствует чеклисту - запись ОБЯЗАТЕЛЬНА.
Примеры работы
Вопрос
"Когда менять масло?"
Процесс
- Read
data/profile.md→ узнаю интервал замены (10K км) - Read
data/events/log.md→ последняя замена 115K км - Текущий пробег из профиля → 120K км
- Ответ: "Пора менять! Последняя замена была 5K км назад"
Запись события
Пользователь: "Поменял масло сегодня, пробег 120500"
Дописываю в data/events/log.md:
## 2026-03-01
- **Замена масла**: 120500 км, Castrol Edge 5W-40, 4.5 л
- Стоимость: 80 GEL
Автоматическая запись
Используй Edit tool:
Edit data/events/log.md
old_string: (последняя строка файла)
new_string: (последняя строка + \n\n## YYYY-MM-DD\n- **Событие**: детали)
Не используй Write (перезапишет файл целиком).
Workflow создания агента
Когда Пользователь говорит "создай агента X":
Шаг 1: Собери информацию
Спроси через AskUserQuestion:
questions: [
{
question: "Как назвать агента? (slug-format, напр. auto-mechanic)",
header: "Agent Name",
options: [
{ label: "auto-mechanic", description: "Автомеханик" },
{ label: "tax-advisor", description: "Налоговый советник" },
{ label: "recipe-keeper", description: "Хранитель рецептов" },
{ label: "Другое", description: "Свой вариант" }
]
},
{
question: "Какая роль/экспертиза?",
header: "Role",
options: [
{ label: "Эксперт", description: "Технический эксперт" },
{ label: "Советник", description: "Дружелюбный советник" },
{ label: "Журналист", description: "Фиксирует факты" }
]
},
{
question: "Какие данные хранить?",
header: "Data",
multiSelect: true,
options: [
{ label: "Профиль объекта", description: "Характеристики (машина, человек и т.д.)" },
{ label: "Журнал событий", description: "Хронология (ТО, покупки, изменения)" },
{ label: "Примеры/референсы", description: "Образцы текстов, стиль" }
]
}
]
Шаг 2: Создай структуру
mkdir -p ~/.claude/skills/<agent-name>/data/events
mkdir -p ~/.claude/skills/<agent-name>/references
Шаг 3: Сгенерируй файлы
SKILL.md — используй шаблон выше, подставь:
<agent-name>- Триггеры (попроси у владельца или предложи 5-7 релевантных)
- Роль и экспертизу
- ОБЯЗАТЕЛЬНО блок "Автофиксация (ОБЯЗАТЕЛЬНО)" со специфичным чеклистом для агента
- Инструкции по data-файлам
data/profile.md — создай заготовку:
# <Agent Title> — Профиль
## Основная информация
- **Название**: <объект>
- **Характеристики**: <детали>
## <Специфичные разделы>
(зависит от типа агента)
data/events/log.md — пустой файл с заголовком:
# Журнал событий — <Agent Name>
(События будут добавляться автоматически)
references/examples.md (опционально):
# Примеры и референсы
## Стиль общения
<примеры ответов>
## Образцы текстов
<если нужно>
Шаг 4: Подтверди создание
Покажи владельцу структуру:
✅ Создан агент: <name>
📁 Структура:
~/.claude/skills/<name>/
├── SKILL.md (триггеры, инструкции)
├── data/
│ ├── profile.md (заполни вручную)
│ └── events/log.md (автозапись)
└── references/ (опционально)
🎯 Активация: <триггеры>
📝 Заполни profile.md вручную или дай мне информацию
Шаг 5: Первое наполнение
Если Пользователь даёт информацию сразу:
- Заполни
profile.mdструктурированно - Если есть первое событие → запиши в
log.md
Примеры агентов
AutoMechanic (Автомеханик)
Чеклист автофиксации для AutoMechanic:
✅ Записывать:
- Пробег на дату обслуживания
- Замена масла/фильтров/резины
- Ремонт (что сломалось, что заменили, стоимость)
- Покупка запчастей
- Визит на СТО
❌ НЕ записывать:
- "Когда менять масло?" (общий вопрос)
- "Что входит в ТО-2?" (справка)
Профиль (data/profile.md):
# 🚗 Автомобиль
- **Марка/Модель**: Mazda CX-5 2019
- **VIN**: JMXXXXXXXXXXXXXXX
- **Пробег текущий**: 120500 км (на 01.03.2026)
- **Двигатель**: 2.5L SKYACTIV-G
- **Коробка**: 6AT
## Регламент ТО
- Масло: каждые 10K км (Castrol Edge 5W-40, 4.5 л)
- Фильтр воздушный: каждые 20K км
- Тормозная жидкость: каждые 2 года
...
События (data/events/log.md):
## 2026-03-01 — Mazda CX-5: Замена масла
- **Что:** Плановое ТО
- **Детали:** 120500 км, Castrol Edge 5W-40, 4.5 л
- **Действия:** Замена масла и масляного фильтра, стоимость 80 GEL
## 2025-12-15 — Mazda CX-5: Замена аккумулятора
- **Что:** Аварийная замена
- **Детали:** Varta Blue 70Ah, старый 5 лет, не держал заряд зимой
- **Действия:** Замена аккумулятора, стоимость 180 GEL
## 2025-10-20 — Mazda CX-5: Замена масла
- **Что:** Плановое ТО
- **Детали:** 110200 км, Castrol Edge 5W-40, 4.5 л
- **Действия:** Замена масла и масляного фильтра, стоимость 75 GEL
CopywriterStyle (Стиль копирайтера)
Профиль (data/profile.md):
# ✍️ Стиль владельца
## Принципы
- Короткие предложения
- Без воды и лишних слов
- Прямо в суть
- Живой разговорный язык
- Мат приветствуется
Примеры (references/examples.md):
## Пример поста (хороший)
<текст поста>
## Пример поста (плохой)
<что НЕ делать>
Интеграция с memory.sqlite
Агент работает гибридно:
- MD-файлы = структурированное хранение (профиль, события)
- memory.sqlite = быстрый поиск по всем разговорам
Когда записываешь событие:
// 1. Дописать в MD
Edit("data/events/log.md", ...)
// 2. Сохранить в память
storeMemory("Замена масла 120500 км, 01.03.2026", "episodic", "auto-mechanic")
Это даёт:
- ✅ Хронологию в MD (читабельно, структурировано)
- ✅ Поиск в SQLite (быстро, semantic search)
- ✅ Лучшее из двух миров