AIKraft/AI/Войти
AIKraft/Skills/agent-md-refactor

agent-md-refactor

Рефакторит перегруженные файлы инструкций агентов (AGENTS.md, CLAUDE.md) по принципу прогрессивного раскрытия. Разбивает монолитные файлы на структурированную связанную документацию. Полезно при оптимизации инструкций для ИИ-агентов.

softaworks official Документы ★ 2.5k

Что делает навык

Навык рефакторит перегруженные файлы инструкций агентов (AGENTS.md, CLAUDE.md, COPILOT.md) по принципу прогрессивного раскрытия, разделяя их на минимальный корневой файл и связанные тематические документы. Это решает задачу оптимизации контекста и улучшения поддерживаемости конфигураций ИИ-агентов.

Когда применять

  • Когда пользователь просит рефакторить или очистить файл AGENTS.md или CLAUDE.md
  • При необходимости разделить монолитные инструкции агента на логические части
  • Если файл инструкций стал слишком длинным и сложным для навигации
  • Для организации инструкций с использованием принципа прогрессивного раскрытия

Как работает

  1. Найти и запросить у пользователя разрешение на разрешение всех противоречий в инструкциях
  2. Выделить из исходного файла только универсальные Essentials (описание проекта, менеджер пакетов, критические оверрайды) для корневого файла
  3. Сгруппировать оставшиеся инструкции по логическим категориям (например, typescript, testing, code-style, git-workflow)
  4. Создать структуру файлов с корневым файлом-шаблоном и связанными файлами с правилами и примерами
  5. Отфильтровать и пометить для удаления избыточные, слишком общие или устаревшие инструкции

Примеры запросов агенту

refactor my AGENTS.md
split my agent instructions
my CLAUDE.md is too long

Описание составлено по SKILL.md навыка, сверено 07.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «agent-md-refactor» из репозитория: # https://github.com/softaworks/agent-toolkit
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r agent-md-refactor/ ~/.claude/skills/agent-md-refactor/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.