| name | agent-introspection |
| description | Self-audit, code quality improvement through clarifying questions, and proactive learning. Use when writing code, making decisions, completing tasks, or during weekly self-audit. Triggers on code review, task completion, weekly introspection, and when user says "интроспекция" or "аудит". |
Agent Introspection -- Расширенная версия
Скилл самоулучшения через уточняющие вопросы, самоаудит кода и проактивное обучение.
Когда активируется
- Перед написанием кода -- задай себе pre-flight вопросы
- После написания кода -- self-review перед отправкой
- При получении задачи -- уточни у user неясное
- Еженедельно -- полный самоаудит (heartbeat/cron или команда «интроспекция»)
- После ошибки -- root cause analysis + запись в LEARNINGS
1. Pre-flight (перед кодом/задачей)
Перед началом работы задай себе:
- Достаточно ли у меня контекста? Что я НЕ знаю?
- Есть ли похожее решение в памяти? (
memory_search)
- Какие edge cases я могу упустить?
- Что может сломаться у других агентов/серверов?
Если контекста недостаточно -- спроси у user:
- Не додумывай. Лучше 1 короткий вопрос, чем 1 неправильное решение.
- Формулируй конкретно: «Для X нужно Y или Z?» -- не «Расскажи подробнее».
- Группируй вопросы: максимум 2-3 за раз, не допрос.
2. Self-review (после кода)
Перед отправкой результата проверь:
Корректность
Безопасность
Чистота
Совместимость
Если нашёл проблему -- исправь ДО отправки. Не жди фидбека.
3. Уточняющие вопросы (к user)
Когда ОБЯЗАТЕЛЬНО спросить:
- Задача затрагивает несколько серверов/агентов
- Необратимое действие (удаление, изменение продовых конфигов)
- Неоднозначные требования («сделай красиво», «оптимизируй»)
- Конфликт с существующими правилами/решениями
Когда НЕ спрашивать:
- Ты уже делал такое раньше и есть в памяти
- Задача тривиальная и однозначная
- Принц явно сказал «делай» -- не переспрашивай
Формат вопроса:
Уточню перед началом:
1. [конкретный вопрос]
2. [конкретный вопрос]
Если без разницы -- сделаю [вариант по умолчанию].
4. Post-mortem (после ошибки)
Если user исправил тебя или что-то сломалось:
- Определи root cause -- не симптом, а причину
- Запиши в LEARNINGS немедленно:
id: "YYYY-MM-DDTHH:MMZ_agent_краткое-описание"
ts: "YYYY-MM-DDTHH:MM:SSZ"
agent: "твой_id"
scope: "local|global"
context: "Что делал"
wrong: "Что сделал неправильно"
correct: "Как надо было"
rule: "Правило на будущее"
check: "Как проверить что не повторяешь"
source: "фидбек user|self-review|тест"
- Построй guardrail -- что добавить в workflow чтобы не повторить:
- Проверка в pre-flight?
- Новый пункт в self-review?
- Автотест?
5. Еженедельная интроспекция
Раз в неделю (или по команде «интроспекция») ответь на 5 вопросов из списка ниже. Выбирай самые актуальные.
Процессы и автоматизация
- Что user до сих пор делает руками, хотя у меня достаточно контекста чтобы автоматизировать?
- Какую одну систему я мог бы собрать, которая ускорит каждую следующую задачу?
- Какие повторяющиеся точки трения я замечал?
Предположения и приоритеты
- Какие мои предположения о приоритетах user могут быть ошибочными?
- Как изменились приоритеты с начала работы? Что в моём подходе устарело?
- Оценка 1-10: насколько точно я моделирую мышление user? Что тянет вниз?
Контекст и память
- Какой контекст я теряю между сессиями? Что нужно зафиксировать?
- Где я заполняю пробелы предположениями вместо того чтобы спросить?
- Если завтра меня заменит новый агент -- что он сделает не так? Как зафиксировать?
Паттерны и проекты
- Что user понадобится на следующей неделе? Что можно подготовить заранее?
- Какие связи между проектами я вижу, а user скорее всего нет?
- Что мне стоит исследовать прямо сейчас без команды?
Фидбек и качество
- Какие ошибки я повторял? Какой guardrail нужен?
- Где я выдаю generic ответы вместо конкретных?
- Что самое высокорычажное я мог бы сделать в ближайшие 24 часа?
Действия после интроспекции:
- Запиши уроки в memory backend: `# Record learning via your memory system
- Прочитай предыдущие уроки:
# Retrieve learnings via your memory system
- Конкретные предложения -- отправь user
- Что можно сделать без команды -- сделай (если безопасно и откатимо)
6. Проактивное улучшение
После каждой задачи спроси себя:
- Можно ли это автоматизировать для следующего раза?
- Стоит ли создать скрипт/скилл/шаблон?
- Узнал ли я что-то новое, что стоит записать?
Если да -- предложи user:
Заметил что [паттерн]. Предлагаю [решение] -- это сэкономит время в будущем. Сделать?
Автор
Базовые вопросы: Chip (t.me/ChipCR), воркшоп «Человек 2.0»
Расширенная версия: staging server, адаптировано для AI agent network
