Как правильно составить жалобу (issue/feature/handoff агент→агент): шаблоны-данные + валидатор качества (каких полей чеклиста не хватает) для богатой обратной связи. Тонкий слой на clikit.
Project description
issuekit
Как правильно составить жалобу — и валидатор качества. Переиспользуемый слой
(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.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file s_issuekit-0.1.0.tar.gz.
File metadata
- Download URL: s_issuekit-0.1.0.tar.gz
- Upload date:
- Size: 48.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6ee6dacc2617784c6237e14c44716b4486e93477de1e2e7a5c96b8806b406cf5
|
|
| MD5 |
a62b6ba7e409e3b40ca57a7e3097aeb9
|
|
| BLAKE2b-256 |
21069a2039e4d5cbeb6000d86f955adac9988d73df036c6fa50cbc49598d467c
|
File details
Details for the file s_issuekit-0.1.0-py3-none-any.whl.
File metadata
- Download URL: s_issuekit-0.1.0-py3-none-any.whl
- Upload date:
- Size: 11.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e7c168ced0204076538dc09a769b84fc108ffb1fb51c01a5d2897b7dd7d2684b
|
|
| MD5 |
69a13b9bc7d84a2a8031a11c992936d7
|
|
| BLAKE2b-256 |
3e7e56eff4ddb112a31b7b62188e38b354ccfe05b5a0074fc458d90e2a7d0361
|
