1c-naparnik

Name: 1c-naparnik
Author: Desko77

40stars7forks

How to install 1c-naparnik?

desko77/cursor-1c-skills/1c-naparnik

$npx -y skills add Desko77/cursor-1c-skills --skill 1c-naparnik

Installs into the current project.

Summary

1C:Naparnik (1С:Напарник) MCP server tools - BSL code analysis, review, rewriting, ITS knowledge base, platform documentation search, configuration documentation. Use when checking BSL code quality, searching ITS standards, reading platform docs, comparing versions, or finding co

Files · 1

View on GitHub

SKILL.md

1	# 1С:Напарник - MCP Tools Reference
2
3	MCP-сервер 1c-naparnik - интеграция с API 1С:Напарник (code.1c.ai). 12 инструментов: 6 для анализа/модификации BSL-кода, 6 для поиска по документации и базе знаний ИТС.
4
5	## When to Use
6
7	Используй инструменты 1c-naparnik когда:
8	- Нужно проверить качество BSL-кода (стиль, архитектура, стандарты)
9	- Нужно проверить код на синтаксические ошибки, логические проблемы, антипаттерны производительности
10	- Нужно получить code review по стандартам ИТС
11	- Нужно переписать или модифицировать BSL-код с улучшениями
12	- Нужно объяснение конкретной конструкции языка BSL
13	- Нужно найти методологическую статью или стандарт на ИТС
14	- Нужно прочитать конкретный документ ИТС по ID
15	- Нужно найти информацию в документации платформы (встроенные функции, типы, события)
16	- Нужно сравнить изменения между версиями платформы
17	- Нужно найти информацию по конкретной конфигурации (ERP, ЗУП, Бухгалтерия)
18
19	## Prerequisites Check
20
21	Сервер работает через Docker-контейнер на порту 8007. Если инструменты не отвечают - сообщи пользователю:
22	> MCP-сервер 1c-naparnik недоступен. Запустите Docker-контейнер:
23	> ```
24	> cd <путь к 1c-code-checker> && docker compose up -d
25	> ```
26
27	---
28
29	## Tools by Category
30
31	### Анализ и модификация кода (6 инструментов)
32
33	#### `ask_1c_ai` - Свободный вопрос к ИИ
34
35	Основной инструмент для любых вопросов по 1С. Поддерживает контекст диалога (сессии).
36
37	\| Параметр \| Обязательный \| Описание \|
38	\|---\|:---:\|---\|
39	\| `question` \| да \| Вопрос (код, задача, архитектурный вопрос) \|
40	\| `create_new_session` \| нет \| `true` - новая сессия (сброс контекста), `false` - продолжение (default) \|
41
42	Когда использовать:
43	- ОБЯЗАТЕЛЬНО после каждого написания/изменения BSL-кода - быстрая проверка качества
44	- Общие вопросы по архитектуре, паттернам, подходам 1С
45	- Вопросы, не подходящие под специализированные инструменты
46	- Когда нужен контекст предыдущего диалога (серия связанных вопросов)
47
48	#### `check_1c_code` - Техническая проверка кода
49
50	Проверка синтаксиса, логических ошибок, антипаттернов производительности (запросы в цикле, N+1, обращение через точку).
51
52	\| Параметр \| Обязательный \| Описание \|
53	\|---\|:---:\|---\|
54	\| `code` \| да \| BSL-код для проверки \|
55	\| `check_type` \| нет \| Тип проверки (по умолчанию - полная) \|
56
57	Когда использовать:
58	- Проверка: скомпилируется ли код, есть ли баги
59	- Поиск антипаттернов производительности
60	- Альтернатива `check_syntax` (1c-syntax-checker-mcp) с расширенным анализом логики
61
62	#### `review_1c_code` - Code review стиля и стандартов
63
64	Ревью по стандартам ИТС: именование, структура, читаемость, соответствие стандартам. НЕ проверяет синтаксис.
65
66	\| Параметр \| Обязательный \| Описание \|
67	\|---\|:---:\|---\|
68	\| `code` \| да \| BSL-код для ревью \|
69
70	Когда использовать:
71	- Проверка соответствия стандартам ИТС (именование переменных, структура модуля)
72	- Оценка читаемости и поддерживаемости кода
73	- Перед коммитом - финальное ревью стиля
74
75	#### `rewrite_1c_code` - Улучшение кода (ИИ решает что улучшить)
76
77	ИИ анализирует код и предлагает свою улучшенную версию. В отличие от `modify_1c_code`, здесь ИИ сам решает, что и как улучшить.
78
79	\| Параметр \| Обязательный \| Описание \|
80	\|---\|:---:\|---\|
81	\| `code` \| да \| BSL-код для улучшения \|
82	\| `goal` \| нет \| Направление улучшения (например: "производительность", "читаемость") \|
83
84	Когда использовать:
85	- Рефакторинг: хочешь увидеть, как ИИ переписал бы код
86	- Нужна альтернативная реализация для сравнения
87	- Оптимизация кода без конкретной инструкции
88
89	#### `modify_1c_code` - Модификация по инструкции
90
91	Изменение кода по точной инструкции пользователя. В отличие от `rewrite_1c_code`, здесь ИИ следует конкретному указанию.
92
93	\| Параметр \| Обязательный \| Описание \|
94	\|---\|:---:\|---\|
95	\| `instruction` \| да \| Что именно изменить (например: "добавить обработку пустого результата запроса") \|
96	\| `code` \| нет \| BSL-код для модификации (если не указан - генерирует с нуля) \|
97
98	Когда использовать:
99	- Точечное исправление бага ("исправить обработку NULL")
100	- Добавление конкретной функциональности
101	- Рефакторинг с конкретным направлением ("вынести в отдельную функцию")
102
103	#### `explain_1c_syntax` - Объяснение синтаксиса
104
105	Объяснение конкретного ключевого слова, оператора, конструкции или встроенной функции BSL.
106
107	\| Параметр \| Обязательный \| Описание \|
108	\|---\|:---:\|---\|
109	\| `syntax_element` \| да \| Элемент синтаксиса (например: `ДобавитьОбработчикОповещения`, `Запрос.УстановитьПараметр`) \|
110	\| `context` \| нет \| Контекст для более точного объяснения \|
111
112	Когда использовать:
113	- Незнакомая конструкция BSL
114	- Нужно точное объяснение конкретного ключевого слова/оператора
115	- Для широких вопросов лучше `ask_1c_ai`
116
117	---
118
119	### Документация и база знаний (6 инструментов)
120
121	#### `its_help` - Поиск по ИТС

People who liked this also viewed

6 picks

Type

1c-naparnik

40stars7forks

View on GitHub

How to install 1c-naparnik?

desko77/cursor-1c-skills/1c-naparnik

$npx -y skills add Desko77/cursor-1c-skills --skill 1c-naparnik

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# 1С:Напарник - MCP Tools Reference
2
3	MCP-сервер 1c-naparnik - интеграция с API 1С:Напарник (code.1c.ai). 12 инструментов: 6 для анализа/модификации BSL-кода, 6 для поиска по документации и базе знаний ИТС.
4
5	## When to Use
6
7	Используй инструменты 1c-naparnik когда:
8	- Нужно проверить качество BSL-кода (стиль, архитектура, стандарты)
9	- Нужно проверить код на синтаксические ошибки, логические проблемы, антипаттерны производительности
10	- Нужно получить code review по стандартам ИТС
11	- Нужно переписать или модифицировать BSL-код с улучшениями
12	- Нужно объяснение конкретной конструкции языка BSL
13	- Нужно найти методологическую статью или стандарт на ИТС
14	- Нужно прочитать конкретный документ ИТС по ID
15	- Нужно найти информацию в документации платформы (встроенные функции, типы, события)
16	- Нужно сравнить изменения между версиями платформы
17	- Нужно найти информацию по конкретной конфигурации (ERP, ЗУП, Бухгалтерия)
18
19	## Prerequisites Check
20
21	Сервер работает через Docker-контейнер на порту 8007. Если инструменты не отвечают - сообщи пользователю:
22	> MCP-сервер 1c-naparnik недоступен. Запустите Docker-контейнер:
23	> ```
24	> cd <путь к 1c-code-checker> && docker compose up -d
25	> ```
26
27	---
28
29	## Tools by Category
30
31	### Анализ и модификация кода (6 инструментов)
32
33	#### `ask_1c_ai` - Свободный вопрос к ИИ
34
35	Основной инструмент для любых вопросов по 1С. Поддерживает контекст диалога (сессии).
36
37	\| Параметр \| Обязательный \| Описание \|
38	\|---\|:---:\|---\|
39	\| `question` \| да \| Вопрос (код, задача, архитектурный вопрос) \|
40	\| `create_new_session` \| нет \| `true` - новая сессия (сброс контекста), `false` - продолжение (default) \|
41
42	Когда использовать:
43	- ОБЯЗАТЕЛЬНО после каждого написания/изменения BSL-кода - быстрая проверка качества
44	- Общие вопросы по архитектуре, паттернам, подходам 1С
45	- Вопросы, не подходящие под специализированные инструменты
46	- Когда нужен контекст предыдущего диалога (серия связанных вопросов)
47
48	#### `check_1c_code` - Техническая проверка кода
49
50	Проверка синтаксиса, логических ошибок, антипаттернов производительности (запросы в цикле, N+1, обращение через точку).
51
52	\| Параметр \| Обязательный \| Описание \|
53	\|---\|:---:\|---\|
54	\| `code` \| да \| BSL-код для проверки \|
55	\| `check_type` \| нет \| Тип проверки (по умолчанию - полная) \|
56
57	Когда использовать:
58	- Проверка: скомпилируется ли код, есть ли баги
59	- Поиск антипаттернов производительности
60	- Альтернатива `check_syntax` (1c-syntax-checker-mcp) с расширенным анализом логики
61
62	#### `review_1c_code` - Code review стиля и стандартов
63
64	Ревью по стандартам ИТС: именование, структура, читаемость, соответствие стандартам. НЕ проверяет синтаксис.
65
66	\| Параметр \| Обязательный \| Описание \|
67	\|---\|:---:\|---\|
68	\| `code` \| да \| BSL-код для ревью \|
69
70	Когда использовать:
71	- Проверка соответствия стандартам ИТС (именование переменных, структура модуля)
72	- Оценка читаемости и поддерживаемости кода
73	- Перед коммитом - финальное ревью стиля
74
75	#### `rewrite_1c_code` - Улучшение кода (ИИ решает что улучшить)
76
77	ИИ анализирует код и предлагает свою улучшенную версию. В отличие от `modify_1c_code`, здесь ИИ сам решает, что и как улучшить.
78
79	\| Параметр \| Обязательный \| Описание \|
80	\|---\|:---:\|---\|
81	\| `code` \| да \| BSL-код для улучшения \|
82	\| `goal` \| нет \| Направление улучшения (например: "производительность", "читаемость") \|
83
84	Когда использовать:
85	- Рефакторинг: хочешь увидеть, как ИИ переписал бы код
86	- Нужна альтернативная реализация для сравнения
87	- Оптимизация кода без конкретной инструкции
88
89	#### `modify_1c_code` - Модификация по инструкции
90
91	Изменение кода по точной инструкции пользователя. В отличие от `rewrite_1c_code`, здесь ИИ следует конкретному указанию.
92
93	\| Параметр \| Обязательный \| Описание \|
94	\|---\|:---:\|---\|
95	\| `instruction` \| да \| Что именно изменить (например: "добавить обработку пустого результата запроса") \|
96	\| `code` \| нет \| BSL-код для модификации (если не указан - генерирует с нуля) \|
97
98	Когда использовать:
99	- Точечное исправление бага ("исправить обработку NULL")
100	- Добавление конкретной функциональности
101	- Рефакторинг с конкретным направлением ("вынести в отдельную функцию")
102
103	#### `explain_1c_syntax` - Объяснение синтаксиса
104
105	Объяснение конкретного ключевого слова, оператора, конструкции или встроенной функции BSL.
106
107	\| Параметр \| Обязательный \| Описание \|
108	\|---\|:---:\|---\|
109	\| `syntax_element` \| да \| Элемент синтаксиса (например: `ДобавитьОбработчикОповещения`, `Запрос.УстановитьПараметр`) \|
110	\| `context` \| нет \| Контекст для более точного объяснения \|
111
112	Когда использовать:
113	- Незнакомая конструкция BSL
114	- Нужно точное объяснение конкретного ключевого слова/оператора
115	- Для широких вопросов лучше `ask_1c_ai`
116
117	---
118
119	### Документация и база знаний (6 инструментов)
120
121	#### `its_help` - Поиск по ИТС

People who liked this also viewed

6 picks

Type