Skills-Abhängigkeitsverwaltung
Skill-Skripte erfordern normalerweise Bibliotheken von Drittanbietern. Wie diese Abhängigkeiten deklariert, installiert und gesperrt werden, ist die Grundlage für einen zuverlässigen Betrieb von Skills.
Dateien zur Abhängigkeitsdeklaration
Erstellen Sie im scripts/-Verzeichnis des Skillsrequirements.txt(Python) oderpackage.json(Node.js), um alle Abhängigkeiten zentral zu deklarieren.
Python-Abhängigkeiten: requirements.txt
# 文件路径:scripts/requirements.txt # 格式:包名==版本号(锁定版本,确保可重复安装) pandas==2.1.4 # 数据处理 openpyxl==3.1.2 # Excel 读写 pypdf==3.17.0 # PDF 处理 python-docx==1.1.0 # Word 文档处理 requests==2.31.0 # HTTP 请求
Node.js-Abhängigkeiten: package.json
Beispiel
"name": "my-skill-scripts",
"version": "1.0.0",
"description": Node.js-Abhängigkeiten für Skill-Skripte,
"dependencies": {
"xlsx": "^0.18.5",
"puppeteer": "^21.0.0"
}
}
Erkläre die Installationsmethode in SKILL.md
## 依赖安装 首次使用前,运行以下命令安装 Python 依赖: ```bash pip install -r scripts/requirements.txt --break-system-packages ``` 若运行环境已预装依赖,可跳过此步骤。
Abhängigkeiten im Skript automatisch installieren
Für Skills, die ohne Konfiguration ausgeführt werden müssen, können Sie am Anfang des Skripts eine Abhängigkeits-Selbstprüfung und eine automatische Installationslogik hinzufügen.
Beispiel
import subprocess
import sys
import importlib
# Abhängigkeitsliste definieren: (pip install name, import name, Versionsanforderung)
ABHÄNGIGKEITEN = [
("pandas", "pandas", ">=2.0"),
("openpyxl", "openpyxl", ">=3.0"),
("python-docx", "docx", None), # Keine Versionsanforderung
]
def install_if_missing(pip_name: str, import_name: str) -> bool:
"""Prüft und installiert bei Bedarf Abhängigkeitspakete"""
try:
importlib.import_module(import_name)
return True # Bereits installiert, direkt zurückgeben
except ImportError:
print(f"Installiere: {pip_name}...")
result = subprocess.run(
[sys.executable, "-m", "pip", "install", pip_name,
"--break-system-packages", "--quiet"],
capture_output=True, text=True
)
if result.returncode == 0:
print(f"Installation erfolgreich: {pip_name}")
return True
print(f"Installation fehlgeschlagen: {pip_name}\n{result.stderr}")
return False
def ensure_all_deps() -> bool:
"""Stellt sicher, dass alle Abhängigkeiten installiert sind"""
failed = []
for pip_name, import_name, _ in DEPENDENCIES:
if not install_if_missing(pip_name, import_name):
failed.append(pip_name)
if failed:
print(f"Die folgenden Abhängigkeiten konnten nicht installiert werden: {', '.join(failed)}")
return False
return True
if __name__ == "__main__":
if not ensure_all_deps():
sys.exit(1)
# Sobald die Abhängigkeiten bereit sind, die Logik normal ausführen
import pandas as pd
print("Alle Abhängigkeiten sind bereit, Ausführung wird gestartet...")
正在安装:python-docx... 安装成功:python-docx 所有依赖已就绪,开始执行...
Strategien zum Umgang mit Versionskonflikten
Wenn die von einem Skill benötigte Paketversion mit einer vorhandenen Systemversion in Konflikt steht, gibt es mehrere Vorgehensweisen:
| Strategie | Ansatz | Anwendungsfall |
|---|---|---|
| Lockere Versionsanforderungen | Verwende >= statt ==, um höhere Versionen zuzulassen | Die meisten Szenarien, gute Kompatibilität |
| Virtuelle Umgebung | In venv installieren, isoliert vom System | Strenge Versionsanforderungen |
| Die vorhandene Systemversion verwenden | Version nicht festschreiben; die systeminstallierte Version verwenden | Abhängigkeiten sind gängige Bibliotheken und Versionsunterschiede haben minimale Auswirkungen |
Eine virtuelle Umgebung erstellen (optional)
Beispiel
python3 -m venv scripts/.venv
# Virtuelle Umgebung aktivieren
source scripts/.venv/bin/activate
# Abhängigkeiten in der virtuellen Umgebung installieren
pip install -r scripts/requirements.txt
# Das Skript in der virtuellen Umgebung ausführen
python scripts/process.py
In Claudes Ausführungsumgebung ist eine virtuelle Umgebung normalerweise nicht erforderlich, da jede Sitzung relativ isoliert ist. Virtuelle Umgebungen werden hauptsächlich während der lokalen Entwicklung verwendet, um Konflikte mit anderen Projekten auf dem Entwicklungsrechner zu vermeiden.
Standards für die Dokumentation von Abhängigkeiten
In SKILL.md oder einer separaten README sollten alle externen Abhängigkeiten klar aufgeführt werden, damit Benutzer die Anforderungen vor der Installation verstehen können.
## 系统要求 ### 运行环境 - Python 3.8 或更高版本 - pip(Python 包管理工具) ### Python 依赖 | 包名 | 版本 | 用途 | |------|------|------| | pandas | >=2.0 | 数据读取与处理 | | openpyxl | >=3.0 | Excel 文件读写 | | python-docx | 任意 | Word 文档生成 | ### 系统工具(可选) - pandoc:格式转换(apt-get install pandoc)Andere Erweiterungen