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

Ouverte Adaptée aux débutants
#3,050 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
75/100
Type d'issue
Bug
Clarté
Clairement spécifiée
Activité
Active
Stack technique
markdown

Piste de recherche

Commencez par localiser le code de l’installeur qui génère la SKILL.md de codebase-memory et le bloc codebase-memory-mcp dans les fichiers d’instructions destinés aux agents. Lisez les exemples existants d’appels d’outils et confirmez les formes d’invocation prises en charge à partir de la CLI ou des définitions des outils MCP. Mettez à jour les instructions générées avec des exemples exécutables pour les arguments JSON natifs et les appels d’exécution de code ; le travail est terminé lorsque les fichiers nouvellement générés expliquent la forme abrégée et montrent les deux formes.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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.
Langage dominant
C
Étoiles
45.8k
Forks
3.8k
Merge moyen
1 j 23 h
PR mergées (30 j)
83

Préparer son environnement

Ce projet ne fournit ni conteneur de développement, ni Dockerfile, ni guide de contribution : l'installation est à votre charge. Commencez par son README, et consultez notre guide de la première contribution pour les étapes générales.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de DeusData/codebase-memory-mcp

Toutes les issues de DeusData/codebase-memory-mcp

Issues similaires

Plus d'issues C

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.