AgentConfigScore CLI
Детерминированная проверка AGENTS.md и CLAUDE.md: сравнивает правку с базой и блокирует регрессии в CI без модели.
- 62 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Инструмент читает файлы инструкций и пишет конфигурацию и рабочий процесс CI после запуска `init`
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/agentconfigscoreОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Инструмент читает файлы инструкций и пишет конфигурацию и рабочий процесс CI после запуска `init`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AgentConfigScore локально проверяет файлы инструкций для агентов: `AGENTS.md`, `CLAUDE.md`, правила Cursor, Copilot и Gemini. Проверка идет по заданным правилам без обращения к модели и без зависимостей на рантайме. Инструмент сравнивает изменение с базовой веткой, показывает регрессии с идентификатором правила, пояснением и строкой файла, а решения для CI принимает по проверенным политикам базы. Пример из README: добавленная инструкция удаленной оболочки снижает оценку со 100 до 82, указывает на `AGENTS.md:5` и проваливает проверку новых ошибок. Команда `init` включает блокировку новых ошибок и запрет падения оценки, поэтому подключить проверку можно в репозитории, где оценка ниже 100.
Для кого. Тимлидам и мейнтейнерам репозиториев, где файлы инструкций для агентов правят через пулреквесты и их качество нужно контролировать.
Подходит, если
- В пулреквесте кто-то добавил небезопасную команду в `AGENTS.md`, и ее надо поймать до слияния
- Файл инструкций удалили или перевернули директиву, а числовая оценка осталась той же
- Известное исключение нужно принять с причиной, сроком и записью аудита
- В существующем репозитории оценка ниже 100, и блокировать нужно только новые ошибки
Не подходит, если
- Нужно судить, полезны ли инструкции и верны ли по смыслу: проверка покрывает только заданные правила
- Оценка 100 должна служить гарантией безопасности, а она означает лишь отсутствие сработавших правил
- Файлов инструкций в репозитории нет
Пример запроса к агенту
Прогони agent-config-score diff для этой ветки и объясни, какие правила дали регрессию и в какой строке `AGENTS.md`.Ограничения
Оценка 100 означает, что не сработало ни одно активное правило, но не доказывает полезность, смысловую верность и безопасность инструкций. Проверка опирается на заданные правила и не понимает смысл текста. Нужен Python с пакетом `agent-config-score`. Команда `init` создает `.agentconfigscore.json` и рабочий процесс `.github/workflows/agent-config-score.yml`, их проверяют и коммитят вручную. Инструкции агентов и конфликтующие файлы настройки она по умолчанию не перезаписывает. Проект небольшой, развивает его один автор, версии выходят часто.
Как отключить. Удалите `.agentconfigscore.json` и рабочий процесс `.github/workflows/agent-config-score.yml`, затем `python -m pip uninstall agent-config-score`.
Частые вопросы
Какие файлы проверяются?
`AGENTS.md`, `CLAUDE.md` и файлы инструкций Cursor, Copilot и Gemini. Проверка идет локально, без модели и без сетевых вызовов.
Что делает `init`?
Включает блокировку новых ошибок и запрет падения оценки, создает конфигурацию и рабочий процесс для CI. Сами инструкции агентов он не пишет.
Как принять известное исключение?
Подавление заводят с причиной и сроком действия, оно остается в видимой записи аудита. Свои исключения кандидат использовать не может, их берут из базы.
Достаточно ли оценки 100?
Нет. Она означает отсутствие сработавших правил и не подтверждает смысловую верность. Границы описаны в `docs/limitations.md`.
Можно ли сравнить с другой веткой?
Да. По умолчанию сравнение идет без загрузки, а `agent-config-score diff origin/main` берет явную ссылку.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛинтер обвязки агента проверяет AGENTS.md, CLAUDE.md, CI и хуки репозитория и выставляет оценку по шести направлениям.
CLI разбирает репозиторий шестифазным конвейером моделей и пишет AGENTS.md или CLAUDE.md; ведет планы ExecPlan с вехами.
Хартия на 2,4 КБ для CLAUDE.md и три скилла по вызову: агент проверяет результат и ждет подтверждения перед необратимым
Инструкции AGENTS.md и скиллы с тестовым процессом, который подстраивается под задачу, для Cursor, Codex CLI и Gemini CLI.
Скилл анализирует репозиторий и создает файлы для ИИ-агентов: AGENTS.md, указатели, рецензенты, CI и шаблоны
Agentic OS добавляет к ИИ-агенту пять шагов работы и проверки в хуках git и CI, чтобы шаг без доказательств не считался сделанным
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| AgentConfigScore (эта карточка) | нет | 62 | |
| AgentLint | нет | 156 | проверяет один набор правил; AgentConfigScore сравнивает изменение с базой и блокирует регрессии по политике |
| agnix | да | 479 | линтер конфигураций агентов; AgentConfigScore добавляет оценку, сравнение и аудит исключений |
Коротко о README
Проверка отвечает на вопрос, стало ли хуже. Падение оценки, новая ошибка и удаление файла инструкций дают отдельные находки, даже когда числа совпадают.