Правила для агентов по книгам о программировании

AI agents Rules / Skills from Programming Books

Скиллы и правила AGENTS.md по классическим книгам: Clean Code, Refactoring, DDD, Clean Architecture, DDIA и другим

СкиллНизкий риск

ciembor/agent-rules-books

Установка

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, субагенты и ревью кода

ПлагинСредний риск286,7 тыс.
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск262,1 тыс.
Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний риск136,8 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Выбор редакции

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,3 тыс.