srekit task¶
Сгенерировать investigation log — структурированный артефакт для ведения цепочки гипотез и доказательств, когда охотишься за tail-latency спайком, флэйковым тестом или любой open-ended SRE-загадкой. Скрытый алиас: srekit sretask (оставлен для миграции с gch sretask).
Синопсис¶
Флаги¶
| Флаг | Обязательный | Описание |
|---|---|---|
--title |
да | Тема расследования; идёт в H1 и в default-имя файла |
--path DIR |
нет | Директория для записи (default: текущая) |
Плюс общие output-флаги: --out, --stdout, --force, --dry-run, --json.
Default имя файла¶
Если ни --out, ни --stdout не передан — пишется в <path>/investigation-<slug>.md (lowercased, slug-нормализованное).
Примеры¶
Быстрая черновая запись в stdout:
Запись в конкретную директорию:
srekit task --title "Tail latency on api-gw" --path ./tasks
# → ./tasks/investigation-tail-latency-on-api-gw.md
Достать сгенерированный UUID через jq:
Структура данных для шаблона¶
task шипится как v1 YAML-артефакт (internal/tmpl/templates/task.yaml) — frontmatter (id, title, creation_date, tags), H1, meta_bullets, список секций (Контекст / Context, Гипотеза / Hypothesis, Доказательства / Evidence, Выводы / Findings, Дальнейшие действия / Action items, Ссылки / References). На вход передаётся {Meta: {ID, Title, Now string}}; template-выражения внутри YAML обращаются к .Meta.<Field>.
См. также¶
- Кастомные шаблоны — переопределить embedded-артефакт своим
task.yaml. - JSON-вывод — пайплайны
--jsonв другие тулзы (per-section access черезjq '.sections[] | select(.id=="…").body').