symbols

Symbols 技能是一个为大型软件项目设计的高阶代码库导航引擎。它使 AI 代理能够查询符号（如函数、组件、Hook、服务与类型），而无需将整个文件载入到上下文窗口中。通过利用按领域与架构层进行分块的预生成符号图，此技能提供精确的上下文，能显著提升 Token 使用效率。它主要适用于管理复杂代码库的开发者与 AI 代理，在这些情境下，载入完整文件内容往往是多余且昂贵的。

• 智能符号查询：立即通过名称、类型、路径或架构标签定位特定的代码成品。
• 架构层感知：支持依项目特定的层级（如路由器、服务、存储库或 Schema）进行过滤，让您仅载入与当前任务相关的代码。
• 领域专属分块：将大型存储库整理为可管理的领域（例如 UI、Web、API、Shared），以优化上下文窗口的使用。
• 降低 Token 消耗：与标准的完整文件载入相比，可达成 60-95% 的 Token 使用量减少；通过后端专属的层级拆分，能额外提供高达 80% 的效率提升。
• 无缝整合：配合配置导向的提取脚本（TypeScript/Python）运作，以维护项目结构的最新事实来源。

使用注意事项与实务建议：

• 每当存储库发生重大结构变动时，请务必执行提取与标记脚本 (extract_symbols_*.py, add_layer_tags.py)。
• 当您需要在实现新功能前理解现有的架构模式，或在调试跨领域服务互动时，请使用符号工具。
• 此技能仅用于只读的导航与分析；当您需要特定函数的实际实现细节时，它无法取代直接读取文件的 Read 工具。
• 预期输入通常为针对符号名称或路径过滤器的查询字符串；输出则提供简洁的符号签名、行号与 docstring 摘要。
• 将查询限制在特定的架构层（例如仅载入 'services'），以最大化大型后端项目中的效能。