AgentSkillsCN

pyright-lsp-tool

按需 Pyright LSP 查询工具(引用),无需运行完整的编辑器 LSP。

SKILL.md
--- frontmatter
name: pyright-lsp-tool
description: On-demand Pyright LSP query tool (references) without running a full editor LSP.

pyright-lsp-tool

一个“可自由启停”的 Pyright LSP 小工具:需要查语义级引用时临时启动 pyright-langserver(或保持一段时间常驻),查询完成后退出即可。

本 skill 独立于其它 skill,不读取/依赖 ai-team-workflow 或其它配置文件;其它 skill 也不应引用它。

依赖

  • pyright(提供 pyright-langserver
    • 推荐装到你的项目 venv:pip install pyright
  • node(pyright 运行时需要)

用法

进入目标仓库根目录后运行(默认会用 git rev-parse --show-toplevel 作为 project root):

  • 交互模式(推荐:一次启动,多次查询;退出即停)

    • python3 .codex/skills/pyright-lsp-tool/scripts/pyright_lsp_tool.py repl
    • 在交互提示符里:
      • refs src/pages/common/login_page.py:62:9
    • 退出:exit
  • 单次查询(每次都会启动一次 server,冷启动会慢一些)

    • python3 .codex/skills/pyright-lsp-tool/scripts/pyright_lsp_tool.py refs src/pages/common/login_page.py:62:9

可选参数:

  • --root <path>:指定 project root(默认:git toplevel 或 cwd)
  • --venv <venv_dir>:指定 venv(用于定位 pyright-langserver