Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

docs(skill): teach the lean search_code workflow

オープン 初心者向け
  • 何か問題がありますか？
#2,169 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

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

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
85/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
c
領域
documentation

調査の方向性

src/cli/cli.c にあるインストーラー管理の埋め込みスキルと、契約テスト cli_skill_files_content を読みます。常に読み込まれるエージェント指示や MCP の動作を変更せずに、要求された Code Search Workflow のガイダンスを追加します。契約テストで重要なガイダンスが網羅され、テストが成功すれば完了です。

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

説明

documentation editor/integration parsing/quality priority/normal

Problem

The installed codebase-memory skill routes text searches to search_code, but it does not explain how to use the lean output controls now available on main. In practice, agents can respond to broad results by raising limit or combining mode: "full" with a high limit, producing unnecessarily large MCP responses. Literal alternation such as foo|bar is also easy to send without regex: true.

The current release, v0.10.8, does not expose the newer controls. Current main already implements the server-side pieces: max_output_tokens, independent ranked/raw/directory pagination, bounded source and raw-line expansion, semantic truncation metadata, and the literal-pipe warning. This proposal does not change the MCP API or handler behavior.

Proposal

Add a concise Code Search Workflow section to the installer-owned embedded codebase-memory skill in src/cli/cli.c:

  1. Use search_graph(semantic_query=[...]) for broad natural-language discovery.
  2. Use search_graph for known or partial symbols.
  3. Use search_code for exact identifiers, literals, errors, and settings.
  4. Start with compact or files, result_limit: 10, and max_output_tokens: 3200.
  5. Narrow with path_filter and file_pattern before paging via returned offsets.
  6. Treat omissions as a narrowing signal rather than immediately raising limits.
  7. Reserve full for one to three expected hits and bound source_max_lines.
  8. Require regex: true for patterns such as foo|bar.
  9. Explicitly call out full + high limit as an anti-pattern.

Keep the always-loaded agent instructions unchanged so detailed usage guidance costs context only when the skill is loaded. Extend cli_skill_files_content to contract-test the key guidance.

Non-goals

  • No MCP schema or behavior changes.
  • No new include_tests or generated-file controls. Existing scoped search, ignore rules, and test-result ranking remain unchanged.
  • No default changes or compatibility impact.

Would this focused skill-guidance change be acceptable?

主要言語
C
スター
45.8k
フォーク
3.8k
平均マージ
3日 4時間
マージ済み PR（30日）
208

環境構築

このプロジェクトには開発コンテナ、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 を短くまとめたダイジェスト。