用途：该技能用于在 Python 代码工作中启用 pyright-lsp 插件后，借助 LSP 的语义能力获取代码信息，而非依赖文本搜索。适合重构前查找全部引用、获取类型信息、跳转定义、检查类型错误等需要语义准确性的场景。
主要能力：提供 goToDefinition（跳转定义）、findReferences（查找全部引用）、hover（获取类型签名与文档）、getDiagnostics（获取文件类型错误）、documentSymbol（列出文件符号）等操作。这些是 Claude Code 内置工具，通过工具系统调用，而非 bash 命令。
使用方式：需要满足前置条件——在 ~/.claude/settings.json 中启用 pyright-lsp@claude-plugins-official 插件；安装 pyright（pip install pyright 或 npm install -g pyright）；建议项目存在 pyproject.toml 或 pyrightconfig.json。重构前用 findReferences 替代 grep 方法名；查类型用 hover 替代读文件解析；查类型错误用 getDiagnostics 替代运行 mypy/pyright CLI；找定义用 goToDefinition 替代 grep。
适用场景：需要语义准确性的符号查询、重构前引用排查、类型验证。文本模式（注释、字符串、配置）、跨语言搜索或 LSP 不可用时，仍应使用 Grep/Read。
限制：未安装 pyright 二进制、动态 Python（大量 eval、exec、getattr）、跨语言引用、注释/文档字符串搜索、无类型提示的项目，LSP 帮助有限。LSP 不可用时需回退到文本搜索，并说明该限制、谨慎使用 Grep、手动验证结果，并提醒用户安装 pyright 并启用插件。