Правила для агентов по книгам о программировании
AI agents Rules / Skills from Programming Books
Скиллы и правила AGENTS.md по классическим книгам: Clean Code, Refactoring, DDD, Clean Architecture, DDIA и другим
Установка
npx skills add ciembor/agent-rules-books --allОдна книга: --skill refactoring вместо --all
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий содержит четырнадцать наборов правил, каждый по одной книге о проектировании, рефакторинге, легаси-коде, надежности и системах с большими данными. Каждый набор выпущен в трех размерах: full как полный справочник, mini для обычной работы и nano для тесного контекста. В папке каждой книги лежит SKILL.md, который по умолчанию подгружает mini, а full оставляет для сложных решений. Правила можно поставить как скиллы или вставить в AGENTS.md и правила Cursor.
Для кого. Для разработчиков и техлидов, которые хотят, чтобы агент писал код по принципам известных книг.
Подходит, если
- Агент пишет запутанный код и нужно задать ему правила чистого кода
- Нужно провести рефакторинг легаси-кода по проверенной методике
- Проектируете доменную модель и хотите опираться на DDD
Не подходит, если
- В команде свой стайлгайд, который противоречит этим книгам
- Контекст агента и так перегружен правилами
Пример запроса к агенту
Отрефактори этот модуль по правилам Working Effectively with Legacy Code, сначала закрой его тестамиОграничения
Правила пересказывают идеи книг и не заменяют их. Одновременное включение нескольких наборов может давать противоречивые советы, совместимость книг разобрана в отдельном документе. Правила на английском.
Как отключить. Удалите папки установленных скиллов из каталога скиллов агента или уберите правила из AGENTS.md.
Проверка безопасности
- Скиллы состоят только из текстовых правил
Коротко о README
README объясняет три версии каждого набора правил и показывает установку через Agent Skills CLI: все книги, список или одна выбранная. В таблице выпусков указаны объем и число правил для каждого размера. Отдельные документы описывают использование в разных редакторах, совместимость книг и разбор критики с Reddit. Лицензия MIT.
SKILL.md
--- name: clean-code description: Apply Robert C. Martin-inspired clean code rules when improving readability, naming, function design, responsibilities, or testable everyday code. license: MIT --- # Clean Code Skill Use this skill when a task involves everyday implementation quality, naming, small functions, readable control flow, responsibilities, comments, errors, or tests. Before making design or code decisions, read and apply [clean-code.mini.md](clean-code.mini.md). Use [clean-code.md](clean-code.md) only as a deeper reference when the mini rules are not enough for the current code-quality tradeoff.
Частые вопросы
Какой размер выбрать?
Для обычной работы mini, для очень тесного контекста nano, full как справочник.
Можно ли без npx?
Да, в docs/USAGE.md описана ручная установка и варианты для Codex, Claude Code и Cursor.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything