LSP 優先開發策略 Skill

LSP 優先開發策略

核心原則

LSP 能解決的問題必須優先使用 LSP

| 優勢 | 說明 | 效益 | |------|------|------| | 效能 | ~50ms vs ~45 秒 | 900x 加速 | | Token 效率 | 結構化資料輸出 | 降低 API 成本 | | 語意精準 | 語言伺服器分析 | 非文字比對 |

詳細效能資料：references/performance-comparison.md

LSP 環境自動檢查

Session 啟動時自動執行 LSP 環境檢查

檢查項目

基本 LSP（所有專案必備）
- marksman (Markdown)
- yaml-language-server (YAML)
語言特定 LSP（根據專案類型）
- Flutter/Dart: Dart SDK 內建 LSP
- TypeScript/JavaScript: vtsls
- Python: pyright
- Go: gopls
- Rust: rust-analyzer

LSP 9 種操作速查

| 操作 | 用途 | 使用場景 | |------|------|---------| | goToDefinition | 跳轉符號定義 | 追蹤函式來源、查看類別定義 | | findReferences | 查找所有引用 | 重構前影響分析、變更評估 | | hover | 懸停型別資訊 | 查看 API 文件、確認參數型別 | | documentSymbol | 列出檔案符號 | 快速理解檔案結構 | | workspaceSymbol | 跨檔案搜尋 | 找出類別定義、模糊查詢 | | goToImplementation | 實作查找 | 追蹤抽象類別實作 | | prepareCallHierarchy | 呼叫層級準備 | 準備函式呼叫分析 | | incomingCalls | 呼叫來源 | 找出誰呼叫了這個函式 | | outgoingCalls | 呼叫目標 | 找出這個函式呼叫了誰 |

各操作詳解、範例和 Dart MCP 替代方案：references/lsp-operations.md

工具選擇

搜尋工具的完整選擇決策樹和場景對照表，詳見 /search-tools-guide。

以下為 LSP 專屬的選擇要點：

LSP 獨佔能力（無法由其他工具替代）

| 能力 | LSP 操作 | |------|---------| | 呼叫層級分析 | incomingCalls / outgoingCalls | | 介面實作查找 | goToImplementation | | 精確型別推導 | hover（語意級別） |

工具優先順序

優先: LSP 工具（語意精準、效能最佳）
次選: Dart MCP / Serena MCP（LSP 功能等效替代）
備援: 傳統 Grep/Glob 搜尋

Dart MCP 和 Serena MCP 的工具列表與使用建議：/search-tools-guide

LSP 伺服器配置

自建插件、官方插件市場、跨平台安裝、故障排除：references/lsp-setup-guide.md

Agent Skills: LSP 優先開發策略

Install this agent skill to your local

Skill Files