Compétences data-structure-protocol
📦

data-structure-protocol

Sûr

AI エージェントのためのコードベース構造マップ

AI エージェントは大きなコードベースではコンテキストを見失い、オリエンテーションにトークンを浪費します。このスキルは、クエリ可能なグラフを通じて永続的な構造メモリを提供し、エージェントがファイルを再読み込みせずに依存関係をナビゲートし、コードの関係を理解できるようにします。

Prend en charge: Claude Codex Code(CC)
🥉 73 Bronze
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "data-structure-protocol". python dsp-cli.py --root . search "authentication"

Résultat attendu:

Found 3 entities:
- obj-11223344: auth/middleware.ts (User authentication middleware)
- func-aabbccdd: auth/middleware.ts#validateToken (JWT token validation)
- obj-44556677: auth/providers/oauth.ts (OAuth provider integration)

Utilisation de "data-structure-protocol". python dsp-cli.py --root . get-recipients obj-11223344

Résultat attendu:

Modules importing auth/middleware.ts:
- obj-99887766: src/app.ts ('Handles JWT verification on requests')
- func-12345678: api/routes.ts ('Authenticates incoming API requests')

Audit de sécurité

Sûr
v1 • 2/24/2026

Static analysis detected patterns in SKILL.md (external_commands, network URLs, weak crypto flags) but all are FALSE POSITIVES. The detected patterns are: (1) Example CLI commands in markdown code blocks - not actual shell execution; (2) GitHub reference URLs for documentation - not data exfiltration; (3) Misidentified content as crypto algorithms - the skill is pure documentation. This is a legitimate documentation skill with no security risks.

1
Fichiers analysés
199
Lignes analysées
0
résultats
1
Total des audits
Aucun problème de sécurité trouvé
Audité par: claude

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
50
Communauté
100
Sécurité
83
Conformité aux spécifications

Ce que vous pouvez construire

大規模コードベースのナビゲーション

DSP グラフをクエリして unfamiliar なコードベースをナビゲートし、すべてのファイルを読むことなくモジュールの関係を理解する

安全なリファクタリング

ライブラリの置き換えやリファクタリング前に、グラフをクエリしてすべての依存モジュールを見つけ、影響を把握する

コードコンテキストの保持

セッション間で構造的知識を維持し、AI エージェントが接続の理由を理解できるようにする

Essayez ces prompts

プロジェクトの DSP セットアップ
このプロジェクトの Data Structure Protocol (DSP) をセットアップしてください。必要に応じて dsp-cli.py をダウンロードし、init を実行して、メインエントリーポイントからグラフをブートストラップします。
エンティティの依存関係を検索
[entity-name-or-path] に依存するすべてのエンティティを見つけ、各依存関係が存在する理由を表示してください。
新しいモジュールをマップ
[file-path] の新しい DSP オブジェクトを description '[purpose]' で作成してください。次に、各エクスポートされた関数の関数エンティティを作成し、shared としてマークし、理由付きでインポートを追加します。
コードベース構造を検索
関連するエンティティを見つけるために DSP グラフを '[query]' で検索してください。それらの説明とインポート関係を表示します。

Bonnes pratiques

  • 新しいファイルの作成、インポートの追加、パブリック API の変更時に即座に DSP を更新する
  • インポートを記録する際は常に意味のある「why」理由を追加する - ここに価値の大部分がある
  • .dsp/ の差分をコード差分として扱う - レビューして正確に保つ

Éviter

  • 目的や依存関係に影響しない内部のみの変更のために DSP を更新しない
  • すべてのローカル変数の UID を作成しない - ファイルレベルの Object とパブリックエンティティのみ
  • 「why」理由の追加を省略しない - これがないとグラフのナビゲーション価値が失われる

Foire aux questions

DSP とは何ですか?
DSP(Data Structure Protocol)は、AI エージェントにコードベースの永続的な構造メモリを提供するシステムです。.dsp/ ディレクトリにクエリ可能なグラフを保存し、エンティティ、インポート、エクスポート、各接続の理由を示します。
このスキルはコードを実行しますか?
いいえ。このスキルは dsp-cli.py Python スクリプトの使用に関するドキュメントとガイダンスを提供します。自動的に実行される実行可能コードは含まれていません。
DSP はリファクタリングにどのように役立ちますか?
変更を行う前に、DSP グラフをクエリしてモジュールに依存するすべてのエンティティを見つけ、なぜ依存しているかを理解できます。これにより、破壊的な変更を防ぎ、完全なリファクタリングカバレッジを確保します。
UID とは何ですか?なぜ重要なのですか?
UID(obj-a1b2c3d4 のような一意識別子)はファイル名の変更や移動 across で安定しています。ファイルパスとは異なり、UID はファイルが再構築されてもエンティティを一貫して追跡できます。
DSP はサードパーティライブラリを分析しますか?
いいえ。外部依存関係(npm パッケージ、標準ライブラリなど)は「external」kind として記録されますが、その内部は分析されません。詳細にマップされるのはプロジェクトのコードのみです。
Claude Code で使用できますか?
はい。このスキルは Claude、Codex、Claude Code を含む AI コーディングアシスタントのために設計されています。エージェントがコードベース全体を再読み込みせずにセッション間でコンテキストを維持するのに役立ちます。

Détails du développeur

Structure de fichiers

📄 SKILL.md