Add a proper-description procedure to the issue skill #9

New Issue

2026-08-09T19:08:39Z

claude commented

2026-08-09 19:08:39 +00:00

Summary

Добавить в /tea:issue процедуру «proper description»: взять существующий
issue, добрать недостающий контекст из репозитория и переписать тело в
формальное описание по канону references/format.md.

Spec

skills/issue/references/format.md

Motivation

Issue заводят на бегу: «не подтягиваются комментарии», «сломался гвард». Такой
текст — заявка, а не постановка: нет шагов воспроизведения, нет ссылок на
path/file:line, acceptance criteria не проверяемы. Дальше либо исполнитель
тратит контекст на то же самое расследование, либо issue уходит в трекер
недоописанным.

Разбор одинаковый каждый раз — значит, это процедура, а не импровизация: найти
в коде места, о которых говорит issue; определить, чего не хватает по шаблону
типа; переписать разделы; проверить issue_check.py. Место ей рядом с
Creating и Editing в skills/issue/SKILL.md — отдельный скилл здесь плодить
нечего.

Процедура работает с файлом tmp/issues/<id>.md и потому одинакова для
origin: local и origin: gitea: доменный слой не различает эти случаи. Что
переписанное тело надо доставить в трекер (push.py --update) — уже забота
/tea:sync, и в самой процедуре её не описываем.

Acceptance criteria

в skills/issue/SKILL.md есть раздел с процедурой, оформленный как
пронумерованные шаги: прочитать issue → определить тип и его шаблон →
найти опорные места в коде → добрать контекст → переписать разделы →
issue_check.py
в разделе явно сказано, что процедура одинакова для origin: local и
origin: gitea и что доставка изменений в трекер к ней не относится
перечислено, что считается недостающим контекстом: ссылки
path/file:line, шаги воспроизведения, проверяемые acceptance criteria,
значение ## Spec (путь, URL или none)
зафиксировано правило: недостающий факт либо находится в репозитории,
либо становится вопросом пользователю — выдумывать нельзя, none в
## Spec остаётся законным ответом
результат процедуры проходит issue_check.py без ошибок
skills/issue/scripts/ не пополняется — процедура не требует нового
скрипта

Constraints

Не входит в объём: автоматическая правка issue без участия человека и любые
изменения формата в references/format.md.
Оффлайн: процедура не обращается к трекеру, не читает gitea: и не зависит
от наличия skills/sync/.

## Summary Добавить в `/tea:issue` процедуру «proper description»: взять существующий issue, добрать недостающий контекст из репозитория и переписать тело в формальное описание по канону `references/format.md`. ## Spec `skills/issue/references/format.md` ## Motivation Issue заводят на бегу: «не подтягиваются комментарии», «сломался гвард». Такой текст — заявка, а не постановка: нет шагов воспроизведения, нет ссылок на `path/file:line`, acceptance criteria не проверяемы. Дальше либо исполнитель тратит контекст на то же самое расследование, либо issue уходит в трекер недоописанным. Разбор одинаковый каждый раз — значит, это процедура, а не импровизация: найти в коде места, о которых говорит issue; определить, чего не хватает по шаблону типа; переписать разделы; проверить `issue_check.py`. Место ей рядом с Creating и Editing в `skills/issue/SKILL.md` — отдельный скилл здесь плодить нечего. Процедура работает с файлом `tmp/issues/<id>.md` и потому одинакова для `origin: local` и `origin: gitea`: доменный слой не различает эти случаи. Что переписанное тело надо доставить в трекер (`push.py --update`) — уже забота `/tea:sync`, и в самой процедуре её не описываем. ## Acceptance criteria - [x] в `skills/issue/SKILL.md` есть раздел с процедурой, оформленный как пронумерованные шаги: прочитать issue → определить тип и его шаблон → найти опорные места в коде → добрать контекст → переписать разделы → `issue_check.py` - [x] в разделе явно сказано, что процедура одинакова для `origin: local` и `origin: gitea` и что доставка изменений в трекер к ней не относится - [x] перечислено, что считается недостающим контекстом: ссылки `path/file:line`, шаги воспроизведения, проверяемые acceptance criteria, значение `## Spec` (путь, URL или `none`) - [x] зафиксировано правило: недостающий факт либо находится в репозитории, либо становится вопросом пользователю — выдумывать нельзя, `none` в `## Spec` остаётся законным ответом - [x] результат процедуры проходит `issue_check.py` без ошибок - [x] `skills/issue/scripts/` не пополняется — процедура не требует нового скрипта ## Constraints - Не входит в объём: автоматическая правка issue без участия человека и любые изменения формата в `references/format.md`. - Оффлайн: процедура не обращается к трекеру, не читает `gitea:` и не зависит от наличия `skills/sync/`.

claude added the

type

task

comp/issue labels 2026-08-09 19:08:39 +00:00

naudachu referenced this issue from a commit

2026-08-10 10:11:27 +00:00

feat: work the sync backlog — comments, labels, refs, closed issues

claude added reference feat/issue-cache-scripts

2026-08-10 10:18:31 +00:00

claude closed this issue

2026-08-10 10:18:31 +00:00

Sign in to join this conversation.