Generated client files (AGENTS.md block, SKILL.md) teach a call syntax no harness can execute

Abierto Apto para principiantes
#3,050 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
75/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
markdown

Línea de trabajo

Empieza por localizar el código del instalador que genera la SKILL.md de codebase-memory y el bloque de codebase-memory-mcp en los archivos de instrucciones para agentes. Lee los ejemplos existentes de llamadas a herramientas y confirma las formas de invocación admitidas consultando la CLI o las definiciones de herramientas MCP. Actualiza las instrucciones generadas con ejemplos ejecutables para argumentos JSON nativos y llamadas de ejecución de código; el trabajo estará terminado cuando los archivos recién generados expliquen la forma abreviada y muestren ambas formas.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

bug editor/integration parsing/quality windows
Version

0.12.1

Platform

Linux (x64)

Install channel

GitHub release archive / install.sh / install.ps1

Binary variant

standard

What happened, and what did you expect?

The client instruction files generated by the installer (the codebase-memory-mcp block written into agent instruction files such as AGENTS.md/CLAUDE.md, and the generated codebase-memory SKILL.md) teach tool calls with a syntax that no harness can execute:

  • search_graph(name_pattern=".*OrderHandler.*")
  • trace_path(function_name="OrderHandler", direction="inbound")
  • get_code_snippet(qualified_name="pkg/orders.OrderHandler")

The tool(param="...") keyword-args-in-parens form matches no actual invocation path. MCP tools are invoked either as native tool calls (a JSON object of arguments), or — in harnesses that route MCP tools through a code-execution tool — as code like tools["codebase-memory-mcp"].search_graph({ name_pattern: "..." }). An agent that tries to follow the example literally cannot produce a valid call and tends to fall back to grep, which quietly defeats the "ALWAYS prefer MCP graph tools over grep/glob" instruction in the same block.

Expected: the generated guidance should be executable. Concretely:

  • keep the tool(param=...) notation as shorthand in tables/workflows, but state explicitly that it is tool + params shorthand, not literal syntax;
  • add one concrete example per real invocation form (native tool call with JSON args, and the code-execution form);
  • optionally note that only a couple of the 17 tools appear in a code-execution tool catalog by default, so agents should list the server's tools before assuming one is missing.

Related but distinct: #3029 fixes the installed skill's query guidance content (its tool inventory also omits compare_graphs and get_file_outline — the generated SKILL.md still says "15 MCP Tools" on 0.12.1). This report is about the invocation syntax, which #3029 does not cover.

Reproduction
  1. Install 0.12.1 via the release archive / install.sh path.
  2. Open the generated codebase-memory skill's SKILL.md, and the codebase-memory-mcp block in the generated agent instructions file (AGENTS.md/CLAUDE.md).
  3. Observe the examples use tool(param="...") syntax, and the section heading "15 MCP Tools".
  4. Compare with any real invocation: e.g. codebase-memory-mcp cli search_graph '{"project":"...","name_pattern":"..."}' takes a JSON object of arguments; an MCP-native tool call likewise takes a JSON object. Neither matches the documented parenthesised keyword-arg form.
  5. In a harness that routes MCP tools through a code-execution tool, ask an agent to "find who calls X using the graph tools": it cannot map the examples to a real call and typically falls back to grep.

No indexed code is involved — the defect is in the generated files themselves.

Logs

Diagnostics trajectory (memory / performance / leak issues)

Project scale (if relevant)

No response

Confirmations
  • I searched existing issues and this is not a duplicate.
  • My reproduction uses shareable code (a dummy snippet or a public OSS repository), not proprietary code.
Lenguaje dominante
C
Estrellas
45.8k
Forks
3.8k
Merge medio
1 d 23 h
PR fusionados (30 d)
83

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de DeusData/codebase-memory-mcp

Todos los issues de DeusData/codebase-memory-mcp

Issues similares

Más issues de C

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.