1c-rules: правила и скиллы для разработки на 1С

Установка

claude plugin marketplace add comol/ai_rules_1c
claude plugin install 1c-rules@1c-rules

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

1c-rules раскладывает в проект 1С единый свод правил AGENTS.md, on-demand инструкции по BSL, формам, СКД, регистрам и запросам, 13 специализированных субагентов и слэш-команды. Главный скилл 1c-metadata-manage меняет метаданные конфигурации через набор типизированных операций с валидацией, а не ручной правкой XML. Правила рассчитаны на пакет MCP-серверов 1С: граф метаданных, поиск по коду, проверку синтаксиса BSL, справку платформы, БСП и шаблоны. Установщик сам определяет активные агенты и адаптирует файлы под каждый.

Для кого. Разработчикам 1С, которые пишут код и дорабатывают конфигурации с помощью ИИ-агентов.

Пример запроса к агенту

Добавь в документ РеализацияТоваров реквизит Менеджер с типом СправочникСсылка.Пользователи и выведи его на форму документа

Ограничения

Основной установщик и большинство инструментов написаны на PowerShell, Python-версии есть только у пяти команд. Полная функциональность требует пакета MCP-серверов с vibecoding1c.ru, запускаемых в Docker. Сервер 1c-code-check-mcp использует коммерческий сервис 1С:Напарник.

Как отключить. Выполните install.ps1 remove для нужного инструмента или install.ps1 eject, в Claude Code удалите плагин 1c-rules через /plugin.

Проверка безопасности

• Установщик и скиллы запускают PowerShell и Python-скрипты
• Инструменты меняют метаданные конфигурации и работают с информационными базами
• Может подключать MCP-серверы и внешние сервисы, включая 1С:Напарник и Gemini API для транскрибации

Коротко о README

1c-rules это переносимый набор правил, ролей субагентов, on-demand инструкций и интеграций для разработки на 1С:Предприятие 8 с ИИ-агентами. Подключается через marketplace плагинов Cursor, Claude Code, Codex и OpenCode, самим агентом по AGENT-INSTALL.md или PowerShell-скриптом install.ps1. README подробно описывает каталог правил, субагентов, скиллов и MCP-серверов экосистемы 1С. Также разворачивается OpenSpec-воркспейс для работы по спецификациям.

SKILL.md

---
name: 1c-metadata-manage
description: "1C metadata management — create, edit, validate, and remove configuration objects (catalogs, documents, registers, enums), managed forms, data composition schemas (SKD), spreadsheet layouts (MXL), roles, external processors (EPF/ERF), extensions (CFE), configurations (CF), databases, subsystems, command interfaces, templates. Use when working with 1C metadata structure."
---

# 1C Metadata Manage — Skill Dispatch

Use this skill when the task involves **1C metadata structure** (creating, editing, validating, or removing configuration objects, forms, reports, layouts, roles, extensions, or databases).

## Hard rule

- **Unambiguous one-line fix** of an existing value that cannot break structure — a synonym / comment typo, a boolean flag flip on an existing element. Anything that adds / removes / reorders elements, touches UUIDs, or spans more than one line of XML is not "one-line".
- **Skill not available in the session** (files not installed / not exposed) — state it once in one line, then hand-edit with `metadata-xml-workarounds.md` loaded and validate per `verification-gates.md`.
- **Read-only analysis** of metadata XML is not a mutation — reading files directly is fine (subject to `mcp-first-search.md` for locating them).

## Vendor support gate

Every mutating tool refuses to edit a locked ("на замке") object of a typical configuration on vendor support and refuses to delete one still on support — the run exits `1`, the refusal is the correct outcome (extension first, `support-edit` only as a stated decision): [support-manage.md](docs/support-manage.md).

## Path conventions

PowerShell examples in this skill (`SKILL.md` and every `docs/*.md`) use the prefix `skills/1c-metadata-manage/tools/...`. That prefix is **relative to the active tool's skills directory**, not to the repository root:

- After installation: the script lives under `<tool>/skills/1c-metadata-manage/tools/...` (e.g. `.cursor/skills/1c-metadata-manage/tools/...`, `.claude/skills/1c-metadata-manage/tools/...`, `.kilo/skills/1c-metadata-manage/tools/...`, `.ai-agent/skills/1c-metadata-manage/tools/...`). Active tools that load this skill resolve the prefix automatically.
- In the `1c-rules` source repository (when editing the skill itself): the same script lives under `content/skills/1c-metadata-manage/tools/...`. Prepend `content/` when running the example outside of an installed project.

Похожие