Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

docs(skill): teach the lean search_code workflow

Abierto Apto para principiantes
  • ¿Algo no está bien?
#2,169 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 2 días

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
85/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
c
Área
documentation

Línea de trabajo

Lee la skill integrada y gestionada por el instalador en src/cli/cli.c y la prueba de contrato cli_skill_files_content. Añade las directrices solicitadas para Code Search Workflow sin cambiar las instrucciones del agente que siempre se cargan ni el comportamiento de MCP. El trabajo estará terminado cuando la prueba de contrato cubra las directrices clave y pase.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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?

Lenguaje dominante
C
Estrellas
45.8k
Forks
3.8k
Merge medio
3 d 4 h
PR fusionados (30 d)
208

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de DeusData/codebase-memory-mcp

Todos los issues de DeusData/codebase-memory-mcp

Issues similares

Más issues de C

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.