Serena は、複雑なマルチファイル ソフトウェア プロジェクトに対して、シンボル対応のセマンティック コード ナビゲーションとターゲットを絞った編集を提供します。
インストール＆ダウンロード
1. ClawHub CLI
レジストリから直接スキルをインストールする最速の方法です。
npx clawhub@latest install serena
2. 手動インストール
スキルフォルダを以下のいずれかの場所にコピーしてください
~/.openclaw/skills/ <project>/skills/ 優先順位：ワークスペース > ローカル > バンドル
3. プロンプトのインストール
このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。
Clawhubを使って serena をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください（npm i -g clawhub）。
ダウンロードをご希望ですか？
ZIPアーカイブで生のスキルファイルを取得します。
Serena Semantic Code Navigation とは？
Serena は、AI 主導のコーディング ワークフローへの深い統合のために設計された強力な開発者ツールです。リポジトリをテキスト ファイルの集まりとして扱う従来のツールとは異なり、Serena はセマンティックな理解を活用して、エージェントがシンボル スコープの検索、参照トレース、および構造の概要を通じてコードと対話できるようにします。このアプローチにより、高い精度と token 効率が保証され、重要で複雑な構造を持つ既存のコードベースにとって理想的な選択肢となります。
Serena のような Openclaw Skills を利用することで、開発者や AI エージェントは、リポジトリ全体で特定の関数へのすべての参照を検索したり、セマンティックな認識を持ってシンボルの名前を変更したりするなどの高度な操作を実行できます。これはファイル システム上のインテリジェントなレイヤーとして機能し、生のテキスト操作よりもコードのロジックと階層を優先します。
Serena Semantic Code Navigation のユースケース
- ファイルごとの読み取りが非効率的な、大規模なマルチファイル リポジトリのナビゲート。
- 実質的なコード変更を実行する前に、コール チェーンとシンボルの関係をトレースする。
- ファイル全体を書き換えることなく、関数、クラス、またはメソッドに対して精密なシンボル スコープの編集を実行する。
- プロジェクト全体でセマンティックな名前変更を実行して、一貫性を確保し、参照の破損を防ぐ。
- 新規または複雑なコードベースのハイレベルな構造の概要を把握する。
Serena Semantic Code Navigation の仕組み
- Project Activation: ワークフローは、ターゲット プロジェクト パスを解決し、
serena_activate_projectを呼び出してセマンティック インデックスを初期化することから始まります。 - Structure Discovery: エージェントは
serena_project_overviewやserena_find_symbolなどのツールを使用して、コードベースの階層を理解します。 - Scope Narrowing: ユーザーは
serena_find_referencesまたはserena_read_symbolを使用して特定のコード領域を特定し、token ノイズを最小限に抑えます。 - Semantic Editing:
serena_replace_symbol_bodyやserena_rename_symbolなどのスコープの狭いツールを使用して変更を適用します。 - Verification: エージェントは変更されたシンボルを再読み取りするか、
serena_session_statusを確認して、編集が成功し、構文的に正しいことを確認します。
Serena Semantic Code Navigation のセットアップ
Serena を環境に統合し、セマンティック ナビゲーションに Openclaw Skills の使用を開始するには、次の手順に従います。
- Serena サービスがエージェントの実行環境内でアクセス可能であることを確認します。
- プロジェクト ディレクトリをアクティブ化します。
# Replace [path] with your project root
serena_activate_project --path [path]
- セッションがアクティブであることを確認します。
serena_session_status
Serena Semantic Code Navigation のデータスキーマとタクソノミー
Serena は、フラットなファイル リストではなく、リポジトリのセマンティック モデルを中心にデータを整理します。次の表は、主なデータ エンティティを示しています。
| Entity | Description | Metadata Captured |
|---|---|---|
| Symbol | Functions, Classes, Methods | Name, Scope, Line Range, File Path |
| Reference | シンボルの使用インスタンス | Calling File, Context, Line Number |
| Session | アクティブなプロジェクトの状態 | Project Root, Index Status, Tool Availability |
| File | ソース コード ドキュメント | Path, Semantic Content, Structural Metadata |
Serena Semantic Code Navigation の高度な機能
- Symbol-Scoped Edits: 行番号ではなく、特定の AST ノードを基準にしてコードを置換または挿入します。
- Reference Tracing: リファクタリング前にプロジェクト全体の影響ポイントを自動的に特定します。
- Semantic Search: Grep よりもコード構造をよく理解するパターン マッチングとシンボル検索を使用します。
- Shell Escape Hatch: セマンティック ツールでは不十分な場合に、高度なプロジェクト コンテキスト操作のために
serena_execute_shell_commandを使用します。 - Multi-Agent Integration: 共同コーディングのために、異なる AI エージェント間で Serena コンテキストを渡すためのパターン。
SKILL.md
ローディング
関連するOpenclawのスキル
Mediaio 自動字幕生成器
リモートクラウド GPU 処理を使用して、ビデオファイルへの字幕の自動生成、同期、埋め込みを行うプロフェッショナルな AI 駆動ツールです。
Stripe Setup
PythonベースのWebアプリケーションに Stripe チェックアウトセッション、サブスクリプション課金、および自動化された webhook 処理を統合するための包括的なスキルです。
AIsa Provider
AIsa Provider スキルにより、OpenClaw ランタイムが AIsa ゲートウェイとインターフェースし、OpenAI 互換 API を通じて幅広い中国の LLMs へのアクセスが可能になります。
Cold Stone Creamery スキル
Cold Stone Creamery ブランドの体験型小売およびグローバルなフランチャイズモデルに焦点を当てた戦略的ビジネス分析スキル。
API Documentation Builder
ソースコードから、開発者に優しい API ドキュメント、OpenAPI 仕様、およびインタラクティブなコード例を自動的に生成する包括的なツールです。
特徴*
