mcpField
G
grafana-bake-annotation

grafana-bake-annotation

github.com/gkwa生産性083 回インストール2 日前に更新
リポジトリ

grafana-bake-annotation について

Zephyrのパン作りログから時刻付きのサワードウ作業を抽出し、Grafanaのアノテーションを作成して、実行コマンドをログに記録するスキルです。対象作業と共有Grafanaセクションの扱いを定めています。

主な機能

  1. 01時刻付きの具体的な作業を抽出
  2. 02標準化されたsnake_caseラベルを適用
  3. 03GrafanaアノテーションCLIを実行
  4. 04コマンドブロックをログに記録
  5. 05アノテーションの削除と修正に対応

活用シーン

  1. 01種継ぎ、ミキシング、生地の折り込みを記録
  2. 02成形、窯入れ、焼き上がりを記録
  3. 03アノテーションを修正してログのコマンドを更新

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gkwa/volcanicviper --skill grafana-bake-annotation

インストール後、Claude Code で/grafana-bake-annotationを入力して読み込まれたか確認します。

同梱ファイルtile.json

詳細

概要

このスキルは、Zephyr のベイクログから注釈可能なベイクイベントを抽出し、Grafana の注釈 CLI を実行して、出力を含めずにコマンドをベイクログの ## grafana セクションに記録します。

ベイクログの見つけ方と Zephyr の記録の読み方については、[[zephyr]] スキルを参照してください。

注釈する内容

明示的なイベント時刻が記録された、時間が限定された個別のベイクアクションのみを注釈します。

注釈する項目：

  • 元種に給餌 → feed_starter
  • 元種がピークに達した → starter_peaked
  • ミックス（元種を加えて生地を混ぜる） → mix
  • ストレッチ＆フォールドを行うたび → stretch_fold
  • 中断のない長時間のバルク発酵の開始（ストレッチ＆フォールドをすべて終えた後） → long_bulk_start
  • 成形 → shape
  • 低温発酵のため冷蔵庫に入れる → cold_retard_start
  • クープを入れる → score
  • オーブンに入れる → bake_start
  • 蓋を外す → lid_off
  • オーブンから出す → bake_done

観察、温度の記録、質問、振り返り、および具体的なアクション時刻のない記録はスキップします。

ラベルの規則

ラベルには snake_case を使用します。

明確な開始点と終了点のあるアクションには、_start と _done のサフィックスを使用します。

bulk_start ではなく long_bulk_start を使用します。バルク発酵は厳密にはミックス時に始まります。このラベルは、ストレッチ＆フォールドを終えた後、中断のない長時間の発酵フェーズが始まる時点を示します。

スクリプト

注釈スクリプト：

/Users/mtm/pdev/taylormonacelli/diminutivedragon/scripts/annotate-grafana.py

注釈削除スクリプト：

/Users/mtm/pdev/taylormonacelli/diminutivedragon/scripts/clear-annotations.py

スクリプトは AWS SSM Parameter Store（/diminutivedragon/grafana_token、リージョン us-west-2）から Grafana トークンを自動的に取得します。

SSM パラメーターは AWS CLI を使って別途作成されたもので、Terraform による管理対象ではありません。

テストなどのためにローカルでトークンを上書きする場合は、実行前に環境変数 GRAFANA_TOKEN を設定してください。

トークンの値をベイクログやコミット対象のファイルに書き込まないでください。

注釈コマンドの実行

--time と --label のペアを繰り返して、すべてのイベントを 1 回の呼び出しで渡します。

渡す前に、すべてのタイムスタンプを ISO 8601 形式に変換してください。

uv run --directory ~/pdev/taylormonacelli/diminutivedragon \
  scripts/annotate-grafana.py \
  --time 2026-05-28T20:39:00 --label feed_starter \
  --time 2026-05-29T06:31:00 --label starter_peaked

ベイクログの更新

注釈コマンドの実行後、コマンドをフェンス付きコードブロックとして、ベイクログの ## grafana セクションに記録します。

ログに出力行（「Added annotation id=...」の行）を含めないでください。コマンドのみを記録します。

セクションの管理範囲

## grafana セクションは共有されています。

このスキルが管理するのは、フェンス付きの注釈コマンドブロックです。

セクションの先頭にある 2 つのダッシュボードリンク、overall と bulk ferment は、[[zephyr-grafana-links]] スキルが管理します。

注釈コマンドを記録する際は、これらのリンクを変更しないでください。ここで削除したり書き換えたりしてはいけません。

ベイクが終わると、bake_done 注釈はリンクの終了時刻を固定する必要があることを示す合図にもなります。[[zephyr-grafana-links]] スキルを参照してください。

間違いの修正

ID を指定して注釈を削除するには：

uv run --directory ~/pdev/taylormonacelli/diminutivedragon \
  scripts/clear-annotations.py --id 42

削除後、修正した注釈を追加し直し、ベイクログの CLI ブロックを更新します。

コミット

必要に応じて個々の変更を元に戻せるよう、注釈を実行するたびにベイクログをコミットしてください。

コメント

Markdown 対応