Comfypet Jmcai Skill

---
name: comfypet-jmcai-skill
description: |
  调用 JMCAI Comfypet 桌面应用中已经配置好的 ComfyUI workflow。本技能必须配合 JMCAI 桌面端运行。用于查询可用 workflow、读取暴露参数、提交运行并轮询结果。适用于用户要求生成图片、生成视频，或执行带图片、遮罩、音频、视频、文件输入资产的 workflow 场景；不适用于导入 workflow、修改 schema、修改 target 绑定或直连原生 ComfyUI 接口。
allowed-tools: ["Bash(python *)", "Bash(python3 *)", "Bash(py *)"]
metadata: {"openclaw":{"emoji":"🐾","homepage":"https://github.com/allen-Jmc/comfypet-jmcai-skill-pack","requires":{"anyBins":["python","python3","py"],"config":["config.json"]},"os":["win32","linux","darwin"]}}
---

# JMCAI Comfypet Skill

> [!IMPORTANT]
> **Dependency Requirement**: This skill MUST be used with the **JMCAI Comfypet Desktop Application**.
> Download the desktop app here: [https://github.com/allen-Jmc/comfypet-jmcai-Dist](https://github.com/allen-Jmc/comfypet-jmcai-Dist)

先运行：

```bash
python jmcai_skill.py doctor
python jmcai_skill.py registry --agent
```

然后按以下顺序执行：

1. 根据 `summary`、`tags`、`input_modalities`、`output_modalities`、`example_prompts` 选择最合适的 workflow。
2. 只填写 alias schema 中暴露的参数。
3. 提交运行：

```bash
python jmcai_skill.py run --workflow <workflow_id> --args '{"prompt_1":"a cinematic scene"}'
```

4. 读取 `run_id` 后，单次查询状态：

```bash
python jmcai_skill.py status --run-id <run_id>
```

5. 如需回看，再读取：

```bash
python jmcai_skill.py history --workflow <workflow_id> --limit 5
```

## Parameter Rules

- 缺少 `required: true` 的参数时，向用户追问或在上下文足够明确时补齐
- 只能使用 `registry --agent` 返回的 alias 参数名
- `image | mask | video | audio | file` 类型参数对本机 bridge 仍可直接传本机绝对路径
- `bridge_url` 指向局域网另一台桌面端时，skill 会自动把本机资产上传成 `upload:<id>`，不用手工改写参数
- `file` 类型远程自动上传只覆盖常见 workflow 资产格式，例如图片、音视频、`txt/csv/pdf/srt/vtt/ass`
- 不要修改 schema、workflow 或 target 配置

## Privacy & Security

- **Secure Upload**: This skill only supports uploading workflow asset files needed by exposed schema fields (`image`, `mask`, `video`, `audio`, `file`).
- **Access Control**: Generic `file` uploads stay restricted to a narrow whitelist (`.txt`, `.csv`, `.pdf`, subtitles, and common media assets) instead of arbitrary local files.
- **Local First**: By default, it communicates with `127.0.0.1`. If using a remote bridge, ensure you trust the endpoint.

## Failure Handling

- `doctor` 失败：提示用户启动或升级 JMCAI 桌面应用
- `run` 返回错误：把错误原文反馈给用户，不要伪造成功
- `status` 返回 `queued` 或 `running`：告诉用户仍在生成，并在下一次独立调用中继续查询
- `status` 返回 `success`：优先返回 `outputs` 中已经自动下载到当前机器的本地文件路径
- `status` 或 `history` 返回 `warnings`：告诉用户任务已成功，但自动下载输出到当前机器时出现了网络或本地写入问题

需要 bridge 契约细节时，读取 `references/bridge.md`。  
需要图片 / 视频 / 资产输入工作流示例时，读取 `references/usage.md`。