コーディングエージェントの能力を拡張する Serena を試してみた

curl -LsSf https://astral.sh/uv/install.sh | sh

uvx --from git+https://github.com/oraios/serena serena start-mcp-server

claude mcp add serena -s project -- uvx --from git+https://github.com/oraios/serena serena start-mcp-server --context ide-assistant --project $(pwd)

{
  "mcpServers": {
    "serena": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/oraios/serena",
        "serena",
        "start-mcp-server",
        "--context",
        "ide-assistant",
        "--project",
        "/Users/xxx/sapper-blog-app"
      ],
      "env": {}
    }
  }
}

claude

Serena のオンボーディングを開始してください。

 Serenaオンボーディングが完了しました。
 
  プロジェクトの主要な情報をメモリファイルに保存しました：
 
  - project_overview.md - プロジェクトの目的、技術スタック、アーキテクチャ
  - suggested_commands.md - 開発で使用する主要なコマンド
  - code_style_conventions.md - コードスタイルと命名規則
  - task_completion_checklist.md - タスク完了時に実行すべきコマンド
  - content_processing_pipeline.md - マークダウン処理パイプラインの詳細

# Project Overview
 
## Purpose
This is azukiazusa's personal blog application (https://azukiazusa.dev) built as a Turborepo monorepo using npm workspaces. The blog is deployed to Cloudflare Pages and uses Contentful as a CMS for managing blog posts and content.
 
## Tech Stack
- **Framework**: SvelteKit 2.x with Svelte 5 runes
- **Deployment**: Cloudflare Pages with SPA fallback
- **Content Management**: Contentful CMS with GraphQL
- **Styling**: TailwindCSS 4.x
- **Build System**: Turborepo with npm workspaces
- **Testing**: Vitest (unit tests), Playwright (E2E tests)
- **Development Tools**: Storybook for component development
- **Content Processing**: Unified ecosystem with custom remark/rehype plugins
 
## Project Structure
- `app/` - Main SvelteKit application
- `contents/` - Blog post markdown files and content
- `packages/` - Shared packages including custom remark/rehype plugins and ESLint configs
  - `remark-link-card/` - Custom plugin for link cards
  - `remark-video/` - Custom plugin for video embeds
  - `remark-contentful-image/` - Custom plugin for Contentful images
  - `rehype-alert/` - Custom plugin for alerts
  - `eslint-config-custom/` - Shared ESLint configuration
  - `content-management/` - Content management utilities
 
## Architecture
- **Repository Pattern**: Uses dependency injection via `RepositoryFactory.ts`
- **Environment-aware**: Production uses real implementations (GitHub API, Google Analytics), Development/Preview uses mock implementations
- **Content Pipeline**: Unified markdown processing pipeline in `markdownToHtml.ts`
- **Static Generation**: Prerendering enabled with SvelteKit

# language of the project (csharp, python, rust, java, typescript, go, cpp, or ruby)
#  * For C, use cpp
#  * For JavaScript, use typescript
# Special requirements:
#  * csharp: Requires the presence of a .sln file in the project folder.
language: typescript
 
# whether to use the project's gitignore file to ignore files
# Added on 2025-04-07
ignore_all_files_in_gitignore: true
# list of additional paths to ignore
# same syntax as gitignore, so you can use * and **
# Was previously called `ignored_dirs`, please update your config if you are using that.
# Added (renamed)on 2025-04-07
ignored_paths: []
 
# whether the project is in read-only mode
# If set to true, all editing tools will be disabled and attempts to use them will result in an error
# Added on 2025-04-18
read_only: false
 
# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
# Below is the complete list of tools for convenience.
# To make sure you have the latest list of tools, and to view their descriptions, 
# execute `uv run scripts/print_tool_overview.py`.
#
#  * `activate_project`: Activates a project by name.
#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
#  * `create_text_file`: Creates/overwrites a file in the project directory.
#  * `delete_lines`: Deletes a range of lines within a file.
#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
#  * `execute_shell_command`: Executes a shell command.
#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file or directory.
#  * `initial_instructions`: Gets the initial instructions for the current project.
#     Should only be used in settings where the system prompt cannot be set,
#     e.g. in clients you have no control over, like Claude Desktop.
#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
#  * `insert_at_line`: Inserts content at a given line in a file.
#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
#  * `list_memories`: Lists memories in Serena's project-specific memory store.
#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
#  * `read_file`: Reads a file within the project directory.
#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
#  * `remove_project`: Removes a project from the Serena configuration.
#  * `replace_lines`: Replaces a range of lines within a file with new content.
#  * `replace_symbol_body`: Replaces the full definition of a symbol.
#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
#  * `search_for_pattern`: Performs a search for a pattern in the project.
#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
#  * `switch_modes`: Activates modes by providing a list of their names
#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
excluded_tools: []
 
# initial prompt for the project. It will always be given to the LLM upon activating the project
# (contrary to the memories, which are loaded on demand).
initial_prompt: ""
 
project_name: "sapper-blog-app"

⏺ コードベースを分析した結果、いくつかのリファクタリングの機会を特定できます。以下が主な改
  善点です：
 
  1. Repository インスタンス化の重複除去
 
  問題: 各ルートファイルで同じパターンのRepository取得コードが重複している
  const PostRepository = RepositoryFactory[POST];
  const ShortRepository = RepositoryFactory[SHORT];
 
  改善案: 共通のRepository取得関数またはフックを作成
 
  2. markdown処理での型安全性の問題
 
  問題: markdownToHtml.tsで多数のeslint-disableが使用されている
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
  } as any;
 
  改善案: 適切な型定義を作成して型安全性を向上
 
  3. RSS/LLMs.txt生成の共通化
 
  問題: rss.xmlとllms.txtエンドポイントで似たようなデータ取得・変換ロジックが重複
 
  改善案: 共通のフィード生成ユーティリティを作成
 
  4. エラーハンドリングの一貫性
 
  問題: ルートハンドラーでのエラーハンドリングパターンが統一されていない
 
  改善案: 共通のエラーハンドリングミドルウェアを作成
 
  5. 環境変数によるRepository切り替えロジック
 
  問題: RepositoryFactory.tsでの環境変数チェックが直接埋め込まれている
 
  改善案: 設定ベースのRepository選択システムに変更
 
  これらの改善により、コードの保守性、型安全性、再利用性が向上します。特に優先度が高いのは1
  と2です。

1. Repository インスタンス化の重複除去を行ってください。

⏺ Repository インスタンス化の重複除去が完了しました！
 
  リファクタリング完了の概要:
 
  ✅ 共通ユーティリティ作成: useRepositories.tsを作成し、Repositoryの取得ロジックを一元化
  ✅ 全ルートファイル更新: 19個のルートファイルで重複していた以下のパターンを削除:
  // Before
  const PostRepository = RepositoryFactory[POST];
  const ShortRepository = RepositoryFactory[SHORT];
 
  // After  
  const { post, short } = useRepositories();
 
  ✅ 型安全性: TypeScriptの型チェックが全て通過
  ✅ コード品質: ESLintによるリントも通過
  ✅ 変数名競合の解決: post、short、tagなどの変数名競合も適切に処理
 
  改善効果:
 
  1. コード重複の削除: 各ルートファイルでのRepository取得ロジックの重複を完全に除去
  2. 保守性の向上: Repository取得方法を変更する場合、useRepositories.tsのみ修正すれば良い
  3. 一貫性の確保: 全てのルートで統一されたRepository取得パターンを使用
  4. 可読性の向上: より簡潔で分かりやすいコードに
 
  リファクタリングは完了し、全てのテストも通過しています。

npx ccusage session
 
┌───────────────┬──────────────┬──────────┬──────────┬────────────┬──────────────┐
│ Session       │ Models       │    Input │   Output │ Cost (USD) │ Last         │
│               │              │          │          │            │ Activity     │
├───────────────┼──────────────┼──────────┼──────────┼────────────┼──────────────┤
│ blog-app      │ - sonnet-4   │      273 │    9,582 │      $3.01 │ 2025-08-02   │
├───────────────┼──────────────┼──────────┼──────────┼────────────┼──────────────┤