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 Web サーバーへの公開、さらには UI テストやビデオ録画チュートリアルのための 1C Web クライアントの操作まで含みます。
なぜ重要なのか – これらのスキルがないと、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 からの分析、生成、エクスポート、編集、検証。 |
| データベース管理 | DB の作成、構成のダンプ/ロード（CF、XML、DT）、更新の実行、Git からの変更のロード、構成リポジトリの管理、DB 内の拡張の管理。 |
| Web 公開 | ポータブル Apache での 1C DB の公開、ステータス確認、停止、公開解除。 |
| Web テスト | Node.js を介した 1C Web クライアントの操作（ナビゲーション、フォーム入力、レポート実行）、字幕と 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 を編集し、Web UI を操作します。
- なぜ – 低レベルの XML とコマンドラインの複雑さを抽象化し、1C ライフサイクル全体を高レベルで AI 駆動の操作に変換します。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト