Nikolay-Shirokov/cc-1c-skills

이 프로젝트는 활발하게 개발되고 있는 라이브 프로젝트입니다. 새로운 기능이 추가되고, 버그를 포착 및 수정하며, 최적화가 진행되고 있습니다. 업데이트를 계속 확인해 주세요.

AI 에이전트(특히 Claude Code를 위한)를 위한 스킬 세트로, 구성(Configuration), 확장(Extension), 외부 처리(External Processing) 및 보고서(Report) 생성부터 정보 베이스(Information Base)로의 변경 사항 로드, 업데이트, 실행, 웹 서버(Apache 포터블 버전) 게시, 웹 클라이언트(Web Client)를 통한 테스트 및 비디오 가이드 녹화에 이르기까지 1C:Enterprise 8.3 플랫폼의 전체 개발 주기를 다룰 수 있도록 지원합니다.

이 스킬들은 모델에게 XML 형식과 컨피규레이터(Configurator) CLI에 대한 준비된 추상화(Abstraction)를 제공하여, 구현 세부 사항이 아닌 작업의 본질에 집중할 수 있게 합니다. 또한 웹 테스트(Web Testing) 기능은 모델이 1C 인터페이스와 상호작용할 수 있는 눈과 손을 제공합니다.

PS— PowerShell 스크립트 버전(Windows용 표준 버전). Py— Python 스크립트 버전(PowerShell이 적합하지 않은 경우). PS가 기본 옵션이므로 PS부터 시작하는 것을 권장합니다.

Claude Code PS · Py — Cursor PS · Py — Codex PS · Py — 기타 플랫폼 →

이 리포지토리의 .claude/skills/ 디렉토리를 프로젝트의 루트(Root)로 복사하세요. 해당 디렉토리에서 Claude Code를 실행할 때 스킬을 사용할 수 있습니다.

MyProject/
├── .claude/skills/ ← 여기에 복사
└── ...

또는 Claude Code 플러그인으로 설치하세요:

/plugin marketplace add https://github.com/Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills # PowerShell (Windows)
/plugin install 1c-skills-py@cc-1c-skills # Python (Linux/Mac 또는 PS를 사용할 수 없는 경우)

또는 OpenAI Codex 플러그인으로 설치하세요:

codex plugin marketplace add Nikolay-Shirokov/cc-1c-skills
codex /plugins # 1c-skills (PowerShell) 또는 1c-skills-py (Python)를 선택하고 Install을 누르세요

또는 설치 스크립트를 사용하세요:

git clone https://github.com/Nikolay-Shirokov/cc-1c-skills.git tools/cc-1c-skills
# 복사본 (권장): 독립적인 복사본이며, 업데이트 시 재실행하세요
python tools/cc-1c-skills/scripts/switch.py claude-code --project-dir .
...

명령어와 파라미터를 반드시 외울 필요는 없습니다. 그저 자신의 언어로 작업을 설명하기만 하면, Claude가 알아서 필요한 기술(Skills)을 선택할 것입니다. 정밀한 제어를 위해 슬래시 명령어(Slash commands, 예: /epf-init МояОбработка)를 사용할 수도 있습니다.

