Nikolay-Shirokov/cc-1c-skills

1C Skills for Claude Code（及其他 AI 代理）

这是什么 – 一组 Agent Skills，让大型语言模型助手（Claude Code、Cursor、OpenAI Codex 等）能够与俄罗斯的 1C:Enterprise 8.3 开发平台协同工作。这些技能提供了覆盖整个 1C 开发生命周期的高级命令——创建和编译外部处理器/报表、编辑元数据、管理数据库、发布到便携式 Apache Web 服务器，甚至驱动 1C Web 客户端进行 UI 测试和视频录制教程。

为什么重要 – 没有这些技能，LLM 将不得不直接操作原始 XML 文件和 1C 命令行配置器，这容易出错且需要深厚的领域知识。该技能集为模型提供了 语义 操作（例如 /epf-init MyProcessing），这些操作在内部转换为适当的 CLI 调用、XML 编辑或浏览器操作。

---

主要功能（按技能类别分组）

类别	主要能力
外部处理（EPF）	创建、构建、解包、验证外部处理器。
外部报表（ERF）	对报表执行相同的操作集。
模板 / 帮助	为任何对象添加/删除布局文件、帮助资源。
电子表格（MXL）	分析、从 JSON DSL 编译、反编译、验证可打印表单布局。
托管表单	创建、分析、从 JSON DSL 编译、编辑、验证表单。
角色	检查角色权限、从 JSON DSL 生成、编辑、验证。
数据组合模式（SKD）	分析、从 JSON DSL 生成、点编辑、验证。
元数据对象	创建、读取、编辑、删除、验证 23 种不同的元数据类型。
根配置文件	创建、编辑、验证核心配置 XML 文件。
扩展（CFE）	创建扩展、借用对象、修补方法、差异比较、验证。
子系统与命令界面	分析、创建、编辑、验证子系统定义和 CommandInterface.xml。
XDTO 包	分析、从 XSD 生成、导出、编辑、验证。
数据库管理	创建数据库、转储/加载配置（CF、XML、DT）、运行更新、从 Git 加载更改、管理配置存储库、管理数据库中的扩展。
Web 发布	在便携式 Apache 上发布 1C 数据库、检查状态、停止、取消发布。
Web 测试	通过 Node.js 驱动 1C Web 客户端（导航、填写表单、运行报表）、录制带字幕和 TTS 的视频教程、运行回归测试套件。
实用工具	用于布局分析的图像网格叠加、获取平台 XSD 模式。

---

安装 / 快速开始

1. 将技能文件夹复制到您的项目中：

   MyProject/
   └── .claude/skills/   ← 从仓库复制
   

2. 或作为插件安装（Claude Code、Cursor、Codex 等），使用 README 中显示的平台市场命令。
3. 或使用辅助脚本 scripts/switch.py 来：
   • 选择目标 AI 平台（Claude Code、Cursor、Codex 等），
   • 选择运行时（PowerShell – Windows 默认，或 Python 用于 Linux/macOS），
   • 复制技能或创建基于符号链接的链接以进行实时更新。

典型命令：

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

之后，只需用自然语言描述您的需求（或使用 /epf-init MyProc 等斜杠命令），助手将调用相应的技能。

---

运行时选项

运行时	使用时机
PowerShell（默认）	Windows 机器，且 PowerShell 5.1+ 可用。
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

---

系统要求

• 操作系统 – Windows（PowerShell）或任何支持 Python 3.9+ 的操作系统。
• 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）和一个 规范索引（docs/1c-specs-index.md），详细说明了技能操作的 XML 和 JSON DSL 格式（例如，EPF XML 模式、表单 DSL、角色 DSL、SKD DSL 等）。

---

TL;DR

• 是什么 – 一个包含 44+ 个代理技能的工具箱，让基于 LLM 的助手能够完全管理 1C Enterprise 开发。
• 适用对象 – 希望使用 AI 自动化重复任务的 1C 开发人员，或希望添加专业 1C 能力的 AI 平台用户。
• 如何使用 – 安装技能文件夹（或插件），选择运行时（PowerShell 或 Python），然后发出自然语言请求或斜杠命令；助手为您运行相应的 CLI、编辑 XML 或驱动 Web UI。
• 为什么 – 抽象了底层 XML 和命令行的复杂性，将整个 1C 生命周期转变为高级、AI 驱动的操作。