alekseiul/sprut-agent-kit/agent-builder

🤖 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 — [Субъект]: [Событие]
   -**Что:** краткое описание
   -**Детали:** конкретика (пробег, вес, дата, стоимость)
   -**Действия:** что было сделано/рекомендовано
   ```
 
4.**Используй Edit tool:**
   -НЕ используй Write (перезапишет файл целиком)
   -Используй Edit для дописывания в конец:
   ```
   Edit data/events/log.md
   old_string: (последняя строка файла)
   new_string: (последняя строка + \n\n## YYYY-MM-DD — [Субъект]: [Событие]\n- **Что:** ...)
   ```
 
**Это НЕ опционально. Если информация соответствует чеклисту - запись ОБЯЗАТЕЛЬНА.**
 
## Примеры работы
 
### Вопрос
"Когда менять масло?"
 
### Процесс
1.Read `data/profile.md` → узнаю интервал замены (10K км)
2.Read `data/events/log.md` → последняя замена 115K км
3.Текущий пробег из профиля → 120K км
4.Ответ: "Пора менять! Последняя замена была 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
 
Агент работает **гибридно**:
 
1. **MD-файлы** = структурированное хранение (профиль, события)
2. **memory.sqlite** = быстрый поиск по всем разговорам
 
Когда записываешь событие:

// 1. Дописать в MD Edit("data/events/log.md", ...)

// 2. Сохранить в память storeMemory("Замена масла 120500 км, 01.03.2026", "episodic", "auto-mechanic")

 
Это даёт:
- ✅ Хронологию в MD (читабельно, структурировано)
- ✅ Поиск в SQLite (быстро, semantic search)
- ✅ Лучшее из двух миров