スキル storage-debug-instrumentation
🔍

storage-debug-instrumentation

安全 🌐 ネットワークアクセス📁 ファイルシステムへのアクセス⚙️ 外部コマンド

为存储层添加调试工具

PostgreSQL 和 ChromaDB 的存储问题难以诊断,缺乏可见性。本技能提供完整的调试工具包,包含用于检查存储状态、检测漂移和跟踪启动性能的端点和仪表板。

対応: Claude Codex Code(CC)
⚠️ 68 貧弱
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「storage-debug-instrumentation」を使用しています。 帮助我调试为什么某些文章没有出现在搜索结果中

期待される結果:

  • 🔍 存储漂移分析
  • ChromaDB 中缺失: 3 篇文章 (存在于 PostgreSQL 但未索引)
  • ChromaDB 中悬空: 2 个条目 (无匹配的 PostgreSQL 文章)
  •  
  • 📊 启动时间线
  • 数据库初始化: 0.45秒
  • 缓存预加载: 1.2秒
  • 向量存储: 0.8秒
  • RSS 刷新: 2.1秒
  • 总启动时间: 4.55秒

セキュリティ監査

安全
v5 • 1/16/2026

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.

2
スキャンされたファイル
293
解析された行数
3
検出結果
5
総監査数
監査者: claude 監査履歴を表示 →

品質スコア

38
アーキテクチャ
100
保守性
83
コンテンツ
20
コミュニティ
100
セキュリティ
83
仕様準拠

作れるもの

调试存储同步

识别 ChromaDB 中缺失的文章或导致搜索问题的悬空条目

监控启动性能

跟踪数据库初始化、缓存预加载和 RSS 刷新持续时间的变化

检查存储状态

在开发过程中浏览原始文章数据并验证存储层内容

これらのプロンプトを試す

启用调试
使用 storage-debug-instrumentation 技能添加调试端点和仪表板,用于检查 PostgreSQL 和 ChromaDB 存储。
调查存储问题
我的应用程序在搜索结果中缺少文章。使用 storage-debug-instrumentation 帮我找出 PostgreSQL 中存在但 ChromaDB 中缺失的文章。
查看启动指标
我的应用程序启动很慢。使用 storage-debug-instrumentation 显示启动时间线,并找出哪个阶段耗时最长。
修复存储漂移
我发现我的数据库之间存在存储漂移。使用 storage-debug-instrumentation 显示 chroma 缺失和悬空条目的示例,以便我修复同步问题。

ベストプラクティス

  • 在生产环境中暴露之前,通过身份验证保护调试端点
  • 浏览大型数据集时使用分页以避免性能影响
  • 定期监控存储漂移以尽早发现同步问题

回避

  • 在未进行身份验证的情况下公开访问调试端点
  • 手动检查漂移而不是使用自动检测
  • 忽略启动延迟而不调查根本原因

よくある質問

此技能适用于哪些 AI 平台?
兼容 Claude、Codex 和 Claude Code,可用于实现调试工具。
如何激活此技能?
在需要添加或使用存储检查的调试端点时调用此技能。
此技能访问哪些数据?
该技能描述通过调试端点访问 PostgreSQL 和 ChromaDB 数据库。
此技能会向外发送数据吗?
无外部网络调用。调试端点是您应用程序本地的。
使用限制是什么?
无限制。仪表板分页可高效处理大型数据集。
这与其他调试工具有何不同?
通过跨两个数据库系统的漂移检测提供端到端存储可见性。

開発者の詳細

ファイル構成

📄 SKILL.md