Generated client files (AGENTS.md block, SKILL.md) teach a call syntax no harness can execute
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 75/100
- issue の種類
- バグ
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- markdown
調査の方向性
まず、codebase-memory の SKILL.md と、エージェント向け指示ファイル内の codebase-memory-mcp ブロックを生成するインストーラーコードを探してください。既存のツール呼び出し例を読み、CLI または MCP ツールの定義を照合して、サポートされる呼び出し形式を確認してください。ネイティブ JSON 引数とコード実行呼び出しの実行可能な例を、生成されるガイダンスに追加してください。新たに生成されたファイルで省略形を説明し、両方の形式を示せたら完了です。
索引モデルが issue の本文から書いたものです。
説明
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
- Install 0.12.1 via the release archive / install.sh path.
- Open the generated
codebase-memoryskill's SKILL.md, and thecodebase-memory-mcpblock in the generated agent instructions file (AGENTS.md/CLAUDE.md). - Observe the examples use
tool(param="...")syntax, and the section heading "15 MCP Tools". - 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. - 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 を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
DeusData/codebase-memory-mcp のほかの issue
-
parsing/quality
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
DeusData/codebase-memory-mcp#3062 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
editor/integration parsing/quality
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
DeusData/codebase-memory-mcp#2286 ·
メンテナーはふだん 1 日以内に返信
-
install writes an unsupported `args` key into the Claude Code SubagentStart hook, so it never runsオープンbug editor/integration priority/high stability/performance ux/behavior
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
DeusData/codebase-memory-mcp#2239 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
bug priority/high ux/behavior
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
DeusData/codebase-memory-mcp#2232 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信
-
documentation editor/integration parsing/quality priority/normal
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
DeusData/codebase-memory-mcp#2169 ·
メンテナーはふだん 1 日以内に返信
DeusData/codebase-memory-mcp の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
メンテナーはふだん 1 日以内に返信
-
area:gates kind:gate-defect
難易度 2/5 1〜3時間 初心者へのやさしさ 83/100
InauguralSystems/EigenScript#2476 ·
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 92/100
flipperdevices/flipperzero-firmware#4520 ·
メンテナーはふだん 1 日以内に返信
-
area/build-framework kind/enhancement priority/low
難易度 2/5 1〜3時間 初心者へのやさしさ 77/100
yugabyte/yugabyte-db#38826 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
the-miint/duckdb-miint#497 ·
メンテナーはふだん 1 日以内に返信