Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

docs(skill): teach the lean search_code workflow

Aperta Adatta ai principianti
  • Qualcosa non va?
#2,169 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 2 giorni

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
85/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
c
Ambito
documentation

Direzione di ricerca

Leggi la skill integrata gestita dall'installer in src/cli/cli.c e il test di contratto cli_skill_files_content. Aggiungi le indicazioni richieste per Code Search Workflow senza modificare le istruzioni dell'agente caricate sempre né il comportamento di MCP. Il lavoro è completato quando le indicazioni chiave sono coperte dal test di contratto e il test viene superato.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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?

Lingua principale
C
Stelle
45.8k
Fork
3.8k
Merge medio
3g 6h
PR unite (30g)
201

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di DeusData/codebase-memory-mcp

Tutte le issue di DeusData/codebase-memory-mcp

Issue simili

Altre issue su C

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.