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

オープン 初心者向け
#3,050 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
75/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
markdown

調査の方向性

まず、codebase-memory の SKILL.md と、エージェント向け指示ファイル内の codebase-memory-mcp ブロックを生成するインストーラーコードを探してください。既存のツール呼び出し例を読み、CLI または MCP ツールの定義を照合して、サポートされる呼び出し形式を確認してください。ネイティブ JSON 引数とコード実行呼び出しの実行可能な例を、生成されるガイダンスに追加してください。新たに生成されたファイルで省略形を説明し、両方の形式を示せたら完了です。

索引モデルが issue の本文から書いたものです。

説明

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.
主要言語
C
スター
45.8k
フォーク
3.8k
平均マージ
1日 23時間
マージ済み PR(30日)
83

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

DeusData/codebase-memory-mcp のほかの issue

DeusData/codebase-memory-mcp の issue をすべて見る

似ている issue

C の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。