Repository navigation
v0.14.0
Выпуск про одно: от диагноза — к действию. aqk prompt пишет агенту готовое задание с
командой-арбитром у каждого пункта; находки гейтов видны пометками прямо в pull request; learn
показывает, что вам приходится повторять агенту, — прежде всего правило, которое уже записано и
всё равно не держится. Закрыт остаток отзыва с живого проекта: договор API в коде, язык вывода
по своду, «чего уровень не доказывает», короткий doctor. Новая запись каталога
entry-commands-exist — команды из свода существуют (9 из 99 публичных репозиториев с AGENTS.md
велят скрипт, которого нет).
Что может выглядеть иначе после обновления: doctor по умолчанию короче — пройденное и
неприменимое свёрнуты в строку, поимённо по --verbose или AQK_VERBOSE=1; без поля lang: язык
вывода берётся из AGENTS.md/CLAUDE.md/README.md, а не из локали машины; в GitHub Actions
упавшие гейты печатают строки ::error/::warning — это пометки для pull request, вердикт от них
не меняется; под уровнем от AQK-1 — две строки о том, чего он не доказывает.
Добавлено
-
Самопроверка на наборе настоящих случаев (
tool/selfcheck/smoke/corpus.test.mjs). Десять
минимальных воспроизведений того, что мы видели на живых проектах, в журнале и в разборах
соседей — у каждого назван источник и записан ожидаемый ответ: близнецы с настоящими и
поддельными воротами, свод с удалённым скриптом, договор в коде сtscи без,CLAUDE.mdс
windows-переносами, русский свод безLANG, определения записей, разложенные в проект. На
каждом случае все 24 переносимые записи обязаны ответить «чисто» или «находка», а не «не
смогли». Семь секунд; три нарочно испорченных ожидания — три красных -
Находки гейтов — пометками прямо в pull request. В GitHub Actions упавший гейт, чья
находка называет файл, даёт красную пометку у этой строки дифа вместе со своим «почини: …»;
совещательный — жёлтую; находка без файла — общую пометку гейта. Не больше десяти каждого вида
за прогон, остаток — числом в логе. Формат сверен с документацией GitHub, экранирование — с
официальным@actions/core. Идея — из разбора AgentLint, у которого пометки есть, но на
близнецах их проверки одинаковы для рабочих и нерабочих ворот -
learnпоказывает, что вам пришлось повторять. Реплики, где вы сами сказали «я же
говорил», «опять», «снова», идут первым блоком; такая реплика, совпавшая с правилом свода, —
отдельно: «записано, а поправлять всё равно приходится», правилу нужен сторож. Идея — из разбора
AgentLint (их SS2 сопоставляет поправки с правилами по словам). Замер на логах владельца
отверг их способ: из 45 поправок к записанным правилам относятся от силы две. Пометка повтора
самим человеком оказалась надёжнее: на двух проектах 8 таких реплик, настоящих норм 7, а
прежний отбор по словам «всегда»/«никогда» не ловил ни одной. «Опять» в вопросе («че опять
rust?») — недоумение, а не норма, и не считается -
aqk prompt— одно задание для агента. Между диагнозом и действием не было моста:
doctorпишет человеку,contextговорит агенту «как дела», а «почини вот это» человек
пересказывал сам. Теперь сверху — правила поведения (команды не выдумывать, чинить код, а не
проверку, решения владельца — спрашивать), дальше до пяти пунктов по весу: красные гейты, брак,
подсаженный пробой и не пойманный, свои проверки проекта, свод, невидимый Claude Code, записи
каталога — эти как предложение владельцу, а не приказ. У каждого пункта — команда, которая
докажет «готово». Прогона не было или он устарел — первым пунктом «прогони», а не пустое
«всё чисто». Идея из разбора agentlint; их «проверь» — «балл вырос», у нас — команда-арбитр -
Запись
entry-commands-exist: команды из свода существуют в проекте. Агент берёт команды
из свода дословно; скрипт удалили — свод продолжает велеть «npm run lint:cli». Замер на 99
публичных репозиториях сAGENTS.md: в 9 свод называет скрипт, которого нет ни в одном
package.json; в двух история показывает механизм — скрипт удалён, строка в своде осталась.
Сверяютсяnpm|pnpm|yarn|bun run X(блок"scripts"всехpackage.json),make X(цели всех
Makefile),just X(justfile).makeиjust— только внутри кода: «make sure» не
команда. У соседа, agentlint, то же правило знает только npm — на живом проекте с шестнадцатью
целямиmakeв своде оно молчит по построению -
doctorназывает свод, которого не видит Claude Code. Документация Claude Code: «reads
CLAUDE.md, not AGENTS.md». Проект с.claude/и сводом только вAGENTS.md— или с
CLAUDE.md, которыйAGENTS.mdне подключает, — получает строку с готовой починкой:
@AGENTS.mdвCLAUDE.md. Где Claude Code не настроен, строки нет: Codex и Cursor читают
AGENTS.mdсами
Исправлено
- Договор API в коде больше не невидим. Отзыв с живого проекта: схемы zod в общем пакете,
сервер на@fastify/type-provider-zod— аdoctorписал «спецификации API не видно»,
потому что знал договор только по имени файлаopenapi*. Теперь договором считается и
зависимость вpackage.json: tRPC, ts-rest,@hono/zod-openapi, провайдеры типов Fastify.
Арбитр такого договора — проверка типов;api-contract-has-arbiterкраснеет, еслиtsc
(vue-tsc,tsgo) не запускает ни одна команда. Одинzodдоговором не считается.
На том же проекте запись теперь применима и зелёная:tsc --buildстоит вscripts - Язык вывода — по языку проекта, а не машины. Отзыв с живого проекта: свод и методички на
русском, Windows безLANG— весь вывод английский, пока не впишешьlang:руками. Теперь
без поляlang:язык берётся из прозыAGENTS.md,CLAUDE.mdиREADME.md(код, пути и
адреса не считаются), и только если текст молчит — из локали.AQK_LANGиlang:сильнее - Под уровнем стоит, чего он не доказывает. Отзыв с живого проекта: «AQK-3, All levels
reached» при конвейере, который ни разу не запускался. Ступени меряют оснащённость — гейты
показаны на образцах каталога; про файлы проекта знает только проба. Теперь при уровне от
AQK-1doctorпишет две строки: что проба знает о браке в ваших файлах (не запускалась · не
поймала такие-то классы · поймала все подсаженные) и что прохождение конвейера отсюда не
видно. Проба записывает в отметку, сколько классов поймано и у скольких поимка не доказана.
Планку ступеней не подняли: отметка пробы в.gitignore, в конвейере её нет — «AQK-2 только
после пробы» уронило бы уровень иbadge --checkу всех разом doctorкороче по умолчанию, поимённо — по--verbose. Отзыв с живого проекта: сто
строк вывода, большая часть — зелёные галочки, и красное теряется между ними. Теперь прошедшие
гейты, записи, которые держит машина, и неприменимые сворачиваются в строку со счётом;
упавший, совещательный, совет и «что поставить» видны всегда. На этом репозитории без--run
— 49 строк вместо 75, под--runтридцать зелёных строк становятся одной. В конвейере —
AQK_VERBOSE=1
npx agent-quality-kit doctor