tarrragon/lsp-first
skills/lsp-first/SKILL.md
LSP 優先開發策略工具。Use for: (1) 查詢 LSP 操作指令, (2) 配置新語言 LSP 插件, (3) LSP vs MCP 工具選擇決策, (4) 自建 LSP 插件指南。Use when: 需要搜尋符號/定義/引用、想知道 LSP 和 MCP Serena 各自適合什麼場景、新增語言支援需要配置 LSP 時。
$ install --global
skillsauthnpx skillsauth add tarrragon/claude lsp-firstInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 27, 2026, 5:37 AM123.1s5 files scanned
SKILL.md
- name:
- lsp-first
- description:
- LSP 優先開發策略工具。Use for: (1) 查詢 LSP 操作指令, (2) 配置新語言 LSP 插件, (3) LSP vs MCP 工具選擇決策, (4) 自建 LSP 插件指南。Use when: 需要搜尋符號/定義/引用、想知道 LSP 和 MCP Serena 各自適合什麼場景、新增語言支援需要配置 LSP 時。
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
相關檔案
- 檢查腳本:
.claude/hooks/lsp-environment-check.py - 配置檔案:
.claude/hooks/lsp-check-config.json - 整合位置:
.claude/hooks/startup-check-hook.sh(步驟 6.6)
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
三 MCP 工具路由（指向 search-tools-guide）
自 W6-001 引入三 MCP（codebase-memory-mcp / codegraph / serena）後，「Serena 是唯一語意工具」的舊敘事已升級為「三刀流互補」。LSP-first 原則仍為精度錨點，但查詢入口擴展至三 MCP。
三 MCP 角色定位
| 工具 | 在 LSP-first 流程中的角色 | |------|--------------------------| | LSP / serena | 精度錨點：符號定義、引用追蹤、安全重命名、call hierarchy（型別感知不可替代） | | codebase-memory-mcp | 概念查詢入口：跨檔案語義搜尋、找「處理 X 概念的所有檔案」（BM25 + 向量混合） | | codegraph | 結構查詢入口：caller / callee / impact 圖譜追蹤，跨語言符號關係 |
路由原則
- 想找符號 → LSP / serena
find_symbol - 想找概念 / 範圍模糊 → cbm
search_graph（src/、docs/）或 rg（.claude/） - 想知道修改影響 → codegraph
impact+ serenafind_referencing_symbols雙重驗證 - 想做安全重構 → serena
rename_symbol/replace_symbol_body
完整三刀流決策樹、九維度對照表、命令速查、cbm 對 .claude/ 不索引的限制：/search-tools-guide（含 references/codebase-memory-tool.md）
LSP 伺服器配置
自建插件、官方插件市場、跨平台安裝、故障排除：references/lsp-setup-guide.md
相關資源
/search-tools-guide- 搜尋工具選擇指南（含 Dart MCP、Serena、Grep 完整對照）/startup-check- Session 啟動檢查- boostvolt/claude-code-lsps - 官方 LSP 插件市場
- Marksman - Markdown LSP
- yaml-language-server - YAML LSP
Last Updated: 2026-03-02 Version: 1.0.0
Related Skills
tarrragon/impeccable
development
VerifiedTrustedCommunity
Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
1SKILL.mdUpdated Jun 4, 2026
tarrragon/cc-release-impact-review
development
VerifiedTrustedCommunity
Claude Code release notes 框架影響評估工具。比對 last-reviewed 版本篩出新版本，逐項分類（對框架有幫助 / 需評估 / 無影響 / 不適用），對採用項引導建 ANA + WRAP + spawn 落地。Use when: 執行 /release-notes 看到新版本、定期檢查 CC 更新、評估新功能對專案框架的影響時。Triggers: release notes, release-notes, CC 更新, claude code 更新, 版本更新評估, 新功能評估, 框架影響評估。
1SKILL.mdUpdated Jun 4, 2026
tarrragon/test-assertion-design
development
VerifiedTrustedCommunity
Assertion design judgment framework for flaky and design-quality issues. Use when writing tests, reviewing assertions, diagnosing flaky tests, or deciding if a timing/float/cache assertion is appropriate. Do NOT use for API syntax or refactoring.
1SKILL.mdUpdated May 27, 2026
tarrragon/chrome-extension-mcp-debug
tools
VerifiedTrustedCommunity
Chrome Extension 實機測試與 debug 工作流，以 chrome-devtools-mcp 為核心工具。Use when: (1) 完成功能後實機驗證 / manual test / 試看看 / 跑看看 / verify feature, (2) extension debug / popup 不作動 / content script 不注入 / service worker 報錯 / background 出問題, (3) 安裝 unpacked extension / load unpacked / 載入未封裝, (4) 看 console / 看 network / 看 log / view console / inspect requests, (5) 功能更新後重新載入 extension / rebuild reload / reload extension。涵蓋 Manifest V3 service worker / content script / popup / options page 的 chrome-devtools-mcp 工具呼叫流程。不取代 Puppeteer / Playwright 自動化 E2E（CI 用），定位為開發期手動驗證與 LLM-assisted debug。
1SKILL.mdUpdated May 12, 2026