Skip to content

v0.14.0

Choose a tag to compare

@github-actions github-actions released this 11 Sep 12:15
· 125 commits to main since this release
78be90a

Выпуск про одно: от диагноза — к действию. 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-1 doctor пишет две строки: что проба знает о браке в ваших файлах (не запускалась · не
    поймала такие-то классы · поймала все подсаженные) и что прохождение конвейера отсюда не
    видно. Проба записывает в отметку, сколько классов поймано и у скольких поимка не доказана.
    Планку ступеней не подняли: отметка пробы в .gitignore, в конвейере её нет — «AQK-2 только
    после пробы» уронило бы уровень и badge --check у всех разом
  • doctor короче по умолчанию, поимённо — по --verbose. Отзыв с живого проекта: сто
    строк вывода, большая часть — зелёные галочки, и красное теряется между ними. Теперь прошедшие
    гейты, записи, которые держит машина, и неприменимые сворачиваются в строку со счётом;
    упавший, совещательный, совет и «что поставить» видны всегда. На этом репозитории без --run
    — 49 строк вместо 75, под --run тридцать зелёных строк становятся одной. В конвейере —
    AQK_VERBOSE=1
npx agent-quality-kit doctor