Harness Handbook — скилл

Установка

Работает в

• Codex
• Claude Code
• Koda
• Coddy

npx skillfoxx add skills/harness-handbook

Что делает

Harness Handbook делает из исходного кода структурированную карту по этапам в markdown и необязательном HTML. Навык `build-codebase-handbook` лежит в `.agents/skills/`, а три папки разделяют работу: `handbook_generate_large/` для крупных кодовых баз, `handbook_generate_small/` для малых и `handbook_as_helper/`, где книга подключается к планировщику агента и измеряется, насколько точнее он находит места правок. Статический анализ идет через tree-sitter, остальные фазы обращаются к модели через совместимый с OpenAI интерфейс. Примеры: Handbook Studio для просмотра книги и готовая книга по Terminus 2. Описание ведется на английском, китайском и русском языках.

Для кого. Разработчикам, у которых агент правит большой незнакомый проект и пропускает связанные места, и исследователям качества локализации правок.

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

Построй книгу по этому репозиторию по этапам и покажи, какие места затрагивает изменение формата конфигурации.

Ограничения

Генерация книги вызывает модель на каждом этапе, кроме статического анализа, поэтому расходует токены и отправляет фрагменты кода выбранному провайдеру. Нужен Python с tree-sitter и несколькими пакетами, а также доступ к API, совместимому с OpenAI. Результат нужно сверять с кодом. Для крупных кодовых баз генерация занимает много времени и вызовов модели, а устаревшую книгу нужно пересобирать после заметных изменений кода.

Как отключить. Удалите склонированную папку, виртуальное окружение `.venv` и навык из `.agents/skills/`. Созданные книги лежат в выходных папках, удалите их отдельно.

Коротко о README

Книга разбивает код на этапы, а помощник подключает ее к планировщику агента и сравнивает точность поиска мест правок с книгой и без нее.