그룹	기술 (Skills)	설명	가이드
외부 처리 (EPF)	7개 기술 `/epf-*`	XML 소스에서 처리(Processing) 생성, 빌드, 분해, 검증	[상세 보기]
외부 보고서 (ERF)	4개 기술 `/erf-*`	외부 보고서(External Reports) 생성, 빌드, 분해, 검증	[상세 보기]
범용 작업	`/template-add`, `/template-remove`, `/help-add`, `/form-remove`	모든 객체에 대한 템플릿(Templates), 폼(Forms), 도움말(Help) 추가/삭제	[상세 보기]
테이블 문서 (MXL)	4개 기술 `/mxl-*`	인쇄 양식 템플릿 분석, 생성, 컴파일	[상세 보기]
관리형 폼 (Form)	6개 기술 `/form-*`	관리형 폼(Managed Forms) 생성, 분석, 생성, 수정, 검증	[상세 보기]
역할 (Role)	3개 기술 `/role-*`	역할 권한 분석, JSON DSL을 통한 생성, 검증	[상세 보기]
데이터 컴포넌트 스키마 (СКД)	4개 기술 `/skd-*`	데이터 컴포넌트 스키마(Data Composition Schemas) 분석, JSON DSL로부터 생성, 정밀 편집, 검증	[상세 보기]
구성 메타데이터	5개 기술 `/meta-*`	메타데이터 객체(23개 유형) 생성, 분석, 편집, 삭제, 검증	[상세 보기]
루트 구성 (Root Configuration)	4개 기술 `/cf-*`	루트 구성 파일(Root Configuration Files) 생성, 분석, 편집, 검증	[상세 보기]
확장 (CFE)	5개 기술 `/cfe-*`	확장(Extensions) 생성, 가져오기, 메서드 가로채기(Intercept), 검증, 분석	[상세 보기]
서브시스템 (Subsystem)	4개 기술 `/subsystem-*`	구성 서브시스템(Configuration Subsystems) 분석, 생성, 편집, 검증	[상세 보기]
커맨드 인터페이스 (CI)	2개 기술 `/interface-*`	서브시스템의 CommandInterface.xml 편집 및 검증	[상세 보기]
데이터베이스 (DB)	9개 기술 `/db-*`	데이터베이스 생성, 구성 내보내기/가져오기, DB 업데이트, Git에서 로드	[상세 보기]

Windows PowerShell 5.1+ (Windows 포함) — 기본 런타임 (Runtime)
1C:Enterprise 8.3 — EPF/ERF 빌드/언팩용 (XML 생성 기술은 플랫폼 없이 작동)
Node.js 18+ — /web-test용

(브라우저를 통한 테스트)

기술은 개방형 표준인 Agent Skills를 기반으로 구축되었으며, 이 형식을 지원하는 모든 플랫폼과 호환됩니다. 가장 빠른 방법은 아래 브랜치에서 필요한 플랫폼에 맞는 완성된 빌드를 다운로드(Code → Download ZIP)하여 프로젝트 루트에 압축을 푸는 것입니다.

플랫폼	대상 디렉토리	PowerShell	Python
Claude Code	`.claude/skills/`	main	port-claude-code-py
Cursor	`.cursor/skills/`	port-cursor	port-cursor-py
OpenAI Codex	`.codex/skills/`	port-codex	port-codex-py
GitHub Copilot	`.github/skills/`	port-copilot	port-copilot-py
Augment	`.augment/skills/`	port-augment	port-augment-py
Cline	`.cline/skills/`	port-cline	port-cline-py
Kilo Code	`.kilocode/skills/`	port-kilo	port-kilo-py
Kiro	`.kiro/skills/`	port-kiro	port-kiro-py
Gemini CLI	`.gemini/skills/`	port-gemini	port-gemini-py
OpenCode	`.opencode/skills/`	port-opencode	port-opencode-py
Roo Code	`.roo/skills/`	port-roo	port-roo-py
Windsurf	`.windsurf/skills/`	port-windsurf	port-windsurf-py
Agent Skills	`.agents/skills/`	port-agents	port-agents-py

완성된 port-* 브랜치는
스킬에 변경 사항이 있을 때마다 자동으로 재빌드됩니다. 지금 바로 최신 빌드가 필요하면 switch.py를 통해 로컬에서 빌드하세요.

일부 플랫폼(Augment, Cline, VS Code/Copilot)은 폴백(fallback)으로 .claude/skills/도 스캔합니다. 이 경우 main 브랜치만 있으면 충분합니다.

자신의 플랫폼에 맞는 최신 빌드가 필요하거나 (또는 해당 플랫폼이 아직 port-브랜치 매트릭스에 없는 경우):

python scripts/switch.py # 대화형 모드
python scripts/switch.py cursor # Cursor용 스킬 복사
python scripts/switch.py cursor --runtime python # Cursor + Python 런타임
...

만약 리포지토리가 프로젝트 내부(예: tools/cc-1c-skills에) 클론된 경우, 대상 프로젝트에 스킬을 설치하려면 --project-dir 플래그를 사용하세요.

링크 vs 복사. --link 플래그 (실험적)는 파일 복사 대신 디렉토리 접합(directory junction, Windows) 또는 심볼릭 링크(symlink, Linux/Mac)를 생성합니다. 소스에서 업데이트가 발생하면 연결된 모든 프로젝트에 자동으로 반영되므로 git pull만 하면 됩니다.

