agent-builder
Создаёт полноценных persistent skill-агентов с собственной памятью, system prompt-ом и data-файлами. Автоматизирует создание агентов как у OpenClaw (Doctor, AutoMechanic и т.д.).
Install
npx skills add https://github.com/AlekseiUL/sprut-agent-kit/tree/main/skills/agent-builder
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install alekseiul-sprut-agent-kit@llmmart
git clone https://github.com/AlekseiUL/sprut-agent-kit.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole alekseiul/sprut-agent-kit collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
🤖 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)
- ✅ Лучшее из двух миров
Files (sprut-agent-kit)
-
SKILL.md 13.2 KB
--- name: agent-builder trigger: triggers: - создай агента - новый агент - agent builder - сделай агента - персональный агент - создай агента - новый агент - agent builder - агентский скилл - persistent agent - сделай агента description: > Создаёт полноценных persistent skill-агентов с собственной памятью, system prompt-ом и data-файлами. Автоматизирует создание агентов как у OpenClaw (Doctor, AutoMechanic и т.д.). --- # 🤖 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 **Шаблон:** ```markdown --- 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`: ```markdown ## 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: Создай структуру ```bash 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** — создай заготовку: ```markdown # <Agent Title> — Профиль ## Основная информация - **Название**: <объект> - **Характеристики**: <детали> ## <Специфичные разделы> (зависит от типа агента) ``` **data/events/log.md** — пустой файл с заголовком: ```markdown # Журнал событий — <Agent Name> (События будут добавляться автоматически) ``` **references/examples.md** (опционально): ```markdown # Примеры и референсы ## Стиль общения <примеры ответов> ## Образцы текстов <если нужно> ``` ### Шаг 4: Подтверди создание Покажи владельцу структуру: ``` ✅ Создан агент: <name> 📁 Структура: ~/.claude/skills/<name>/ ├── SKILL.md (триггеры, инструкции) ├── data/ │ ├── profile.md (заполни вручную) │ └── events/log.md (автозапись) └── references/ (опционально) 🎯 Активация: <триггеры> 📝 Заполни profile.md вручную или дай мне информацию ``` ### Шаг 5: Первое наполнение Если Пользователь даёт информацию сразу: - Заполни `profile.md` структурированно - Если есть первое событие → запиши в `log.md` --- ## Примеры агентов ### AutoMechanic (Автомеханик) **Чеклист автофиксации для AutoMechanic:** ```markdown ✅ Записывать: - Пробег на дату обслуживания - Замена масла/фильтров/резины - Ремонт (что сломалось, что заменили, стоимость) - Покупка запчастей - Визит на СТО ❌ НЕ записывать: - "Когда менять масло?" (общий вопрос) - "Что входит в ТО-2?" (справка) ``` **Профиль** (`data/profile.md`): ```markdown # 🚗 Автомобиль - **Марка/Модель**: 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`): ```markdown ## 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`): ```markdown # ✍️ Стиль владельца ## Принципы - Короткие предложения - Без воды и лишних слов - Прямо в суть - Живой разговорный язык - Мат приветствуется ``` **Примеры** (`references/examples.md`): ```markdown ## Пример поста (хороший) <текст поста> ## Пример поста (плохой) <что НЕ делать> ``` --- ## Интеграция с memory.sqlite Агент работает **гибридно**: 1. **MD-файлы** = структурированное хранение (профиль, события) 2. **memory.sqlite** = быстрый поиск по всем разговорам Когда записываешь событие: ```typescript // 1. Дописать в MD Edit("data/events/log.md", ...) // 2. Сохранить в память storeMemory("Замена масла 120500 км, 01.03.2026", "episodic", "auto-mechanic") ``` Это даёт: - ✅ Хронологию в MD (читабельно, структурировано) - ✅ Поиск в SQLite (быстро, semantic search) - ✅ Лучшее из двух миров
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.