AI Agent Handbook CLI
AI Agent Handbook оценивает агентный проект по пяти опорам надежности и ведет к нужным главам руководства из 31 главы
- 73 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Читает код проекта статически и выводит отчет, `handbook new` создает файлы заготовки агента в указанной папке
Установка
- Работает в
Ручная установка
uvx agent-handbook doctor .Запуск без установки. Другие способы: pipx run agent-handbook doctor . или pip install agent-handbook.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Читает код проекта статически и выводит отчет, `handbook new` создает файлы заготовки агента в указанной папке
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий объединяет руководство на китайском языке из 31 главы и командную утилиту. Команда `uvx agent-handbook doctor .` статически сканирует код проекта и ставит оценку от 0 до 10 по пяти опорам, которые руководство называет главными для выхода агента в продакшен: границы задачи, управление контекстом, сохранение состояния, восстановление после сбоев и система прав. В отчете указано, какой опоры не хватает и какую главу читать. Утилита умеет больше проверки. `handbook doctor . --md` выводит отчет таблицей Markdown для `issue` или README, `handbook search` ищет по тексту всех глав и дает номер главы, строку и фрагмент, `handbook new my-agent` создает заготовку агента с пятью опорами, `handbook list`, `handbook stars` и `handbook open 25` показывают список глав и открывают нужную. Утилита работает без зависимостей, на стандартной библиотеке, и без сети: главы поставляются вместе с пакетом. Среди глав есть темы вроде ReAct и LangGraph, CrewAI, MCP, управления памятью, затрат на токены, эвалюации, написания `SKILL.md`. Для CI предусмотрено действие GitHub: `Xwh630/ai-agent-handbook@main` с порогом `min-score` оставляет отчет в комментарии к `pull` `request` и валит шаг при низкой оценке. В составе есть пакет скилла `skills/agent-handbook/SKILL.md`, который подключает руководство к агенту, и 11 запускаемых примеров.
Для кого. Разработчикам, которые довели агента до демонстрации, но он ненадежен в продакшене, и тем, кто хочет читать по-китайски практическое руководство по агентным системам.
Подходит, если
- Агент падает на реальных данных, и нужен быстрый чек-лист по пяти опорам с оценкой и номерами глав
- В CI хочется отклонять изменения, которые снижают балл надежности агента, и получать отчет прямо в `pull` `request`
- Нужно найти в 31 главе место о сжатии контекста или стоимости токенов, не листая весь текст
- Требуется заготовка нового агента, в которой пять опор уже есть
Не подходит, если
- Нужен отчет по безопасности кода: утилита оценивает архитектурные опоры агента и уязвимости не ищет
- Нужны материалы на русском или английском: руководство китайское, английский перевод охватывает 4 из 31 главы
- Проект не про агентов: оценка рассчитана на агентные проекты
Пример запроса к агенту
Запусти uvx agent-handbook doctor . в этом проекте, покажи оценку по пяти опорам и посоветуй главы для самой слабойОграничения
- Руководство написано по-китайски, английский перевод охватывает 4 из 31 главы на момент README, русского нет.
- Оценка статическая: утилита читает код и ищет признаки опор, поведение агента во время работы она не проверяет.
- Пять опор отражают взгляд автора руководства, их нельзя считать отраслевым стандартом.
- Для запуска без установки нужен uv, иначе используйте `pipx run` или `pip install agent-handbook`.
Как отключить. Если ставили через pip, выполните pip `uninstall` agent-handbook. Запуск через `uvx` ничего не устанавливает постоянно. Шаг GitHub Action убирается из `workflow`. Скилл `skills/agent-handbook/` удаляется удалением папки из каталога навыков агента.
Частые вопросы
Как проверить агентный проект командой doctor?
Выполните `uvx agent-handbook doctor .` в корне проекта. Утилита ставит оценку от 0 до 10 по пяти опорам и подсказывает, какую главу читать. Установка не нужна, подойдет и `pipx run agent-handbook doctor .`.
Какие пять опор?
Границы задачи, управление контекстом, сохранение состояния, восстановление после сбоев и система прав. Подробно они описаны в главе 25 о Harness Engineering.
Как подключить проверку к CI?
Добавьте в `workflow` шаг `uses: Xwh630/ai-agent-handbook@main` с параметром `min-score: 6`. Шаг падает при оценке ниже порога, отчет попадает в комментарий к `pull` `request` и в Job Summary.
Можно ли искать по главам руководства?
Да, `handbook search` ищет по тексту всех 31 главы и показывает главу, строку и фрагмент. Утилита работает офлайн, главы лежат внутри пакета.
Есть ли скилл для агента?
Да, в `skills/agent-handbook/SKILL.md` лежит пакет, который подключает руководство к агенту. Каталог скилла копируют в папку навыков агента, чтобы он мог обращаться к главам.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыМногоагентная обвязка с проверкой результата по артефактам: стоп-хуки, независимый судья и журнал событий для Claude Code, Codex, Cursor и других
Каталог из почти двухсот скиллов: доставка кода, ревью, отладка, управление ИИ, продуктовая работа и координация агентов.
Команда /better-harness разбирает, как устроена работа ИИ-агента в проекте: цели, проверки, поставка и память. На выходе отчет с приоритетными правками
Открытый кодовый агент для терминала, браузера и десктопа, который работает с моделями от OpenAI и Claude до Ollama
Консольная утилита LangWatch, которая создает каркас нового проекта ИИ-агента и передает его ассистенту для кода
Awesome Agent Skills (libukai)
awesome-agent-skills-libukai
Путеводитель по Agent Skills от старта до инструментов на китайском и английском, с отобранными скиллами. Лицензии нет
Коротко о README
README подает проект как китайскоязычное руководство в 31 главу плюс утилиту, которая оценивает агентный проект. Раздел «30 секунд» показывает запуск `doctor`, таблицу команд и действие для CI. Затем таблица ситуаций сопоставляет проблемы вроде взрыва затрат на токены с главами, даны три маршрута чтения и оглавление всех глав. В конце идут радар недельных обзоров, запуск примеров, правила участия и сведения о проекте, который ведет студент.