Instruction file imported from yellow-hammer/vscode-1c-platform-tools (
.cursor/rules/skills-style.mdc). Copyright stays with the author.
Стиль навыков (skills)
Ориентир по структуре и формулировкам — cc-1c-skills: навыки с чётким описанием, триггерами и примерами.
Frontmatter
- name — идентификатор навыка (латиница, дефисы).
- description — кратко, что делает навык, и триггеры для автоактивации: «Используй, когда пользователь просит X, Y, Z». Это помогает агенту подобрать навык по формулировке пользователя.
Структура контента
- Заголовок — краткое название (что делает навык).
- Когда вызывать (опционально) — таблица «Запрос пользователя (примеры)» → «Действие». Полезно для навыков с 1–3 сценариями (например run).
- Таблицы «Задача → Command ID / MCP tool» — без изменений; одна секция для MCP, при необходимости вторая для Execute Command.
- Параметр projectPath (для MCP) — отдельная подсекция:
- обязательность;
- откуда брать: если пользователь указал путь — использовать; иначе корень workspace (каталог с packagedef).
- Важно — что не использовать (например launch_edit/launch_run для запуска Конфигуратора), ограничения.
- Примеры — 2–4 коротких примера вызова (MCP с projectPath, команда). Без лишнего кода, достаточно формулировки «вызови X с projectPath = …».
Отличия от cc-1c-skills
- У них: слэш-команды (/db-run), PowerShell-скрипты,
.v8-project.json. У нас: команды расширения и MCP (Execute Command / инструменты mcp-1c-platform-tools). - allowed-tools и argument-hint в frontmatter у них для Claude Code; в Cursor можно не указывать.
- Алгоритм «откуда брать параметры» у нас проще: projectPath = корень проекта 1С (workspace или указанный пользователем).
Ссылка на cc-1c-skills
В основном навыке 1c-platform-tools упоминается cc-1c-skills как дополнение для редактирования XML и объектов метаданных (epf-build, cf-edit и др.). Навыки расширения отвечают за «что запустить» (load/dump/run); cc-1c-skills — за «как править и генерировать».
Эволюция: .cursor/rules/evolution-no-legacy.mdc — не плодить legacy без явного запроса.
