Dianel555/DSkills / skills/serena
serena
VerifiedSemantic code understanding with IDE-like symbol operations. Use when: (1) Large codebase analysis (>50 files), (2) Symbol-level operations (find, rename, refactor), (3) Cross-file reference tracking, (4) Project memory and session persistence, (5) Multi-language semantic navigation. Triggers: "find symbol", "rename function", "find references", "symbol overview", "project memory". IMPORTANT: Prioritize Serena's symbolic tools over file-based grep/read for code exploration.
| File | Kind | Size |
|---|---|---|
| .env.example | other | 619 B |
| README.md | markdown | 6.8 KB |
| SKILL.md | skill md | 7.1 KB |
| tools/__init__.py | script | 310 B |
| tools/__main__.py | script | 94 B |
| tools/cli/__init__.py | script | 3.4 KB |
| tools/cli/cmd.py | script | 1.0 KB |
| tools/cli/config.py | script | 1.1 KB |
| tools/cli/dashboard.py | script | 5.3 KB |
| tools/cli/file.py | script | 1.4 KB |
| tools/cli/memory.py | script | 1.5 KB |
| tools/cli/symbol.py | script | 3.7 KB |
| tools/cli/workflow.py | script | 780 B |
| tools/core.py | script | 7.8 KB |
| tools/extended/__init__.py | script | 30 B |
| tools/extended/cmd_tools.py | script | 3.7 KB |
| tools/extended/config_tools.py | script | 4.9 KB |
| tools/output.py | script | 402 B |
| tools/paths.py | script | 1.5 KB |
| tools/server/__init__.py | script | 110 B |
| tools/server/dashboard_server.py | script | 14.1 KB |
| tools/tests/__init__.py | script | 30 B |
| tools/tests/conftest.py | script | 256 B |
| tools/tests/test_cli_dashboard.py | script | 3.0 KB |
| tools/tests/test_cli_file.py | script | 3.4 KB |
| tools/tests/test_cli_memory.py | script | 2.6 KB |
| tools/tests/test_core.py | script | 5.4 KB |
| tools/tests/test_module_path.py | script | 3.0 KB |
| tools/tests/test_paths.py | script | 2.8 KB |
tools/tests/test_core.py
View on GitHub"""Tests for SerenaCore context detection."""
import os
from pathlib import Path
from unittest.mock import patch
import tempfile
import shutil
def test_context_detection_claude_code_directory():
"""Test Claude Code detection via .claude directory."""
from tools.core import SerenaCore
with tempfile.TemporaryDirectory() as tmpdir:
tmppath = Path(tmpdir)
(tmppath / ".claude").mkdir()
core = SerenaCore(project=str(tmppath))
assert core.context == "claude-code"
def test_context_detection_claude_code_env():
"""Test Claude Code detection via CLAUDECODE environment variable."""
from tools.core import SerenaCore
with tempfile.TemporaryDirectory() as tmpdir:
with patch.dict(os.environ, {"CLAUDECODE": "1"}):
core = SerenaCore(project=tmpdir)
assert core.context == "claude-code"
def test_context_detection_vscode_directory():
"""Test VSCode detection via .vscode directory."""
from tools.core import SerenaCore
with tempfile.TemporaryDirectory() as tmpdir:
tmppath = Path(tmpdir)
(tmppath / ".vscode").mkdir()
core = SerenaCore(project=str(tmppath))
assert core.context == "ide"
def test_context_detection_vscode_env():
"""Test VSCode detection via VSCODE_PID environment variable."""
from tools.core import SerenaCore
with tempfile.TemporaryDirectory() as tmpdir:
with patch.dict(os.environ, {"VSCODE_PID": "12345"}):
core = SerenaCore(project=tmpdir)
assert core.context == "ide"
def test_context_detection_jetbrains_directory():
"""Test JetBrains detection via .idea directory."""
from tools.core import SerenaCore
with tempfile.TemporaryDirectory() as tmpdir:
tmppath = Path(tmpdir)
(tmppath / ".idea").mkdir()
core = SerenaCore(project=str(tmppath))
assert core.context == "ide"
def test_context_detection_jetbrains_env():
"""Test JetBrains detection via IDEA_INITIAL_DIRECTORY environment variable."""
from tools.core import SerenaCore
with tempfile.TemporaryDirectory() as tmpdir:
with patch.dict(os.environ, {"IDEA_INITIAL_DIRECTORY": tmpdir}):
core = SerenaCore(project=tmpdir)
assert core.context == "ide"
def test_context_detection_codex_directory():
"""Test Codex detection via .codex directory."""
from tools.core import SerenaCore
with tempfile.TemporaryDirectory() as tmpdir:
tmppath = Path(tmpdir)
(tmppath / ".codex").mkdir()
core = SerenaCore(project=str(tmppath))
assert core.context == "codex"
def test_context_detection_codex_env():
"""Test Codex detection via CODEX_CLI_SESSION environment variable."""
from tools.core import SerenaCore
with tempfile.TemporaryDirectory() as tmpdir:
with patch.dict(os.environ, {"CODEX_CLI_SESSION": "test-session"}):
core = SerenaCore(project=tmpdir)
assert core.context == "codex"
def test_context_detection_default():
"""Test default context when no markers exist."""
from tools.core import SerenaCore
with tempfile.TemporaryDirectory() as tmpdir:
# Clean environment - remove keys if they exist
env_backup = {}
keys_to_remove = ["CLAUDE_CODE_SESSION", "VSCODE_PID", "IDEA_INITIAL_DIRECTORY", "CODEX_CLI_SESSION"]
for key in keys_to_remove:
if key in os.environ:
env_backup[key] = os.environ.pop(key)
try:
core = SerenaCore(project=tmpdir)
assert core.context == "agent"
finally:
# Restore environment
os.environ.update(env_backup)
def test_context_detection_priority_directory_over_env():
"""Test that directory markers take precedence over environment variables."""
from tools.core import SerenaCore
with tempfile.TemporaryDirectory() as tmpdir:
tmppath = Path(tmpdir)
(tmppath / ".claude").mkdir()
# Set conflicting environment variable
with patch.dict(os.environ, {"CODEX_CLI_SESSION": "test-session"}):
core = SerenaCore(project=str(tmppath))
# Should detect claude-code from directory, not codex from env
assert core.context == "claude-code"
def test_serena_core_initializes_config_path():
"""Test that SerenaCore initializes config path on creation."""
from tools.core import SerenaCore
with tempfile.TemporaryDirectory() as tmpdir:
with patch.dict(os.environ, {"SERENA_HOME": tmpdir}):
core = SerenaCore(project=tmpdir)
# Config file should be created
config_file = Path(tmpdir) / "serena_config.yml"
assert config_file.exists()
def test_get_dashboard_info_without_agent_uses_wrapper_state():
"""Test dashboard info fallback when agent is unavailable."""
from tools.core import SerenaCore
with tempfile.TemporaryDirectory() as tmpdir:
core = SerenaCore(project=tmpdir, context="codex", modes=["interactive", "editing"])
with patch.object(core, "_ensure_agent", side_effect=RuntimeError("agent unavailable")):
info = core.get_dashboard_info()
assert info["active_project_path"] == str(Path(tmpdir).resolve())
assert info["context"] == "codex"
assert info["active_modes"] == ["editing", "interactive"]
assert info["active_tools_count"] == 0
assert "codex" in info["available_contexts"]
assert "interactive" in info["available_modes"]
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |