issuekit

⚠️ ЗАМОРОЖЕН (2026-09-08, Atlas #2710, волна 5). Единственный потребитель — atlas — больше не тянет этот пакет с PyPI: код физически перенесён в atlas._vendor.issuekit (спека платформы, «по одному потребителю → модуль Atlas»). Этот репозиторий и код в нём не удалены и остаются рабочими — кит просто больше не развивается активно здесь. Если появится второй независимый потребитель — код можно расформировать обратно в отдельный кит (обе копии сейчас идентичны на момент заморозки). Новые правки самого issuekit (не atlas) ведите осторожно: копия в atlas их не подхватит автоматически.

Как правильно составить жалобу — и валидатор качества. Переиспользуемый слой (dist s-issuekit / import issuekit) поверх clikit. Три вида жалоб как ДАННЫЕ: bug / feature / handoff (передача задачи агент→агент). Машинная проверка lint говорит, каких полей чеклиста не хватает — основа богатой обратной связи в мультиагентной работе.

Зачем

Разница между жалобой, которую чинят за 5 минут, и той, что висит месяцами — не в сложности бага, а в оформлении. issuekit кодирует чеклист (версии / минимальный пример / traceback / ожидал-vs-получил / для фич — юзкейс) и проверяет его автоматически. В Atlas на этом строится блокирующая дисциплина передачи задач между агентами.

Установка

pip install s-issuekit        # import issuekit (dist-имя ≠ import-имя)

CLI

issuekit kinds                          # виды + обязательные секции
issuekit new --kind handoff --title "…" # пустой шаблон → заполнить
issuekit lint myissue.md --kind bug     # проверка: чего не хватает + балл
cat issue.md | issuekit lint -k feature

Библиотека

from issuekit import lint, new_template, list_kinds

tpl = new_template("handoff", title="Доделать миграцию")
res = lint(text, "handoff")     # res.ok (все required заполнены), res.score, res.missing
if not res.ok:
    print("не хватает:", res.missing)

Виды и обязательные секции

• bug: что сломалось · ожидал · получил · версии · минимальный пример · полный traceback.
• feature: задача (юзкейс) · желаемый результат.
• handoff: что сделано · что осталось · ожидаемый результат (ЦКП) · как проверить · контекст и версии.

Расширить виды без правки кита — запись в data/kinds.json или entry-points issuekit.kinds.

Навык

Несёт навык skills/issuekit/SKILL.md — «как зарепортить проблему, чтобы вас не возненавидели» (как правильно / антипаттерны).

Лицензия

MIT.