代码验证
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- macOS · Linux · Windows
- 运行环境要求
- Python >=3.10
- 检测到的文件与系统行为
-
- 只读
- 读取环境变量
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
export LSP_WORKSPACE=/path/to/repo
# Python
lsp-query symbols src/model.py
lsp-query hover src/model.py 42 10
lsp-query references src/model.py 42 10
# TypeScript (auto-detected from .ts extension)
lsp-query symbols src/index.ts
lsp-query definition src/app.tsx 15 8
# Rust
lsp-query symbols src/main.rs
lsp-query diagnostics src/lib.rs
# Check what's available
lsp-query languages
lsp-query servers
# LSP Code Navigation
Multi-language LSP client that manages per-language background daemons. Auto-detects the language from file extension and routes queries to the correct server. Each server lazy-starts on first use and idles out after 5 minutes of inactivity.
**Use this instead of grep/read when you need to:**
- Find where something is defined
- Find all usages of a symbol
- Get type signatures or docstrings
- List all classes/functions in a file
- Check for type errors before running code
- Search for a symbol across an entire workspace
## Supported Languages
| Language | Server | Extensions | Install |
|----------|--------|------------|---------|
| Python | `pyright-langserver` | .py, .pyi, .pyx | `npm install -g pyright` |
| TypeScript/JS | `typescript-language-server` | .ts, .tsx, .js, .jsx, .mjs, .cjs | `npm install -g typescript-language-server typescript` |
| Rust | `rust-analyzer` | .rs | `rustup component add rust-analyzer` |
| Go | `gopls` | .go | `go install golang.org/x/tools/gopls@latest` |
| C/C++ | `clangd` | .c, .h, .cpp, .cc, .hpp | `apt install clangd` or `brew install llvm` |
| Bash | `bash-language-server` | .sh, .bash, .zsh | `npm install -g bash-language-server` |
| Java | `jdtls` | .java | [eclipse.jdt.ls](https://github.com/eclipse-jdtls/eclipse.jdt.ls) |
| CSS | `vscode-css-language-server` | .css, .scss, .less | `npm install -g vscode-langservers-extracted` |
| HTML | `vscode-html-language-server` | .html, .htm | `npm install -g vscode-langservers-extracted` |
| JSON | `vscode-json-language-server` | .json, .jsonc | `npm install -g vscode-langservers-extracted` |
Only install the servers you need. The skill auto-detects which are available and reports helpful install commands for missing ones.
## Setup
### Prerequisites
- Python 3.10+ (for the client script itself -- stdlib only, no pip deps)
- At least one language server installed (see table above)
### Installation
The skill includes a Python script at `{baseDir}/scripts/lsp-query.py`. This is the LSP client -- it manages background daemons and handles all queries.
To make it callable as `lsp-query` from anywhere, symlink it into your PATH:
```bash
ln -sf {baseDir}/scripts/lsp-query.py /usr/local/bin/lsp-query
# or:
ln -sf {baseDir}/scripts/lsp-query.py ~/.npm-global/bin/lsp-query
```
Alternatively, invoke it directly:
```bash
{baseDir}/scripts/lsp-query.py <command> [args...]
```
### Configuration
Set `LSP_WORKSPACE` to the repo root before querying. If unset, defaults to the git root or cwd.
## Commands
All line and column numbers are **1-indexed** (human-friendly, matching editor display).
### Go to Definition
```bash
lsp-query definition /path/to/file.py <line> <col>
```
### Find References
```bash
lsp-query references /path/to/file.py <line> <col>
```
### Hover (Type Info)
```bash
lsp-query hover /path/to/file.py <line> <col>
```
### Document Symbols
```bash
lsp-query symbols /path/to/file.py
```
### Workspace Symbol Search
```bash
lsp-query workspace-symbols "ClassName"
```
### Diagnostics
```bash
lsp-query diagnostics /path/to/file.py
```
### Completions
```bash
lsp-query completions /path/to/file.py <line> <col>
```
### Signature Help
```bash
lsp-query signature /path/to/file.py <line> <col>
```
### Rename Preview
```bash
lsp-query rename /path/to/file.py <line> <col> new_name
```
### Server Management
```bash
lsp-query languages # Show all supported languages + install status
lsp-query servers # List running language daemons
lsp-query shutdown # Stop all daemons
lsp-query shutdown python # Stop just the Python daemon
```
## What's Included
```
{baseDir}/
├── SKILL.md # This file
└── scripts/
└── lsp-query.py # Python script -- multi-language LSP client + daemon manager
```
`lsp-query.py` is a self-contained Python script (~850 lines, stdlib only, no pip dependencies). It:
1. Forks a single background daemon process on first use
2. The daemon lazy-starts language servers as needed (e.g., pyright for .py, typescript-language-server for .ts)
3. Communicates with the daemon over a Unix socket (`~/.cache/lsp-query/daemon.sock`)
4. Translates CLI commands into LSP JSON-RPC requests and prints human-readable results
5. Each language server auto-stops after 5 minutes idle; the daemon itself stops when all servers are idle
## Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| `LSP_WORKSPACE` | git root or cwd | Workspace root for LSP servers |
| `LSP_SERVER` | auto per language | Override server command for ALL languages |
| `LSP_LANG` | auto from extension | Force a specific language (bypass detection) |
| `LSP_TIMEOUT` | `300` | Server idle timeout in seconds |
| `LSP_SOCK` | `~/.cache/lsp-query/daemon.sock` | Unix socket path |
## Examples
```bash
export LSP_WORKSPACE=/path/to/repo
# Python
lsp-query symbols src/model.py
lsp-query hover src/model.py 42 10
lsp-query references src/model.py 42 10
# TypeScript (auto-detected from .ts extension)
lsp-query symbols src/index.ts
lsp-query definition src/app.tsx 15 8
# Rust
lsp-query symbols src/main.rs
lsp-query diagnostics src/lib.rs
# Check what's available
lsp-query languages
lsp-query servers
```
## Troubleshooting
- **"Server not found for X"**: The language server binary isn't installed. The error message includes the install command.
- **"could not connect to LSP daemon"**: Daemon failed to start. Verify Python 3.10+ is available.
- **Import errors in diagnostics**: Expected when packages aren't installed in the current Python environment. These resolve on machines with the correct venv.
- **Stale results**: Run `lsp-query shutdown` to restart all servers fresh.
- **Slow first query per language**: Each server takes 1-2 seconds to cold-start. Subsequent queries to the same language are ~200ms.
- **Wrong language detected**: Use `LSP_LANG=rust lsp-query symbols myfile` to force.
---
> Source: [AgentWorkers/skills](https://github.com/AgentWorkers/skills) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->
章节与文件索引
按说明文件中的顺序排列。
支持的语言
先决条件
安装
配置
命令
文件/命令 -> pyright-langserver · npm install -g pyright · typescript-language-server · npm install -g typescript-language-server typescript · rust-analyzer · rustup component add rust-analyzer · gopls · go install golang.org/x/tools/gopls@latest
内容校验值 -> c9033f9e38a3
当前原文的自动摘译,尚未人工审校。
支持的语言
语言 · 服务器 · 扩展 · 安装 Python ·
pyright-langserver· .py、.pyi、.pyx ·npm install -g pyrightTypeScript/JS ·typescript-language-server· .ts、.tsx、.js、.jsx、.mjs、.cjs ·npm install -g typescript-language-server typescriptRust ·rust-analyzer· .rs ·rustup component add rust-analyzer去 ·gopls· .go ·go install golang.org/x/tools/gopls@latest先决条件
Python 3.10+(对于客户端脚本本身 - 仅 stdlib,无 pip deps) 至少安装一种语言服务器(参见上表)
安装
该技能包括位于
{baseDir}/scripts/lsp-query.py的Python脚本。这是 LSP 客户端——它管理后台守护进程并处理所有查询。要使其可以从任何地方作为lsp-query进行调用,请将其符号链接到您的 PATH 中:或者,直接调用它:配置
在查询之前将
LSP_WORKSPACE设置为存储库根目录。如果未设置,则默认为 git root 或 cwd。命令
所有行号和列号均为 1 索引(人性化、匹配编辑器显示)。