SuperAPI AI 工具集

serena-skills

智能体与模型

查看项目

更新于 10-16 05:00

技能介绍

用途:把原本由 Serena MCP 服务器提供的代码智能工具,改为一组可独立调用的 Python 脚本,用于理解代码库、搜索与修改代码、重构、记录项目知识等。

主要能力与脚本分类:

  1. 符号搜索(LSP):get_symbols_overview.py(--file)查看文件结构;find_symbol.py(--pattern)按名称路径搜索;find_referencing_symbols.py(--symbol-name)查找引用;insert_after_symbol.py / insert_before_symbol.py(--symbol-path)在符号前后插入;rename_symbol.py(--old-name、--new-name)安全重命名并更新引用。
  2. 记忆管理:write_memory.py / read_memory.py / list_memories.py / delete_memory.py / edit_memory.py,存储在 .tmp/.serena-skills/memories/。
  3. 文件操作:read_file.py、list_dir.py、find_file.py、search_for_pattern.py(正则搜索)。
  4. 代码编辑:replace_symbol_body.py(符号级)、replace_content.py(文本或正则替换)、create_text_file.py、delete_lines.py / replace_lines.py / insert_at_line.py。
  5. 项目配置:activate_project.py(注册并创建 .tmp/.serena-skills/,可指定 --language)、list_projects.py、get_config.py、get_project_config.py / update_project_config.py、remove_project.py。
  6. 工作流辅助:onboarding 文档的检查/创建/获取/更新,think_collected_info.py、think_task_adherence.py、think_are_done.py。
  7. Shell 执行:execute_shell_command.py(--command),带超时保护。

用法:从项目根目录运行,路径前缀为 .claude/skills/serena-skills/scripts/。所有脚本支持 --project-root(当前目录用 .)。示例:python .claude/skills/serena-skills/scripts/symbol-search/find_symbol.py --project-root . --pattern "MyClass"。

选择建议:理解代码用符号概览与符号搜索;改代码用符号级 replace_symbol_body.py 或文本级 replace_content.py;广泛改名用 rename_symbol.py,批量模式替换用 replace_content.py;记录用 write_memory.py 或 update_onboarding.py。

要求与限制:需要 Python 3.8+,LSP 工具需相应语言服务器(如 Python 用 pyright),存在 .venv 时自动检测。数据、记忆与配置存放于项目的 .tmp/.serena-skills/。常见问题:LSP 超时可能是语言不匹配或项目过大,可指定 --language 或 --lsp-timeout;模块找不到需按 SETUP.md 安装依赖;无 python3 时改用 python;导入错误可设置 PYTHONPATH 或进入脚本目录运行。具体安装步骤、收费与支持平台信息暂未提供。