/1c-code-search

name: 1c-code-search
description: "Find BSL code in a 1C project — routines by name, code by behaviour or exact literal, module layout, members of a context — through the graph and code-metadata MCP servers before any Grep. Use whenever a task needs to locate or read a fragment of BSL it does not yet have a path for."
argument-hint: "<what to find> [exact | semantic]"
allowed-tools: mcp__1c-graph-metadata-mcp__search_code, mcp__1c-code-metadata-mcp__codesearch, mcp__1c-code-metadata-mcp__search_function, mcp__1c-code-metadata-mcp__get_module_structure, mcp__1c-code-metadata-mcp__bsl_scope_members, mcp__1c-code-metadata-mcp__compact_symbol

1c-code-search — locate BSL code

Project-source search is MCP-first within verified contour coverage: graph → mapped code-metadata → scoped native `Grep` after a bounded miss with a one-line fallback note. Skip uncovered lanes; never substitute a neighboring contour's index. `content/rules/multi-contour-search.md` selects scope and server mappings for multiple roots; `content/rules/mcp-first-search.md` owns retrieval, freshness and native exceptions. This skill owns the calls below; any shared-server scope arguments must match its live contract.

Tools and exact arguments

Every graph call below includes the returned `project_id` matched to the current source roots; `<resolved-project-id>` in examples must be substituted, never sent literally. Discover via `list_graph_projects` using the `mcp-1c-tools` router before this skill when needed. Verify the relevant extension layer and response attribution. Code-server scope comes from its own live schema/mapping; do not copy graph arguments into it. Contract and ambiguity handling — `content/rules/multi-contour-search.md`.

| Need | Call | Arguments (exact names) | |---|---|---| | Code by behaviour / intent | `search_code` (graph) | `query`, `search_type="semantic"`, `detail_level="L1"`, `top_k=3`, optional `filter_type` | | Code by identifier / literal | `search_code` (graph) | `query`, `search_type="fulltext"`; miss → `codesearch(query, limit=5)` | | Hybrid fallback | `codesearch` (code) | `query`, `limit=5` — result count is `limit`, never `top_k` | | Routine by name | `search_function` (code) | `name`, `exact=true`, `limit=10`, optional `module_path` | | Full routine body | `search_code` | `detail_level="L0"` for one routine; or `compact_symbol(name, include_body=true)` | | Module layout before editing | `get_module_structure` (code) | `module_path` | | Members of a context | `bsl_scope_members` (code) | `context` (`Справочник.Номенклатура`, `Глобальный`), `member_type="all" \| "methods" \| "properties" \| "events"` |

Text searches above use `query`; routine lookup uses `name`. Do not invent `q`, `text`, `prompt` or `search_query`.

Calls

{"tool": "search_code", "args": {"project_id": "<resolved-project-id>", "query": "расчёт остатков по складу на дату", "search_type": "semantic", "detail_level": "L1", "top_k": 5}}
{"tool": "search_function", "args": {"name": "ОбработкаПроведения", "exact": true, "limit": 10}}
{"tool": "codesearch", "args": {"query": "ТекущаяДатаСеанса()", "limit": 5}}
{"tool": "get_module_structure", "args": {"module_path": "Documents/РеализацияТоваровУслуг/Ext/ObjectModule.bsl"}}

Miss handling

1. Reformulate once when useful, using only that tool's modes and parameters (`search_type`, `detail_level`, `top_k` / `limit`, `filter_type`, `module_path`). 2. Current Code search tools have no `grep` input. Read `search_layer: "grep"` as the server's internal file-scan fallback, not a request to resend the call. If an indexed search misses a literal, continue to scoped native search after the bounded attempt. 3. A typed server answer maps to an action by code — `content/rules/mcp-policy.md → C. Server answers → actions`; never probe the same gap through sibling tools. 4. Then native `Grep` / `Read`, with the note. Reading a file already located here is normal work.

Rare modes, response shapes, compact API paging: `content/skills/mcp-1c-tools/docs/1c-code-metadata-mcp.md`, `content/skills/mcp-1c-tools/docs/1c-graph-metadata-mcp.md`.