avandClaude Opus 5
885981ca39
Разделение плагинов оставлено, цена названа: пять симметричных контрактов в двух домах, два уже разошлись — форма журнала дефектов потеряла в копии поле «Причина», список читателей docs/research/ потерял specs. Оба раза копия выглядела актуальной и прошла мимо трёх ревью. scripts/copies.py требует побайтового совпадения текста между маркерами. Комментарии, а не манифест копий: маркер уезжает в репозиторий проекта вместе со скелетом и там полезен — говорит, что у текста есть дом. Идентификатор строгий и повторяется в закрывающем маркере. Иначе документация о самом механизме объявляет дом и роняет проверку: это случилось на первом же прогоне, README объявил дом примером. Ограда блока кода в сверку не входит: в доме текст обрамлён своей оградой, в скелете лежит внутри чужой, объемлющей. Помечены два контракта. Второй пришлось сперва сделать дословным: копия говорила «обязателен статус», дом — «обязателен статус „заменено на“». Проверка не ловит копию, которую забыли пометить, — это сказано вслух, иначе зелёный прогон читался бы как «копий больше нет». И не заменяет запись в журнал версий канона: она видит, что копия отстала, но не что проект унёс старую версию. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
67 lines
3.5 KiB
TOML
67 lines
3.5 KiB
TOML
[project]
|
|
name = "dev-skills"
|
|
version = "0"
|
|
description = "Маркетплейс плагинов av-dev; здесь только линтеры скриптов скиллов"
|
|
requires-python = ">=3.12"
|
|
dependencies = []
|
|
|
|
# Версии прибиты точно: обновление линтера меняет набор находок, а находки тут
|
|
# правятся руками в скриптах, которые уезжают в чужие проекты. Обновление —
|
|
# отдельная осознанная правка, а не побочный эффект `uv sync`.
|
|
[dependency-groups]
|
|
dev = ["ruff==0.16.1", "pyrefly==1.2.0"]
|
|
|
|
[tool.uv]
|
|
package = false
|
|
|
|
[tool.ruff]
|
|
target-version = "py312"
|
|
line-length = 88
|
|
# backlog.py заморожен: плагин помечен УСТАРЕЛ и живёт до перевода последнего
|
|
# проекта, после чего удаляется целиком. Правки в него — риск без выгоды.
|
|
exclude = ["av-dev-backlog"]
|
|
|
|
[tool.ruff.lint]
|
|
select = [
|
|
"F", # pyflakes: неиспользованное, неопределённое, битые f-строки
|
|
"E", "W",# pycodestyle
|
|
"I", # порядок импортов
|
|
"UP", # устаревшие для 3.12 конструкции
|
|
"B", # bugbear: изменяемый дефолт, забытый raise, цикл с замыканием
|
|
"SIM", # упрощения
|
|
"RET", # возвраты
|
|
"PTH", # os.path → pathlib
|
|
"RUF", # правила самого ruff
|
|
"TID", # запрет внешних зависимостей, см. banned-api ниже
|
|
"BLE", # голый except Exception — только там, где помечен noqa
|
|
]
|
|
ignore = [
|
|
"E501", # длину строк держит formatter, а не проверка
|
|
# Весь текст скриптов — русский: сообщения, докстроки, комментарии.
|
|
# «Похожая на латиницу кириллица» здесь не опечатка, а норма, и три этих
|
|
# правила дают 311 срабатываний из 338 на пустом месте.
|
|
"RUF001", "RUF002", "RUF003",
|
|
]
|
|
|
|
[tool.ruff.lint.flake8-tidy-imports.banned-api]
|
|
# Скрипты обязаны работать на голом python 3.12 без установки чего-либо:
|
|
# они лежат рядом со скиллами и запускаются в любом проекте. Список — не
|
|
# полный перечень мира, а частые соблазны; настоящий страж — pyrefly, у
|
|
# которого в окружении нет ничего, кроме линтеров.
|
|
"requests".msg = "внешняя зависимость; скрипты работают на голом python 3.12"
|
|
"yaml".msg = "внешняя зависимость; для json есть stdlib, для yaml — разбор руками"
|
|
"pydantic".msg = "внешняя зависимость; скрипты работают на голом python 3.12"
|
|
"click".msg = "внешняя зависимость; аргументы разбирает argparse"
|
|
"rich".msg = "внешняя зависимость; вывод — обычный print"
|
|
|
|
[tool.ruff.format]
|
|
quote-style = "double"
|
|
|
|
[tool.pyrefly]
|
|
project-includes = [
|
|
"av-dev-pm/skills/tasks/scripts/tasks.py",
|
|
"av-dev-pm/skills/canon/scripts/docs.py",
|
|
"scripts/copies.py",
|
|
]
|
|
python-version = "3.12"
|