artclaw-tool-creator

ArtClaw Tool Creator

AI 引导创建自定义 DCC 工具的特殊 Skill。用户通过对话界面完成工具创建流程。

触发条件

• 命令触发：用户在 ArtClaw Tool Manager 对话面板中输入 /create tool
• UI 触发：用户点击工具管理器页面的"创建工具"按钮自动发送命令

创建流程状态机

start → select_method → collect_info → generate → preview → confirm → save → complete

流程说明

1. start: 初始状态，展示创建方式选择
2. select_method: 用户选择创建方式（包装 Skill / 编写脚本 / 组合工具）
3. collect_info: 根据选择方式收集必要信息
4. generate: 生成 manifest.json 和脚本文件
5. preview: 展示预览，用户确认或修改
6. confirm: 用户确认保存
7. save: 写入文件到 ~/.artclaw/tools/user/{tool-name}/
8. complete: 创建完成

三种创建方式

1. 包装 Skill (skill_wrapper)

将现有 Skill 包装为固定参数的快捷工具。

对话模板：

Agent: 选择要包装的 Skill：
[列出可用 Skills，如：comfyui-txt2img, maya-operation-rules, 等]

用户: comfyui-txt2img

Agent: 该 Skill 有以下参数：prompt, width, height, steps, sampler
暴露哪些参数给用户？其他参数的固定值？

用户: 只暴露 prompt 和 steps，width/height 固定为 1024，sampler 固定为 euler

Agent: [生成预览] 确认创建工具"快速文生图"？
[保存] [修改] [取消]

生成的 manifest.json 结构：

{
  "id": "user/{tool-name}",
  "implementation": {
    "type": "skill_wrapper",
    "skill": "comfyui-txt2img",
    "fixedParams": { "width": 1024, "height": 1024, "sampler": "euler" }
  },
  "inputs": [
    { "id": "prompt", "name": "提示词", "type": "string", "required": true },
    { "id": "steps", "name": "采样步数", "type": "number", "default": 20 }
  ]
}

2. 编写脚本 (script)

使用 DCC 原生 Python API 创建自定义脚本工具。

对话模板：

Agent: 请描述工具功能：

用户: 批量导出选中模型为 FBX，支持指定导出路径和文件前缀

Agent: 需要哪些参数？
- 导出路径（必需）
- 文件前缀（可选，默认为空）
- 包含动画（可选，默认 false）

用户: 是的

Agent: [生成脚本预览] 确认创建工具？
[保存] [修改] [取消]

生成的脚本必须遵循以下规则：

"""工具名称 — 一句话描述。"""
# ── SDK 头（tool-creator 自动注入）──
import os, json
import artclaw_sdk as sdk

def _load_manifest() -> dict:
    manifest_path = os.path.join(os.path.dirname(__file__), "manifest.json")
    with open(manifest_path, "r", encoding="utf-8") as f:
        return json.load(f)
# ── SDK 头结束 ──


def main_function(**kwargs):
    """入口函数。kwargs 由 Tool Manager 传入。"""
    manifest = _load_manifest()

    # ── 1. 参数解析（必须）——从 manifest inputs 读取，不在脚本里硬编码默认值 ──
    parsed = sdk.params.parse_params(manifest.get("inputs", []), kwargs)

    # ── 2. 对象获取 + 筛选（按需；event trigger 工具通常不需要此段）──
    type_cfg = manifest.get("defaultFilters", {}).get("typeFilter", {})
    types = type_cfg.get("types", [])          # 来自 manifest，不硬编码
    source = type_cfg.get("source", "selection")

    if source == "selection":
        explicit = parsed.get("target_paths", "")
        if explicit:
            objects = [{"path": p.strip(), "type": "", "name": p.strip().rsplit("/", 1)[-1]}
                       for p in explicit.split(",") if p.strip()]
        else:
            # 根据工具需求二选一：
            # sdk.context.get_selected_assets()  — Content Browser / 资源管理器
            # sdk.context.get_selected_objects() — 场景 / 视口
            objects = sdk.context.get_selected_assets()
        if types:
            objects = sdk.filters.filter_by_type(objects, types)
        if not objects:
            return sdk.result.fail("NO_INPUT", "未指定目标，且当前无选中对象。")

    # ── 3. 业务逻辑（DCC 原生 API）──
    # import unreal  # UE
    # import bpy     # Blender
    # ...

    # ── 4. 结果上报（必须）──
    return sdk.result.success(data={}, message="完成")