Перейти к содержанию

srekit task

Сгенерировать investigation log — структурированный артефакт для ведения цепочки гипотез и доказательств, когда охотишься за tail-latency спайком, флэйковым тестом или любой open-ended SRE-загадкой. Скрытый алиас: srekit sretask (оставлен для миграции с gch sretask).

Синопсис

srekit task --title TITLE [flags]

Флаги

Флаг Обязательный Описание
--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" --stdout

Запись в конкретную директорию:

srekit task --title "Tail latency on api-gw" --path ./tasks
# → ./tasks/investigation-tail-latency-on-api-gw.md

Достать сгенерированный UUID через jq:

srekit task --title "Tail latency on api-gw" --json | jq -r '.id'

Структура данных для шаблона

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').