# self-improving-agent

Скилл self-improving-agent ведёт локальный журнал в .learnings/: ошибки, правки пользователя и запросы на недостающие возможности. Агент перечитывает его перед крупными задачами.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 239 у репозитория
- Автор: jdrhyne
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/jdrhyne/agent-skills/tree/HEAD/clawdbot/self-improving-agent/SKILL.md
- Обновлён: 2026-08-30
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/jdrhyne-self-improving-agent

## Что делает

Скилл держит небольшой журнал рядом с проектом. Записи идут в `.learnings/LEARNINGS.md`, `.learnings/ERRORS.md` и `.learnings/FEATURE_REQUESTS.md`, каталог создаётся при первом обращении. Каждая запись — блок markdown с идентификатором вида `LRN-YYYYMMDD-XXX`, приоритетом, статусом и областью: frontend, backend, infra, tests, docs или config. Дальше `Summary`, `Details` и `Suggested Action`: что случилось и что теперь считается правильным.

Повторяющиеся случаи связываются через поле `See Also`, статус меняется, когда проблема закрыта или стала правилом. Перед большой задачей в знакомой области скилл советует перечитать `.learnings/`. Решение, которое выдержало проверку и годится не только для этого проекта, выносят в отдельный скилл, а в записи помечают, где правило теперь живёт. Не каждый сбой достоин строки: скилл просит не засорять журнал мелочью.

Права узкие — только запись файлов внутри `.learnings`. Токены, приватные ключи и персональные данные логировать нельзя, пользовательские файлы правил скилл трогает лишь по прямой просьбе, а статус resolved ставит после проверки фикса. Записи создаются в рабочем каталоге проекта, поэтому `.learnings/` придётся либо коммитить, либо закрыть в `.gitignore`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jdrhyne/agent-skills --skill self-improving-agent -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/self-improving-agent/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/self-improving-agent/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jdrhyne/agent-skills --skill self-improving-agent -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/self-improving-agent/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jdrhyne/agent-skills --skill self-improving-agent -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/self-improving-agent/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jdrhyne/agent-skills clawdbot/self-improving-agent/SKILL.md
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/self-improving-agent/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jdrhyne/agent-skills --skill self-improving-agent -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/jdrhyne/agent-skills --path clawdbot/self-improving-agent
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/self-improving-agent/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/jdrhyne/agent-skills/tree/HEAD/clawdbot/self-improving-agent/SKILL.md

## Когда брать
- Записать разбор упавшей команды, чтобы не искать причину заново
- Сохранить поправку пользователя к конвенциям проекта
- Отследить запрос на возможность, которой у агента нет
- Связать повторяющиеся сбои в одну серию записей
- Перечитать накопленные уроки перед работой в знакомой области

## Примеры запросов агенту
- Сборка упала с той же ошибкой, что и вчера. Занеси разбор в `.learnings/ERRORS.md`.
- Ты ошибся: миграции у нас запускаются через `make migrate`, а не `alembic upgrade`. Запиши это как обучение.
- Перед рефакторингом оплаты перечитай `.learnings/` за прошлый месяц.

## Похожие
- [self-improvement](https://affpapa.org/nevibecode/skills/self-improvement.md) — скилл · 2100 установок
- [memory-curate](https://affpapa.org/nevibecode/skills/memory-curate.md) — скилл · 1500 установок
- [ce-compound-refresh](https://affpapa.org/nevibecode/skills/ce-compound-refresh.md) — скилл · 3500 установок
- [planning-with-files](https://affpapa.org/nevibecode/skills/planning-with-files-4.md) — скилл · ★ 28179 у репозитория
- [replay-learnings](https://affpapa.org/nevibecode/skills/replay-learnings.md) — скилл · ★ 2966 у репозитория
- [Docmancer](https://affpapa.org/nevibecode/mcp/docmancer.md) — MCP-сервер · ★ 133 у репозитория

## Другие версии с тем же именем
- [self-improving-agent · alirezarezvani](https://affpapa.org/nevibecode/skills/self-improving-agent.md) — 1078 установок
- [self-improving-agent · zhaono1](https://affpapa.org/nevibecode/skills/zhaono1-self-improving-agent.md) — 35900 установок
- [self-improving-agent · pskoett](https://affpapa.org/nevibecode/skills/pskoett-self-improving-agent.md) — 408 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
