Nikolay-Shirokov/cc-1c-skills

Набор навыков для AI(ИИ)-агентов (Claude Code, Cursor, Codex и др.), помогающий охватить полный цикл разработки на платформе 1С:Предприятие 8.3. Даёт модели абстракции над XML-форматами и CLI конфигуратора, а также глаза и руки для тестирования через веб-клиент. AI skills for 1C:Enterprise 8.3.

1C Skills for Claude Code(및 기타 AI 에이전트)

이것이 무엇인가 – 대규모 언어 모델 어시스턴트(Claude Code, Cursor, OpenAI Codex 등)가 러시아의 1C:Enterprise 8.3 개발 플랫폼과 함께 작업할 수 있게 해주는 Agent Skills 모음입니다. 스킬은 전체 1C 개발 수명 주기에 대한 고급 명령을 제공합니다. 외부 프로세서/보고서 생성 및 컴파일, 메타데이터 편집, 데이터베이스 관리, 휴대용 Apache 웹 서버에 게시, UI 테스트 및 비디오 녹화 튜토리얼을 위한 1C 웹 클라이언트 구동까지 포함합니다.

왜 중요한가 – 이러한 스킬이 없으면 LLM은 원시 XML 파일과 1C 명령줄 구성기를 직접 조작해야 하며, 이는 오류가 발생하기 쉽고 깊은 도메인 지식이 필요합니다. 스킬 세트는 모델에게 의미론적 작업(예: /epf-init MyProcessing)을 제공하며, 내부적으로 적절한 CLI 호출, XML 편집 또는 브라우저 작업으로 변환됩니다.

주요 기능(스킬 카테고리별)

카테고리	주요 기능
외부 프로세서(EPF)	외부 프로세서 생성, 빌드, 압축 해제, 검증.
외부 보고서(ERF)	보고서에 대한 동일한 작업 세트.
템플릿 / 도움말	모든 객체에 대한 레이아웃 파일, 도움말 리소스 추가/제거.
스프레드시트(MXL)	JSON DSL에서 분석, 컴파일, 역컴파일, 인쇄 가능한 양식 레이아웃 검증.
관리 양식	양식 생성, 분석, JSON DSL에서 컴파일, 편집, 검증.
역할	역할 권한 검사, JSON DSL에서 생성, 편집, 검증.
데이터 구성 스키마(SKD)	분석, JSON DSL에서 생성, 포인트 편집, 검증.
메타데이터 객체	23가지 다양한 메타데이터 유형 생성, 읽기, 편집, 삭제, 검증.
루트 구성 파일	핵심 구성 XML 파일 생성, 편집, 검증.
확장(CFE)	확장 생성, 객체 차용, 메서드 패치, diff, 검증.
하위 시스템 및 명령 인터페이스	하위 시스템 정의 및 `CommandInterface.xml` 분석, 생성, 편집, 검증.
XDTO 패키지	XSD에서 분석, 생성, 내보내기, 편집, 검증.
데이터베이스 관리	DB 생성, 구성 덤프/로드(CF, XML, DT), 업데이트 실행, Git에서 변경 사항 로드, 구성 저장소 관리, DB 내 확장 관리.
웹 게시	휴대용 Apache에 1C DB 게시, 상태 확인, 중지, 게시 취소.
웹 테스트	Node.js를 통해 1C 웹 클라이언트 구동(탐색, 양식 작성, 보고서 실행), 자막 및 TTS가 포함된 비디오 튜토리얼 녹화, 회귀 테스트 스위트 실행.
유틸리티	레이아웃 분석용 이미지 그리드 오버레이, 플랫폼 XSD 스키마 가져오기.

설치 / 빠른 시작

스킬 폴더를 프로젝트에 복사합니다:

MyProject/
└── .claude/skills/   ← 저장소에서 복사

또는 플러그인으로 설치(Claude Code, Cursor, Codex 등) README에 표시된 플랫폼의 마켓플레이스 명령을 사용합니다.
또는 헬퍼 스크립트 scripts/switch.py를 사용하여:
- 대상 AI 플랫폼 선택(Claude Code, Cursor, Codex 등),
- 런타임 선택(PowerShell – Windows 기본값, Linux/macOS용 Python),
- 스킬을 복사하거나 실시간 업데이트를 위한 심볼릭 링크 기반 링크를 생성합니다.

일반적인 명령:

python tools/cc-1c-skills/scripts/switch.py claude-code --project-dir .

그 후 자연어로 원하는 것을 설명하거나(또는 /epf-init MyProc 같은 슬래시 명령 사용) 어시스턴트가 적절한 스킬을 호출합니다.

런타임 옵션

런타임	사용 시기
PowerShell(기본값)	PowerShell 5.1+를 사용할 수 있는 Windows 머신.
Python	Linux/macOS 또는 PowerShell을 사용할 수 없는 Windows. `pip install -r requirements.txt`로 종속성을 설치합니다(lxml, Pillow, psutil).

switch.py 스크립트로 전환할 수 있습니다:

python scripts/switch.py --runtime python   # Python 사용
python scripts/switch.py --runtime powershell   # PowerShell로 복귀

시스템 요구 사항

OS – Windows(PowerShell) 또는 Python 3.9+를 지원하는 모든 OS.
1C:Enterprise 8.3 – EPF/ERF 빌드/패키징에 필요. 많은 스킬은 플랫폼 없이 XML 수준에서 작동합니다.
Node.js 18+ – 브라우저를 구동하는 /web-test 스킬에 필요.

지원되는 AI 플랫폼(모두 개방형 Agent Skills 사양 사용)

플랫폼	스킬 디렉토리	런타임 옵션
Claude Code	`.claude/skills/`	PowerShell(기본) / Python(port-claude-code-py)
Cursor	`.cursor/skills/`	PowerShell / Python
OpenAI Codex	`.codex/skills/`	PowerShell / Python
GitHub Copilot	`.github/skills/`	PowerShell / Python
…(Augment, Cline, Kilo Code, Gemini CLI 등)	전용 브랜치	PowerShell / Python

핵심 스킬 세트가 변경되면 각 브랜치는 자동으로 다시 빌드되므로 플랫폼용 기성 ZIP을 가져오거나 switch.py를 사용하여 로컬에서 새 복사본을 생성할 수 있습니다.

문서 및 사양 참조

저장소에는 각 스킬 그룹에 대한 광범위한 Markdown 가이드(docs/*.md)와 스킬이 작동하는 XML 및 JSON DSL 형식(예: EPF XML 스키마, 양식 DSL, 역할 DSL, SKD DSL 등)을 자세히 설명하는 사양 인덱스(docs/1c-specs-index.md)가 포함되어 있습니다.

TL;DR

무엇 – LLM 기반 어시스턴트가 1C Enterprise 개발을 완전히 관리할 수 있게 해주는 44개 이상의 에이전트 스킬 도구 모음.
누구 – AI로 반복 작업을 자동화하려는 1C 개발자, 또는 전문 1C 기능을 추가하려는 AI 플랫폼 사용자.
방법 – 스킬 폴더(또는 플러그인)를 설치하고 런타임(PowerShell 또는 Python)을 선택한 다음 자연어 요청 또는 슬래시 명령을 실행합니다. 어시스턴트가 적절한 CLI를 실행하고, XML을 편집하고, 웹 UI를 구동합니다.
이유 – 저수준 XML 및 명령줄의 복잡성을 추상화하여 전체 1C 수명 주기를 고급 AI 기반 작업으로 전환합니다.