一键教会 AI 驱动 ComfyUIcomfy-cli 内置 Skills 技能体系comfy/debug/director完全指南【免费下载链接】comfy-cliCLI for using ComfyUI项目地址: https://gitcode.com/gh_mirrors/co/comfy-clicomfy-cli 是 ComfyUI 生态的官方命令行工具CLI for using ComfyUI负责安装、运行和扩展 ComfyUI。而它最有意思的能力是内置的Skills 技能体系只需一条comfy skills install命令就能让 Claude Code、Cursor 等 AI 编码助手原生学会驱动 ComfyUI——生成图像、视频、音频排障修复乃至导演级叙事视频。本文带你 5 分钟读懂这套机制并学会一键配置。为什么是 Skills而不是 MCP传统做法要为 AI 单独跑一个 MCP 服务器来桥接工具配置繁琐、协议复杂。comfy-cli 换了一条更轻的路一个技能就是一个 Markdown 文件SKILL.md一条命令写进你机器上所有 AI 助手的约定位置零协议、零守护进程。官方定位One file per skill, three targets, zero protocol.—— 每个技能一个文件三个安装目标零协议负担。安装器的核心逻辑见 comfy_cli/skills/init.py命令行入口在 comfy_cli/skills/command.py。快速上手comfy skills install 一键安装先安装 comfy-cli要求 Python 3.10pip install comfy-cli comfy skills install默认行为--scope user会把 4 个内置技能写入三类目标目标写入位置说明Claude Code~/.claude/skills/技能名/SKILL.md每个技能一个独立文件Cursor~/.cursor/rules/技能名.mdc转为 Cursor 规则按需触发AGENTS.md~/AGENTS.md追加带围栏注释的技能块任何支持 AGENTS.md 的工具都能读常用变体按需取用comfy skills install --dry-run # 只预览不写任何文件 comfy skills install --scope project # 装到当前项目./.claude/、./AGENTS.md comfy skills install --skill comfy-debug # 只装某一个技能 comfy skills install --target cursor # 只写 Cursor 规则 comfy skills status # 查看每个技能的安装状态安装完成后重启 Claude Code / Cursor即可生效。顺带一提comfy setup的交互式向导里也内置了技能安装环节新用户跟着向导走就能一步到位。四大内置技能详解运行comfy skills list可查看全部技能。四个内置技能各有分工另有 1 个远程技能comfy-build安装时自动拉取comfy全能驱动技能核心来源comfy_cli/skills/comfy/SKILL.md这是驾驶员手册教会 AI 三件根本事命令面comfy的每个命令何时该用run、generate、templates、nodes、workflow如何组合输出契约每条命令都返回统一的 JSON 信封ok/data/errorAI 学会了读hint字段照做不要瞎猜领域经验图像、视频、音频各自的坑——比如视频节点必须接 SaveVideo、模型名永远通过models search实时发现而绝不硬编码、云端提交优先异步prompt_id毫秒级返回。它还规定了工作流构建的层级模板 → 片段fragment 蓝图blueprint→ 原始 JSON可复用的绝不动手改编译产物。comfy-debug故障排查技能来源comfy_cli/skills/comfy-debug/SKILL.md从坏到好的最短路径手册。核心教条一切失败先读 JSON 信封error.code决定修法hint字段是权威指示照做即可details里藏着真正的为什么。它内置了常见错误码对照例如错误码一句话修法server_not_running本地服务没起 →comfy launchcloud_unauthorized云登录态过期 → 重新comfy cloud logintransient_auth云端节点令牌中途过期重新提交即可不用重新登录prompt_rejected缺节点或缺模型 → 查details.node_errors还专门列了别做的事清单比如别用改权限去修模型加载失败——问题在路径不在权限。comfy-relay展示与协作技能来源comfy_cli/skills/comfy-relay/SKILL.md一句话精髓图片即信息。代码协作交付的是 diff创意协作交付的是画面——AI 每次生成后应立即把图贴进对话让你看到并决策而不是说已生成到 outputs/x.png。配套技巧包括视频无法内联播放就用comfy preview clip.mp4生成一张缩略图网格contact sheet来看见整片节奏长渲染优先异步 子代理并行4 个镜头就 4 个任务并行跑总耗时等于最慢那一条以及诚实原则——AI 看得到画面但听不见声音音乐质量必须留给你的耳朵。comfy-director叙事视频导演技能来源comfy_cli/skills/comfy-director/SKILL.md面向广告片、品牌短片、MV 等多镜头叙事视频的导演脑。它规定严格的作业顺序概念 → 剧本 → 分镜 → 音频设计 → 制作 → 合成 → 质检。跳过剧本直接开渲是多镜头 AI 影片被判像蒙太奇、没故事的头号原因。技能里还有一套实用的连续性工具箱角色参考图贯穿每个镜头保住主角长相、镜头 N 的关键帧喂给镜头 N1 保持动作连贯、对话镜头用精确的音频驱动口型——以及恢复契约把每次提交记进LOG.md让任何接手的会话都能从磁盘独自恢复现场。进阶查看、校验与卸载comfy skills show comfy-debug # 直接打印某个技能的 SKILL.md 全文 comfy skills validate ./my-skill # 校验第三方技能目录是否符合格式契约 comfy skills uninstall # 干净卸载保留你 AGENTS.md 里的其他内容几个值得了解的小机制安装清单comfy-cli 在配置目录维护skills-manifest.json记录每个技能文件的哈希所以comfy skills status能分辨技能是current最新、stale新版已更新还是modified你手动改过手动编辑有保护重装时如果你改过技能文件旧内容会自动备份成.bak绝不悄悄覆盖已退役技能自动清理旧版本装过、后来合并进comfy主技能的技能会在下次 install 时被安全清理。写在最后comfy-cli 的 Skills 体系把AI 怎么用好 ComfyUI沉淀成了四个可直接安装的 Markdown 技能comfy 管驾驶、comfy-debug 管救火、comfy-relay 管沟通、comfy-director 管叙事。一条comfy skills install之后你的 AI 助手就从一个只会敲命令的工具升级成懂生成、懂排障、懂呈现、懂拍片的全能搭档。完整项目说明可参考 README.md。【免费下载链接】comfy-cliCLI for using ComfyUI项目地址: https://gitcode.com/gh_mirrors/co/comfy-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考