mcpField
C
cawplan-support-metrics

cawplan-support-metrics

github.com/cawcutデータ・データベース153 回インストール1 日前に更新
リポジトリ

cawplan-support-metrics について

Support Opsの指標をCawPlanへエクスポートし、検証して承認済みデータを取り込むための管理されたワークフロースキルです。V1の指標契約を限定し、書き込み前のドライラン、照合、明示的な承認を重視します。

主な機能

  1. 01同梱Apps Scriptによるエクスポート手順
  2. 02データソースと製品IDの検証
  3. 03インポート前の合計プレビュー
  4. 04正規化した指標の分割取り込み
  5. 05インポート後の照合
  6. 06承認に基づく加算修正

活用シーン

  1. 01Support Ops指標のエクスポート準備
  2. 02製品マッピングとエクスポート合計の検証
  3. 03承認済みのチケット作成指標の取り込み
  4. 04取り込みデータの照合または修正案の作成

インストール

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

$npx skills add https://github.com/cawcut/skill-cawplan --skill cawplan-support-metrics

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

同梱ファイルassets/CawPlanSupportMetrics.gs

詳細

CawPlan サポート指標

固定されたサポートオペレーションから CawPlan への重要指標ワークフローを管理するには、このスキルを使用してください。汎用の cawplan metrics コマンドを、サポート用の固定データ契約に合わせて特化させています。

初期設定

cawplan skill check

認証情報がない場合は、cawplan auth login を実行し、表示された URL をユーザーに提示してください。ユーザーが承認を確認した後、cawplan auth login --device-auth --complete を実行してください。Apps Script で API キーを要求したり、埋め込んだりしないでください。

同梱エクスポーター

保守されているエクスポーターとして assets/CawPlanSupportMetrics.gs を使用してください。これをサポートオペレーションに紐づけられた Apps Script プロジェクトにコピーしてください。エクスポーターを一から再生成しないでください。

最初のエクスポートの前に、次の手順を実行してください。

  1. cawplanSupportInspectSource() を実行し、ログに記録された担当者シートのヘッダーと解決済みのソース列を確認します。
  2. 正確な CawPlan プロダクトの unique_id 値を CAWPLAN_SUPPORT_CONFIG.products に設定します。
  3. 承認済みの B、C、E、F、H、I 列のヘッダーテキストをそのまま CAWPLAN_SUPPORT_CONFIG.approvedHeaders にコピーします。
  4. startDate と endDate を両端を含む範囲として設定します。
  5. cawplanSupportExportMetrics() を実行し、ログに記録された Drive ファイルの URL と SHA-256 をドライランに使用します。

エクスポーターは Sheets を読み取り専用で扱い、Drive に要求された JSON ファイルのみを作成します。現在のダッシュボードと週次レポートの定義と照合した後に限り、ソースマッピングを変更してください。

対応ワークフロー

リクエストを次のいずれかのモードに振り分けてください。

  • エクスポーターの準備：提供された Apps Script またはシートのレイアウトを調査し、同梱エクスポーターを設定するか、限定的にパッチを適用します。CawPlan への直接の HTTP 呼び出しは追加しないでください。
  • 検証／ドライラン：ファイルを検証し、プロダクト ID を解決して確認し、重複する識別情報や未対応の語彙を拒否して、書き込みを行わずに合計を表示します。
  • インポート：ユーザーがドライランを確認して承認した後に限り、cawplan metrics ingest を使用して正規化済み項目を上限付きのバッチでアップロードします。
  • 照合：インポートした正確な範囲とディメンションをクエリし、truncated を確認して、CawPlan の合計をエクスポート結果と比較します。
  • 修正：以前のポイントを上書きまたは削除しないでください。加算型の修正差分をプレビューし、明示的な承認を得てから書き込みます。

V1 契約の境界

通常の V1 書き込みとして許可されているのは、次のものだけです。

domain = cawplan_csm
metric = ticket_created
field  = value

使用できる基本タグは product_line、channel、assignee、source_system です。dimensions.product は確認済みの CawPlan プロダクト unique_id でなければなりません。ワークスペースへの帰属情報はサーバーによって付与されるため、指定しないでください。

Zendesk のステータススナップショット、Solved／Pending の KPI、Jira SPRT の課題、週次合計、パーセンテージ、レポート成果物は、V1 の書き込み契約の対象外です。依頼があれば分析またはエクスポートしてもかまいませんが、プラットフォーム所有者が新しい正規メトリック契約を承認するまでは取り込まないでください。

書き込みの安全性

  • 検証、プレビュー、クエリは読み取り専用として扱ってください。
  • ファイルが添付されたという理由だけで取り込まないでください。ユーザーが書き込みを依頼し、ドライランを承認する必要があります。
  • 担当者レベルの行と、そこから派生した Total 行の両方を取り込まないでください。
  • タイムスタンプを再生成したりタグを変更したりして再試行しないでください。まず照合し、必要な場合に限り、バイト単位で同一の正規化済み項目を再試行してください。
  • 不明な列、曖昧なプロダクト、予期しないタグ、負の基本値、ソース範囲の一部欠落、クエリの切り詰め、または合計の不一致があれば、処理を停止してください。
  • 書き込みのたびに、ソースチェックサム、範囲、項目数、受理件数、照合結果を報告してください。

コメント

Markdown 対応