Compétences data-structure-protocol
📦

data-structure-protocol

Sûr

为 AI 代理映射代码库结构

AI 代理在大型代码库中会丢失上下文，并在方向定位上浪费 token。本技能通过可查询的图提供持久化的结构记忆，使代理能够在不重新读取文件的情况下导航依赖关系并理解代码关系。

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 图谱来导航不熟悉的代码库，无需读取每个文件即可理解模块关系

安全重构

在替换库或重构之前，查询图谱以找到所有依赖模块并了解影响

代码上下文保留

在多个会话之间保持结构知识，使 AI 代理能够理解连接存在的原因

Essayez ces prompts

为项目设置 DSP 
为这个项目设置数据结构和协议 (DSP)。下载 dsp-cli.py（如需要），运行 init，并从主入口点开始引导图。
查找实体依赖 
查找所有依赖于 [entity-name-or-path] 的实体，并向我展示每个依赖存在的原因。
映射新模块 
为 [file-path] 创建一个新的 DSP 对象，描述为 '[purpose]'。然后为每个导出的函数创建函数实体，将它们标记为 shared，并添加带原因的导入。
搜索代码库结构 
在 DSP 图谱中搜索 '[query]' 以找到相关实体。向我展示它们的描述和导入关系。

Bonnes pratiques

  • 在创建新文件、添加导入或更改公共 API 时立即更新 DSP
  • 记录导入时始终添加有意义的 "why" 原因 - 这是大部分价值所在
  • 将 .dsp/ 差异视为代码差异 - 审查它们并保持准确性

Éviter

  • 对于不影响目的或依赖的仅内部更改，不要更新 DSP
  • 不要为每个局部变量创建 UID - 仅针对文件级对象和公共实体
  • 不要跳过添加 "why" 原因 - 没有它们，图谱将失去导航价值

Foire aux questions

什么是 DSP？
DSP（数据结构协议）是一个为 AI 代理提供代码库持久化结构记忆的系统。它将可查询的图存储在 .dsp/ 目录中，显示实体、导入、导出以及每个连接的原因。
这个技能会执行代码吗？
不。本技能提供使用 dsp-cli.py Python 脚本的文档和指导。它不包含任何自动执行的代码。
DSP 如何帮助重构？
在进行更改之前，您可以查询 DSP 图谱以找到所有依赖于某个模块的实体，并理解它们为何依赖它。这可以防止破坏性更改并确保完整的重构覆盖。
什么是 UID，它们为什么重要？
UID（唯一标识符，如 obj-a1b2c3d4）在文件重命名和移动时保持稳定。与文件路径不同，UID 允许图谱在文件重组时一致地追踪实体。
DSP 会分析第三方库吗？
不。外部依赖（npm 包、标准库等）被记录为 "external" 类型，但永远不会分析它们的内部实现。只有您的项目代码会被详细映射。
我可以与 Claude Code 一起使用吗？
是的。此技能专为 AI 编码助手设计，包括 Claude、Codex 和 Claude Code。它帮助代理在多个会话之间保持上下文，而无需重新读取整个代码库。

Détails du développeur

Auteur

sickn33

Licence

MIT

Dépôt

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/data-structure-protocol

Réf

main

Structure de fichiers

📄 SKILL.md