From e56a932ee22047fb616eb9fba33adf72a2943f3d Mon Sep 17 00:00:00 2001 From: Nick Shirokov Date: Thu, 2 Apr 2026 15:01:10 +0300 Subject: [PATCH] docs(switch): document --link __dirname limitation Node.js resolves __dirname through junctions to the real target path, not the junction location. This causes Node.js-based skills (e.g. web-test) to write output files to the skills repo directory instead of the project directory. Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 2e22aa9c..23e29a2c 100644 --- a/README.md +++ b/README.md @@ -76,7 +76,9 @@ python scripts/switch.py --undo cursor # удалить Если репозиторий склонирован внутрь проекта (например, в `tools/cc-1c-skills`), используйте `--project-dir` для установки навыков в целевой проект. -**Ссылки vs копии.** Флаг `--link` (экспериментальный) создаёт directory junction (Windows) или symlink (Linux/Mac) вместо копирования файлов. Обновления в источнике автоматически подхватываются во всех подключённых проектах — достаточно `git pull`. Ссылки доступны только для платформы Claude Code (для остальных платформ требуется перезапись путей в SKILL.md). Удаление ссылок: `--undo` — безопасно удаляет только ссылки, не трогая источник. На Windows при использовании ссылок возможны периодические ошибки запуска bash (MSYS `add_item` / exit code 5) — если столкнётесь, переключитесь на копирование. +**Ссылки vs копии.** Флаг `--link` (экспериментальный) создаёт directory junction (Windows) или symlink (Linux/Mac) вместо копирования файлов. Обновления в источнике автоматически подхватываются во всех подключённых проектах — достаточно `git pull`. Ссылки доступны только для платформы Claude Code (для остальных платформ требуется перезапись путей в SKILL.md). Удаление ссылок: `--undo` — безопасно удаляет только ссылки, не трогая источник. + +> ⚠ **Известные ограничения `--link`:** Node.js резолвит `__dirname` через junction к реальному пути источника, а не к каталогу проекта. Это может приводить к тому, что навыки с Node.js-скриптами (например, `/web-test`) будут записывать файлы в каталог репозитория навыков вместо каталога проекта. При возникновении проблем переключитесь на копирование (без `--link`). Поддерживаемые платформы: