aivis-project AivisSpeech Engine Sentry トリアージ
作業手順
このスキルは、AivisSpeech Engine で今後も繰り返す Sentry ノイズ処理の流れで使用します。
- Sentry の実データから issue とイベントを確認します
- 各 issue を「修正対象」「入力値ノイズ」「ローカル環境ノイズ」「外部サービスノイズ」「保留」に分類します
- ユーザーが Sentry 側の整理を依頼した場合だけ、確定ノイズの issue を永続アーカイブします
- 同じノイズを送信前に破棄するため、
voicevox_engine/utility/sentry_utility.pyを更新します test/unit/utility/test_sentry_utility.pyに絞り込みテストを追加します- 修正すべきエラーは、修正先がこのリポジトリ内かどうかを切り分けます
- リポジトリルートから
uv runの検証コマンドを実行します
フィルタを変更する前に、必ず Sentry の実 issue / イベントを確認します。
イベント詳細が取得できる場合は、タイトルだけで分類しないでください。
修正判断
AivisSpeech Engine 側で完結する問題は、ユーザーの追加承認を待たずに修正します。
たとえば API バリデーション不足、AudioQuery モデルの検証不足、Engine 側の例外処理・レスポンス変換・Sentry フィルタ漏れ、Engine 側で管理している辞書データの不整合は、このリポジトリで実装とテストまで進めます。
SBV2 コア、依存ライブラリ、配布モデル、別リポジトリの辞書データに修正が必要な場合は、このリポジトリだけで直せるように見せかけません。
Sentry issue、最新イベント、該当スタック、再現条件、修正候補、修正先リポジトリを短くまとめて、ユーザーへ対応依頼として報告します。
修正先が曖昧な場合は、まずこのリポジトリ内で入力検証・前処理・呼び出し境界を確認します。
Engine 側で不正入力を止められるなら Engine 側で直し、コア内部の正常入力処理で壊れている場合はユーザーへ詳細報告します。
必読資料
作業前に以下を読みます。
references/sentry-workflow.md: Sentry API の使い分け、90日 issue 一覧、アーカイブ時の注意references/classification.md: 既存調査に基づく「破棄」「残す」「保留」の分類ルールreferences/filter-implementation.md: このリポジトリでの実装・テスト方針
タイトルベースの粗い確認だけでよい場面では、scripts/probe_sentry_filter.py を使えます。
uv run python .codex/skills/aivisspeech-engine-sentry-triage/scripts/probe_sentry_filter.py \
--repo-root . \
--query "is:ignored" \
--stats-period 90d
このスクリプトは読み取り専用です。
最終的な「残す / 破棄する」判断の前にはイベント詳細を確認してください。
リポジトリ前提
コマンドは AivisSpeech Engine のリポジトリルートから実行します。
Python 実行には uv run python を使います。
グローバルの python や python3 は絶対に使いません。
バンドル済み Sentry helper で取得できる内容は、まず helper を使います。
helper で表現できないクエリが必要な場合は、curl または uv run python で Sentry REST API を直接叩きます。
ただし、ユーザーが Sentry issue 状態の更新を明示した場合を除き、読み取り専用のリクエストに限定します。
SENTRY_AUTH_TOKEN は絶対に出力しません。
ユーザーが明示しない限り、ステージング、ステージング解除、コミット、リセット、クリーンアップ、ファイル削除は行いません。