artclaw-skill-manage

ArtClaw 技能管理

管理 ArtClaw 的 Skill 技能包：列出、执行、安装、卸载、更新、发布、重命名、创建。

版本与更新模型

Skill 存在于两个位置，数据流是单向的：

源码 skills/{layer}/{dcc}/{name}/     ──更新──>  已安装 ~/.openclaw/workspace/skills/{name}/
  (Git 仓库，分发给其他用户)            <──发布──    (本地运行时，AI 实际使用)

• 编辑：修改已安装目录中的文件（SKILL.md / __init__.py / references）
• 发布：publish_skill() — 已安装目录 → 源码仓库，自动 bump 版本 + git commit
• 更新：update_skill() / sync_all() — 源码仓库 → 已安装目录（覆盖安装）
• 变更检测：有版本号用版本对比，无版本号用文件内容 hash 对比

调用方式

通过 MCP 工具 run_ue_python（UE）或 run_python（Maya/Max）执行 Python 代码。

---

常用操作

列出 Skill

from skill_hub import get_skill_hub
hub = get_skill_hub()
for s in hub.list_skills():
    print(f"[{s['category']}] {s['name']} v{s.get('version','?')} - {s['description']}")

安装 / 更新 / 全量更新

from skill_sync import install_skill, update_skill, sync_all

install_skill("ue57_batch_rename_actors")   # 从源码安装单个
update_skill("ue57_get_material_nodes")     # 从源码更新单个
sync_all()                                   # 安装未安装的 + 更新版本不一致的

卸载

from skill_sync import uninstall_skill
uninstall_skill("ue57_batch_rename_actors")

发布（已安装 → 源码仓库）

from skill_sync import publish_skill
result = publish_skill(
    "ue57_my_tool",
    target_layer="marketplace",   # 或 "official"
    bump="patch",                  # patch / minor / major
    changelog="修复了多选时的bug",
    dcc="unreal",                  # universal / unreal / maya / max
)

对比源码 vs 已安装

from skill_sync import compare_source_vs_runtime
diff = compare_source_vs_runtime()
# diff: {available, installed, updatable, orphaned, project_root, error}

重命名

from skill_sync import rename_skill
result = rename_skill("old_skill_name", "new_skill_name")
# 自动更新: 安装目录 + manifest.json + SKILL.md frontmatter + 源码目录

---

创建新 Skill

步骤

1. hub.auto_name(description) 生成名称
2. AI 生成 __init__.py + manifest.json
3. 必须生成 SKILL.md（含 YAML frontmatter，见下方模板）
4. 保存到已安装目录 ~/.openclaw/workspace/skills/<skill_name>/
5. publish_skill() 发布到源码仓库