無料GitHub で公開日本語紹介

plano-observability-debugging

Planoのトレースに記録する属性やサンプリング方法を整え、traceコマンドでルーティングや遅延の問題を調査するスキルです。

原文原文の説明を見る

Improve Plano tracing and debugging workflows. Use for sampling strategy, span attributes, and trace query-based root-cause analysis.

katanemo/planoスター 7,101(GitHub 7,101 + cccskills 0)

実行スコア未検証

インストール方法を見る

こんなときに便利

トレースのサンプリング方法を設定したいとき
スパンにヘッダー由来の属性を加えたいとき
ルーティングや遅延の原因を調べたいとき

日本語での紹介

できること

Planoのルーティングや応答遅延を、トレースを使って調査しやすくします。環境に合ったサンプリング方法を設定し、固定値やリクエストヘッダー由来の属性をスパンに追加する手順を示します。さらにplanoai traceのフィルターで対象ルートや遅延を絞り込み、誤ったルーティングやフィルター・モデルの処理時間を調べます。推測ではなくトレース上の根拠を使い、再現・検証用の具体的なコマンドを提示します。

こんなときに便利

リクエストが想定と異なる経路へ振り分けられた理由を調べたいときや、どの処理で遅延しているかを確認したいときに向いています。トレースの属性やサンプリングを見直したい場合にも使えます。

使い方の例

「トレースを有効にして、適切なサンプリングを設定して」
「リクエストヘッダーをスパン属性に追加して」
「このリクエストが誤ったルートに進んだ原因を調べて」

注意点

トレースの確認にはplanoai traceコマンドを使います。

この紹介文は、公開されている SKILL.md をもとに AI（OpenAI Codex）が作成しました。正確な仕様は下の原文を確認してください。

含まれるファイル（1）

SKILL.md967 B

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Plano Observability and Debugging

Use this skill to make routing and latency behavior inspectable and debuggable.

When To Use

"Enable tracing correctly"
"Add useful span attributes"
"Debug why a request routed incorrectly"
"Inspect filter/model latency from traces"

Apply These Rules

observe-tracing
observe-span-attributes
observe-trace-query

Execution Checklist

Enable tracing with environment-appropriate sampling.
Add useful static and header-derived span attributes.
Use planoai trace filters to isolate route and latency issues.
Prefer trace evidence over assumptions in recommendations.
Return exact commands to reproduce and validate findings.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

同じリポジトリのスキル