Metadata-Version: 2.4
Name: s-issuekit
Version: 0.2.0
Summary: Как правильно составить жалобу (issue/feature/handoff агент→агент): шаблоны-данные + валидатор качества (каких полей чеклиста не хватает) для богатой обратной связи. Тонкий слой на clikit.
Author: Dmitry
License: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: s-clikit
Provides-Extra: dev
Requires-Dist: pytest>=8.3; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Description-Content-Type: text/markdown

# issuekit

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

## Зачем

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

## Установка

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

## CLI

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

## Библиотека

```python
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](LICENSE).
