跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

speq-code-tools

Semantic code navigation and editing via Serena MCP — symbol-level tools required over grep/find/manual edits. Triggered by planner-agent, implementer-agent, implementer-expert-agent, code-reviewer, and recorder-agent.

marconae · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add marconae/speq-skill --skill speq-code-tools

技能说明


name: speq-code-tools description: Semantic code navigation and editing via Serena MCP — symbol-level tools required over grep/find/manual edits. Triggered by planner-agent, implementer-agent, implementer-expert-agent, code-reviewer, and recorder-agent.

Code Tools

Semantic code navigation and editing via Serena MCP. Tools are called mcp__plugin_speq_serena__<name> (e.g. mcp__plugin_speq_serena__find_symbol); this skill refers to them by short name below.

Before First Use Each Session

  1. Call initial_instructions first, before any other Serena tool.
  2. These tools are deferred in this harness — a bare tool name has no loaded schema yet. Call ToolSearch with select:mcp__plugin_speq_serena__<name> (comma-separated for several) to load the ones you need before calling them.

Tool Preference

You MUST use these instead of the generic alternative — do not fall back to Read/Grep/Edit/ls/find for anything this table covers.

TaskUseNot
List directorylist_dirls, find
Find filesfind_filefind, rg --files
File symbolsget_symbols_overviewrg "class|function"
Symbol definitionfind_symbolrg "function foo"
Symbol declarationfind_declarationrg guesswork
Symbol referencesfind_referencing_symbolsrg "foo("
Interface/method implementationsfind_implementationsrg "impl .* for"
LSP diagnostics for a fileget_diagnostics_for_filemanual build/check
Update functionreplace_symbol_bodyread/edit/write
Insert afterinsert_after_symbolread/edit/write
Insert beforeinsert_before_symbolread/edit/write
Rename symbolrename_symbolrg + manual edits
Delete symbolsafe_delete_symbolmanual delete + grep for refs
In-file text/regex replacereplace_contentread/edit/write
Multi-file pattern replacereplace_in_filesmultiple manual edits

Memory tools (write_memory, read_memory, list_memories, delete_memory, edit_memory, rename_memory) exist and are available, but this project's specs (specs/, specs/_plans/.../notes/) are the source of truth — they are not part of this workflow.

Workflow

Session start → initial_instructions
Explore → find_symbol, get_symbols_overview, find_declaration
Understand → find_referencing_symbols, find_implementations
Edit → replace_symbol_body, insert_*_symbol, replace_content, replace_in_files
Verify → find_referencing_symbols, get_diagnostics_for_file