링크는 Claude Code 플랫폼에서만 사용할 수 있습니다 (다른 플랫폼의 경우 SKILL.md에서 경로를 다시 작성해야 합니다). 링크 삭제: --undo — 소스는 건드리지 않고 링크만 안전하게 삭제합니다.

⚠ 알려진 제한 사항
Node.js는 --link를 통해 __dirname을 프로젝트 디렉토리가 아닌 실제 소스 경로로의 정션 (junction)을 통해 해석합니다. 이로 인해 Node.js 스크립트를 사용하는 스킬(예: /web-test)이 프로젝트 디렉토리가 아닌 스킬 리포지토리 디렉토리에 파일을 기록할 수 있습니다. 문제가 발생하면 복사 방식( --link 없이 사용)으로 전환하십시오.

자동 활성화는 기본 모드입니다. 단순히 자신의 언어로 작업을 설명하면, 어시스턴트가 SKILL.md의 description을 바탕으로 적절한 스킬을 자동으로 선택합니다. 슬래시 명령어(예: /epf-init)는 특정 스킬을 호출해야 할 때 정밀한 제어를 위해 사용됩니다.

Windows에서는 PS1 런타임 (기본값)을 권장합니다. Python 포트는 Linux/Mac용이거나 PowerShell을 사용할 수 없는 경우에 사용합니다. PS1 스크립트는 마스터 버전이며, Python 포트는 파생 버전입니다 (Python Porting Guide 참조).

python scripts/switch.py --runtime python # Python으로 전환
python scripts/switch.py --runtime powershell # PowerShell로 복구

Python 런타임의 추가 의존성:

lxml>=4.9.0 — DOM과 작동하는 스킬용 (edit/validate/info)
psutil>=5.9.0 — 웹 스킬용 (Apache 관리)

스크립트 파라미터는 두 런타임 모두 동일합니다. 전환 시 호출되는 인터프리터만 변경됩니다. 자세한 내용은 Python Porting Guide를 참조하십시오.

44가지 모든 객체 유형에 대한 목차가 포함된 전체 인덱스: 스펙 요약 인덱스 (Summary Index of Specifications)

처리(Processing) XML 내보내기 형식 — XML 파일 구조, 네임스페이스 (namespace), 폼 요소
외부 보고서 XML 형식 — ERF와 EPF의 차이점, Properties, MainDataCompositionSchema
관리형 폼 (Managed Form) — Form.xml, 요소, 명령, 속성
내장 도움말 — Help.xml, HTML 페이지, 폼의 도움말 버튼
1C Configurator 배치 모드 — 명령 1cv8.exe

, DESIGNER, ENTERPRISE, CREATEINFOBASE - SpreadsheetDocument (MXL) — SpreadsheetDocument의 XML 형식, 버전 호환성

MXL DSL — /mxl-compile 및 /mxl-decompile을 위한 레이아웃 기술 JSON 형식
Form DSL — /form-compile을 위한 폼 기술 JSON 형식
Roles (Rights.xml) — 역할(Role) 권한의 XML 형식, 객체 유형, RLS (Row-Level Security)
Role DSL — /role-compile을 위한 역할 기술 JSON 형식
Data Composition Schema (DCS) — DataCompositionSchema의 XML 형식, 930개의 스키마 분석 완료
SKD DSL — /skd-compile을 위한 SKD 기술 JSON 형식
Configuration Objects — 구성 메타데이터 객체의 XML 형식 (23개 유형)
Subsystems and Command Interface — 서브시스템의 XML 형식, CommandInterface.xml, 가시성/배치/순서 섹션
Root Configuration — Configuration.xml, ConfigDumpInfo.xml, Languages/의 XML 형식, 44개 유형의 ChildObjects
Configuration Extensions (CFE) — 구성 확장(Extension) 추출의 XML 형식
1C Web Publication — VRD, httpd.conf, wsap24.dll, portable Apache

.claude/skills/ # Claude Code 스킬
├── epf-init/ # 처리(Processing) 생성
├── epf-build/ # EPF 빌드
...

Nikolay-Shirokov/cc-1c-skills

요약

핵심 포인트

댓글