Правила
Правило — это предложение, которому вы хотите, чтобы агент следовал. bee хранит его, а хуки доставляют — в начале сессии, на каждом запросе или на том файле, о котором оно.
bee hook rule add "не вызывай GetCollection напрямую — используй DataSource"bee hook rule listbee hook rule rm <id>Область — когда правило доставляется
Заголовок раздела «Область — когда правило доставляется»bee hook rule add "<текст>" --scope always|session|prompt|file| область | доставка |
|---|---|
always (по умолчанию) |
в начале сессии и на каждом запросе |
session |
один раз, в начале сессии |
prompt |
на каждом запросе |
file |
только когда пишется подходящий файл — см. ниже |
Правила по путям — те, что экономят токены
Заголовок раздела «Правила по путям — те, что экономят токены»Правило может назвать файлы, о которых оно:
bee hook rule add "DataSource никогда не вызывает GetCollection" --path '*DataSource.cs'bee hook rule add "у каждого компонента есть тест Vitest" --path 'src/**/*.vue'--path подразумевает пофайловую доставку. И в этом весь смысл: правило,
называющее файлы, полностью исключается из блока, идущего каждый ход. Пятьдесят
ходов, не касающихся ничего релевантного, перестают за него платить, а тот один,
который касается, получает его не погребённым под неприменимыми правилами.
Синтаксис glob
Заголовок раздела «Синтаксис glob»Намеренно в стиле gitignore, потому что это нотация, которую люди уже знают:
| шаблон | совпадает с |
|---|---|
*DataSource.cs |
этим именем файла где угодно в дереве |
src/**/*.vue |
любым .vue внутри src/, на любой глубине |
deploy/** |
всем внутри каталога |
src/*.cs |
только непосредственно в src/ — * останавливается на / |
Сопоставление без учёта регистра: автор правила описывает соглашение, а не адресует inode.
Область проекта
Заголовок раздела «Область проекта»По умолчанию правило направляет только этот проект — он определяется по git remote, поэтому та же копия на другой машине — тот же проект. Чтобы направлять всё:
bee hook rule add "сообщения коммитов на английском" --globalАвторство
Заголовок раздела «Авторство»Каждое правило запоминает, кто его написал; имя читается из конфигурации самого
git (локальная для репозитория личность важнее глобальной). В общем хранилище
bee hook rule list скажет вам, чьему соглашению вы следуете.
Сколько это стоит
Заголовок раздела «Сколько это стоит»bee budgetРазбивает добавляемый контекст по компонентам — для начала сессии и для примерного запроса. Если набор правил стал дорогим, это видно здесь.