docs(agents): контракт скиллов — трекер, метки триажа, доки и нейминг
- Зачем:
- инженерные скиллы (to-tickets, triage, wayfinder, domain-modeling) ждут
репо-локальную настройку; без неё они не знают, чем заводить issues и
какими метками размечать. Дока трекера жила ссылкой на репозиторий
предшественника — внешняя зависимость на месте источника истины.
- Что:
- заведён docs/agents/: issue-tracker.md (Gitea через tea, команды,
wayfinding, отдельный раздел про то, что «Закрывает #NN» issue не
закрывает), triage-labels.md (пять канонических меток без переименований)
и domain.md (один контекст, CONTEXT.md и docs/adr/).
- в AGENTS.md добавлен раздел «Agent skills» со ссылками на эти файлы,
ссылка на доку предшественника заменена локальной.
- в «Структуре» закреплён нейминг: ГГГГ-ММ-ДД-слаг для docs/specs/ и
docs/research/, NNNN-слаг для docs/adr/.
- Проверка:
- tea labels list — все пять меток триажа заведены в репозитории;
- tea api version — Gitea 1.27.0, команды из доки отвечают живьём.
This commit is contained in:
@@ -0,0 +1,22 @@
|
||||
# Метки триажа
|
||||
|
||||
Скиллы говорят о пяти канонических ролях триажа. Эта таблица переводит роли в
|
||||
метки, которые реально заведены в трекере репозитория.
|
||||
|
||||
| Роль в скиллах | Метка у нас | Значение |
|
||||
| ----------------- | ----------------- | ------------------------------------------- |
|
||||
| `needs-triage` | `needs-triage` | Задачу надо оценить, решение не принято |
|
||||
| `needs-info` | `needs-info` | Ждём уточнений от автора |
|
||||
| `ready-for-agent` | `ready-for-agent` | Постановка полная, можно отдавать агенту |
|
||||
| `ready-for-human` | `ready-for-human` | Нужен человек |
|
||||
| `wontfix` | `wontfix` | Делать не будем |
|
||||
|
||||
Имена совпадают с каноническими: переименований нет. Когда скилл говорит про
|
||||
роль («поставь метку готовности для агента»), берём строку из правой колонки.
|
||||
|
||||
Все пять меток уже созданы в Gitea (проверено `tea labels list` 2026-07-31) —
|
||||
заводить их заново не нужно. Кроме них в репозитории живут метки карты
|
||||
`wayfinder:*` (`map`, `research`, `prototype`, `grilling`, `task`); к триажу они
|
||||
отношения не имеют, ими размечает `/wayfinder`.
|
||||
|
||||
Если вокабуляр меток поменяется — править правую колонку здесь, а не в скиллах.
|
||||
Reference in New Issue
Block a user