feat(skills): add jira-workflow, repo-map, docs-map, go-standards

- descriptions state WHEN each skill applies - jira-workflow ships curl scripts reading TRACKER_URL/JIRA_TOKEN from env, no hardcoded secrets/URLs - repo-map/docs-map defer values to session corporate context; company specifics left as TODO - go-standards uses realistic Go defaults, company-specific bits marked TODO
2026-07-16 10:57:00 +03:00
parent fe99b404fa
commit 0725b6b034
7 changed files with 250 additions and 0 deletions
@@ -0,0 +1,57 @@
+---
+name: jira-workflow
+description: Используй, когда нужно работать с корпоративным трекером задач (Jira) — прочитать тикет по ключу, добавить комментарий, приложить ссылку на MR, разобраться в статусах и переходах. Применяй при упоминании ключей задач, «тикет», «задача в трекере», «переведи в статус», а также в командах /bugfix и /feature.
+---
+
+# Работа с трекером задач (Jira)
+
+Скилл описывает, как читать и обновлять задачи в нашем трекере через REST API.
+
+## Откуда берутся адрес и токен
+
+**Никогда не хардкодь и не спрашивай их отдельно — они уже есть в окружении.**
+
+- **Базовый адрес трекера** — из переменной окружения `TRACKER_URL`. Если она не задана,
+  возьми адрес трекера из корпоративного контекста сессии (его инжектит расширение
+  `company-context`).
+- **Токен доступа** — из переменной окружения `JIRA_TOKEN` (personal access token).
+- Токен в команды и логи не подставляй в открытом виде — скрипты читают его из окружения сами.
+
+Быстрая проверка окружения:
+
+```bash
+: "${TRACKER_URL:?установи TRACKER_URL или возьми адрес из корпоративного контекста}"
+: "${JIRA_TOKEN:?установи JIRA_TOKEN (personal access token трекера)}"
+```
+
+## Готовые скрипты
+
+Все скрипты лежат в `scripts/` и читают `TRACKER_URL` и `JIRA_TOKEN` из окружения:
+
+- `./scripts/get-issue.sh <KEY>` — получить тикет (поля summary, status, description).
+- `./scripts/add-comment.sh <KEY> "<текст>"` — добавить комментарий.
+- `./scripts/link-mr.sh <KEY> "<url-MR>" ["<заголовок>"]` — приложить ссылку на MR
+  (добавляется комментарием со ссылкой; при доступном remote link API — см. TODO в скрипте).
+
+Пример:
+
+```bash
+./scripts/get-issue.sh PROJ-123
+./scripts/add-comment.sh PROJ-123 "Начал работу, воспроизвёл баг"
+./scripts/link-mr.sh PROJ-123 "https://<git-host>/ai/foo/-/merge_requests/42" "Fix PROJ-123"
+```
+
+## Соглашения
+
+<!-- TODO: заполнить реальными значениями компании -->
+
+- **Формат ключей задач:** `<!-- TODO: например PROJ-123, префиксы проектов -->`
+- **Статусы и переходы:** `<!-- TODO: рабочий процесс, напр. To Do → In Progress → In Review → Done -->`
+- **Кто и когда меняет статус:** `<!-- TODO: договорённости команды -->`
+- **Что писать в комментарии при старте/готовности:** `<!-- TODO -->`
+
+## Полезное
+
+- ID переходов статуса можно получить через `GET /rest/api/2/issue/<KEY>/transitions`,
+  выполнить переход — `POST` туда же с `{"transition":{"id":"<id>"}}`.
+- Если API возвращает 401/403 — проверь `JIRA_TOKEN` и права. Не логируй сам токен.