@

feat(skills): навык kompas-sdk-research + перенос kdoc.py в навык

Новый навык kompas-sdk-research делегирует поиск/чтение офлайн-справки КОМПАС SDK
субагенту Sonnet (экономит контекст Opus на 26k страниц WebHelp).
Навигатор kdoc.py перенесён tools/ → .claude/skills/kompas-sdk-research/ как часть навыка;
добавлен автопоиск каталога справки (вверх от CWD/скрипта или через KDOC_DIR),
чтобы скрипт работал из любой точки. Индекс остаётся в docs/kompas_sdk_index.tsv.
Ссылки обновлены в CLAUDE.md, README, ARCHITECTURE, presentation, .gitignore.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@

CLAUDE.md

@@ -7,18 +7,18 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 Build an **MCP (Model Context Protocol) server** that lets an LLM drive the CAD system **КОМПАС-3D** (ASCON). The server exposes КОМПАС operations (create/open documents, build 2D geometry, 3D parts and assemblies, read/write parameters, run macros) as MCP tools.
 
 Authoritative references:
-- **Offline SDK docs mirror in this repo: `docs/KOMPAS_SDK_ru-RU/`** — navigate it with `tools/kdoc.py` (see below). Prefer this over the web.
+- **Offline SDK docs mirror in this repo: `docs/KOMPAS_SDK_ru-RU/`** — navigate it with `.claude/skills/kompas-sdk-research/kdoc.py` (see below). Prefer this over the web. For non-trivial lookups, delegate to the **`kompas-sdk-research`** skill (Sonnet subagent) to save context.
 - Online SDK docs: https://help.ascon.ru/KOMPAS_SDK/22/ru-RU/index.html
 - Local SDK install: `C:\Program Files\ASCON\KOMPAS-3D v24 Home\SDK`
 
-## Navigating the SDK docs (`tools/kdoc.py`)
+## Navigating the SDK docs (`.claude/skills/kompas-sdk-research/kdoc.py`)
 
-`docs/KOMPAS_SDK_ru-RU/` is a 26 000-page Help&Manual WebHelp export — raw HTML buried under header/footer/JS noise, with cryptic filenames. **Do not browse it by hand.** Use the helper:
+`docs/KOMPAS_SDK_ru-RU/` is a 26 000-page Help&Manual WebHelp export — raw HTML buried under header/footer/JS noise, with cryptic filenames. **Do not browse it by hand.** Use the helper (bundled in the `kompas-sdk-research` skill; run from repo root, it auto-locates the docs):
 
 ```
-python tools/kdoc.py search "<russian or interface keywords>"   # find pages: prints "file.html\tTitle"
-python tools/kdoc.py read <file.html>                           # print clean topic text (no markup)
-python tools/kdoc.py build-index                                # regenerate the index (only if docs change)
+python .claude/skills/kompas-sdk-research/kdoc.py search "<russian or interface keywords>"   # find pages: prints "file.html\tTitle"
+python .claude/skills/kompas-sdk-research/kdoc.py read <file.html>                           # print clean topic text (no markup)
+python .claude/skills/kompas-sdk-research/kdoc.py build-index                                # regenerate the index (only if docs change)
 ```
 
 `search` does AND-matching over titles + excerpts; `read` extracts just the topic body (breadcrumb path, data type, Automation/COM syntax, parameters, return value, notes). Example: `search Visible IApplication` → `iapplication_visible.html`, then `read iapplication_visible.html`.