storage-debug-instrumentation
ストレージレイヤーのデバッグツールを追加
PostgreSQLとChromaDBのストレージ 문제는 가시性 없이는 진단하기 어렵습니다. 이 스킬은 스토리지 상태 검사, 드리프트 감지, 시작 성능 추적을 위한 엔드포인트와 대시보드가 포함된 완전한 디버깅 툴킷을 제공합니다.
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
テストする
「storage-debug-instrumentation」を使用しています。 一部の記事が検索に表示されない理由のデバッグを手伝ってください
期待される結果:
- 🔍 ストレージドリフト分析
- ChromaDBで欠落: 3件 (PostgreSQLには存在するがインデックスされていない)
- ChromaDBでダングリング: 2件 (一致するPostgreSQL記事がない)
- 📊 開始タイムライン
- DB初期化: 0.45秒
- キャッシュプリロード: 1.2秒
- ベクトルストア: 0.8秒
- RSS更新: 2.1秒
- 開始合計: 4.55秒
セキュリティ監査
安全This is a documentation-only skill (SKILL.md) providing implementation instructions for debugging tools. No executable code, scripts, or network operations are present. All 103 static findings are FALSE POSITIVES: the skill describes adding debug endpoints but contains no actual implementation code. URLs flagged are localhost development endpoints, and backticks are markdown code block syntax, not shell execution.
リスク要因
🌐 ネットワークアクセス (6)
📁 ファイルシステムへのアクセス (1)
⚙️ 外部コマンド (75)
品質スコア
作れるもの
ストレージ同期のデバッグ
ChromaDBに欠落している記事、または検索の問題を引き起こしているダングリングエントリを特定する
開始パフォーマンスの監視
データベース初期化、キャッシュプリロード、RSS更新の継続時間を経時的に追跡する
ストレージ状態の検査
開発中に生の記事データを参照し、ストレージレイヤーのコンテンツを確認する
これらのプロンプトを試す
storage-debug-instrumentationスキルを使用して、PostgreSQLおよびChromaDBストレージを検査するためのデバッグエンドポイントとダッシュボードを追加してください。
アプリケーションの検索結果に記事が表示されていません。storage-debug-instrumentationを使用して、PostgreSQLには存在するがChromaDBにインデックスされていない記事を特定してください。
アプリケーションの起動が遅いです。storage-debug-instrumentationを使用して開始タイムラインを表示し、どのフェーズが最も時間がかかっているか特定してください。
データベース間でストレージドリフトを発見しました。storage-debug-instrumentationを使用して、chroma欠落エントリとダングリングエントリのサンプルを表示し、同期問題を修正してください。
ベストプラクティス
- 本稼働環境で公開する前に認証でデバッグエンドポイントを保護する
- 大きなデータセットを閲覧する際はページ分割を使用してパフォーマンスへの影響を回避する
- ストレージドリフトを定期的に監視して同期問題を早期に発見する
回避
- 認証なしでデバッグエンドポイントを公開したままにする
- 自動検出を使用する代わりに手動でドリフトを確認する
- 原因を調査せずに開始遅延を無視する