5分钟快速安装cc-1c-skills：4种方式为AI助手装上1C:Enterprise开发超能力（新手完整指南）

cc-1c-skills是一个面向1C:Enterprise 8.3（1С:Предприятие 8.3）开发的开源 AI 技能包。它为 Claude Code、Cursor、Codex 等 AI 编程助手一次性装上80 多个现成技能，覆盖从创建配置、外部处理（EPF）、表单、角色到数据库操作和 Web 客户端测试的完整开发生命周期——AI 不再需要"手抠"复杂的 1C XML 格式，而是直接调用封装好的抽象接口。本指南带你用4 种安装方式，在 5 分钟内完成部署。

📦 安装前：环境要求一览

💡好消息：XML 生成类技能（form-compile、meta-compile 等）不需要 1C 平台就能运行，纯 Windows/Linux/Mac 环境即可先跑起来。

方式一：直接复制.claude/skills/目录（最快 ⚡）

适合Claude Code用户，30 秒完成：

1. 克隆或下载仓库：

git clone https://gitcode.com/gh_mirrors/cc/cc-1c-skills

2. 把.claude/skills/目录整体复制到你的项目根目录：

我的项目/ ├── .claude/skills/ ← 复制到这里 └── ...

3. 在项目目录启动 Claude Code，技能即刻生效。

就这么简单——目录就位即安装，无需任何构建步骤。

方式二：Claude Code 插件市场一键安装

如果你更偏好插件管理（自动更新、统一管理），在 Claude Code 中执行：

/plugin marketplace add <cc-1c-skills 仓库地址> /plugin install 1c-skills@cc-1c-skills # PowerShell 版（Windows 推荐）

或选择 Python 版本：

/plugin install 1c-skills-py@cc-1c-skills # Python 版（Linux/Mac 或 PS 不可用）

插件清单定义在 .claude-plugin/plugin.json，仓库同时提供了 PS 和 Python 两个变体，按平台二选一即可。

方式三：OpenAI Codex 插件安装

Codex 用户同样走插件市场：

codex plugin marketplace add cc-1c-skills # 指向 cc-1c-skills 仓库 codex /plugins

在插件列表中选择1c-skills（PowerShell）或1c-skills-py（Python），点击 Install 完成。

方式四：switch.py脚本安装（支持 13 种 AI 平台 🧩）

这是最灵活的官方方式——scripts/switch.py 支持将技能一键安装到13 个平台：Claude Code、Cursor、OpenAI Codex、GitHub Copilot、Gemini CLI、Windsurf、Cline、Kiro、Roo Code、OpenCode、Augment 等。

git clone https://gitcode.com/gh_mirrors/cc/cc-1c-skills tools/cc-1c-skills # 安装为独立副本（推荐）：更新时重新运行即可 python tools/cc-1c-skills/scripts/switch.py claude-code --project-dir . # 或者用交互式模式，一步步选平台、安装方式、运行时 python tools/cc-1c-skills/scripts/switch.py

常用参数速查：

✅第三方技能不受影响：脚本会写入 manifest 文件.cc-1c-skills.json，更新和卸载时只管理本套技能的技能，同目录下的其他技能原样保留。

🚀 安装完成：第一次使用

不需要背任何命令——直接用自然语言描述任务即可，助手会根据每个技能的description自动匹配：

• "帮我创建一个名为 我的处理 的外部处理"
• "给这个单据对象加一张表单"
• "把这份配置里的子对象按类型排序"

当然，斜杠命令同样可用（如/epf-init、/form-compile），适合需要精确控制时调用指定技能。

⚙️ 进阶配置（可选但推荐）

1. 切换到 Python 运行时（Linux/Mac 用户）：

python scripts/switch.py --runtime python pip install -r requirements.txt

requirements.txt 包含 3 个依赖：lxml（DOM 技能）、Pillow（/img-grid）、psutil（Web 技能）。

2. 配置项目文件.v8-project.json：

这是所有技能共享的统一项目配置（1C 平台路径、数据库列表、Apache 等工具路径）。仓库根目录提供了模板 .v8-project.example.json，复制为.v8-project.json并修改路径即可，详细字段说明见 docs/v8-project-guide.md。

🗺️ 装上了哪些"超能力"？

技能共 17 个分组，摘取最常用的一览（完整列表见 README.md）：

完整技能矩阵与各组指南（docs/epf-guide.md、docs/form-guide.md、docs/db-guide.md 等）以及 44 种对象的 XML 规范索引，可从 docs/1c-specs-index.md 一站式查起。

❓ 常见问题

Q：装完看不到技能？A：确认 AI 助手是从项目根目录启动的（技能在根目录的.claude/skills/下被发现）。

Q：Windows 用 PowerShell 版还是 Python 版？A：Windows 上推荐 PowerShell 版（默认、功能最完整的主版本）；Python 移植版主要服务 Linux/Mac 用户，详见 docs/python-porting-guide.md。

Q：只想在本地跑 XML 生成，没装 1C 可以吗？A：可以。生成类技能（compile/decompile 系列）纯脚本运行，只有打包（build/dump）和数据库技能才需要 1C 平台。

Q：能保护"供应商支持中"的配置不被误改吗？A：内置技能自带保护；Claude Code 用户还可手动启用实验性 hooks（锁保护 + 技能提示），见 hooks/README.md。

🎯总结：4 种安装方式任选其一——复制目录最快、插件安装最适合长期管理、switch.py平台覆盖最广。装好后，你的 AI 助手就从"会写代码"进化为"会做 1C 开发"，把任务丢给它，剩下的交给技能包吧。