symbols

はじめに

選択した Language Server に接続することで、この MCP サーバーはコーディングエージェントがコードベースとその依存関係を効率よく調査し、移動できるようにします。 このサーバーは、使いやすく、モデルのコンテキストを圧迫しないように設計された、最小限のツール、リソース、スキルを提供します。

ツール

• outline：ファイル内のコードシンボルのアウトラインを返します。必要に応じて短いコードスニペットも含めます
• inspect：サードパーティのシンボルも含め、シンボルのドキュメント、宣言の場所、実装の場所を返します
• search：コードベース全体から一致するシンボルを返します
• references：コードベース全体からシンボルへの参照をすべて検索します
• call_hierarchy：呼び出し可能なシンボルの呼び出し元と呼び出し先の関係を返します
• rename：コードベース全体にあるシンボルへの参照をすべて一括で名前変更します
• diagnostics：指定したファイルの有効な診断情報を返します
• completion：指定した位置で、コンテキストに応じた補完候補を返します
• reload：有効な設定を再読み込みし、現在実行中の Language Server に再適用します

リソース

• language-servers://profiles：設定済みの Language Server とその状態を返します。
• language-servers://profiles/{name}：1 つの Language Server の詳細を返します。
• language-servers://profiles/{name}/logs：トラブルシューティング用に Language Server のログを返します。

スキル

• install-language-server：現在のワークスペース用に、Language Server のプロファイルをインストール、設定、検証、またはトラブルシューティングします。
• language-server-navigation：テキスト検索に切り替える前に、Language Server ツールを使ってシンボルの調査、参照の検索、名前変更、診断、検索を行う方法を案内します。

インストール

Codex

codex plugin marketplace add p1va/symbols
codex plugin add symbols@symbols

続いて、Codex に次のように依頼します。

Please install and configure the language servers relevant to this codebase

Antigravity

agy plugin install https://github.com/p1va/symbols.git

続いて、Antigravity に次のように依頼します。

このコードベースに関連する Language Server をインストールして設定してください。

手動インストール

手動設定と Language Server の設定例については、こちらを参照してください。

開発

• pnpm lint は lint 違反を出力します
• pnpm lint:fix は lint 違反の修正を試みます
• pnpm format はコードベースのフォーマットを整えます
• pnpm format:check はファイルを変更せずにフォーマットを確認します
• pnpm dev は開発モードで起動します
• pnpm build は linter を実行してビルドします
• pnpm start はビルド済みの成果物を起動します
• pnpm test:unit は単体テストを実行します
• pnpm test:integration:{language id} は指定した言語の統合テストを実行します

リリース

• pnpm version patch は生成済みアセットを同期し、バージョンを更新して、 1 つのコミットとタグを作成します。必要に応じて minor または major を指定します。
• git push --follow-tags はコミットとタグをプッシュします。

バージョン更新のライフサイクルでは、フォーマットを確認し、.agents/skills/ を Antigravity と Codex の配布物にミラーリングしてから、コミットとタグの作成前に、 バージョン付きの Codex プラグインマニフェストを更新します。