agent-introspection
Skill4 starsChanged 4 months agoMITView on GitHub
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 "аудит".
1 other project uses a version of this.
Adopted by
Most recently taken up by
- epicsagas/epic-harnesstheir own version, first seen Sep 4, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- epicsagas/epic-harness★ 20same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository43 other files it gives its agents.
- agent-browserSkill
- agentos-contentSkill
- carousel-instagramSkill
- chat-archiveSkill
- codex-imageSkill
- content-engineSkill
- cross-reviewSkill
- datawrapperSkill
- dev-pipelineSkill
- excalidrawSkill
- fast-loop-codingSkill
- groq-voiceSkill
- higgsfield-generateSkill
- higgsfield-marketplace-cardsSkill
- higgsfield-product-photoshootSkill
- higgsfield-soul-idSkill
- instagram-superpowerSkill
- learningsSkill
- loop-codingSkill
- markdown-newSkill
- mcp-api-buildSkill
- mcp-builderSkill
- memory-auditSkill
- miro-boardSkill
- perplexity-researchSkill
- presentSkill
- reel-radarSkill
- reels-analytics-for-brokersSkill
- reelsSkill
- remote-agent-desktopSkill
- security-auditSkill
- senior-brainstormSkill
- seo-tuneSkill
- server-doctorSkill
- telegram-chipSkill
- threads-contentSkill
- topic-monitorSkill
- transcriptSkill
- twitterSkill
- workshopSkill
- youtube-producerSkill
- youtube-thumbnailSkill
- yt-researchSkill
The file
Files
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 (после кода)
Перед отправкой результата проверь:
Корректность
- Код делает то, что просили (не больше, не меньше)
- Edge cases обработаны
- Ошибки ловятся, не глотаются
Безопасность
- Нет секретов в коде/выводе
- Деструктивные операции защищены (бэкап, trash вместо rm)
Чистота
- Нет дублирования с тем, что уже есть
- Имена переменных/функций понятны
- Комментарии только где неочевидно
Совместимость
- Не ломает конфиги других агентов
- JSON валидный (проверил через python3 -c "import json; ...")
- Рестарт сервиса предусмотрен если нужен
Если нашёл проблему -- исправь ДО отправки. Не жди фидбека.
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
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

