ComfyUI Readable Node：Workflow 重构 Skill，拆解任务、替换自定义节点，输出整洁可阅读工作流

随着 ComfyUI 工作流复杂度的增加，节点连线杂乱、隐式依赖过多以及自定义节点滥用等问题，显著提升了工作流的维护与复用成本。ComfyUI Readable Node 是一款专为 AI 智能体（Agent）设计的 Skill，旨在将复杂的 ComfyUI 工作流重新组织为结构清晰、易于理解的“易读”形式。

GitHub：https://github.com/nomadoor/comfyui-readable-node

该工具并非简单地通过脚本重新排列节点位置，而是通过 AI 深度解析工作流的逻辑意图。若原始工作流包含多项任务，AI 会将其拆解为多个独立的单任务工作流，并遵循严格的规则从零开始重新搭建。在此过程中，系统会尽量保留原始功能，同时优先将自定义节点替换为 ComfyUI 原生节点（Core 节点），或在存在更简捷方案时进行优化，从而在不改变功能本质的前提下，显著提升工作流的稳健性与可维护性。该 Skill 同样适用于从零开始搭建全新的工作流。

ComfyUI Readable Node：Workflow 重构 Skill，拆解任务、替换自定义节点，输出整洁可阅读工作流

“易读性”的六项核心规则

为确保重构后的工作流达到“一眼即可理解、运行稳定、便于修改与重新组合”的标准，该 Skill 严格执行以下六条规则：

不隐藏节点：强制展开所有子图（Subgraph）和被折叠的节点，确保节点之间在画布上互不重叠，保持视觉清晰。
不隐藏连线：将所有隐式连接（如 Set/Get 节点、Anything Everywhere 插件或隐藏的连线）恢复为显式的物理连线。同时，拒绝使用会遮挡连线的密集“Bento（便当盒）”式布局。
从左到右排列：严格按照数据流的处理顺序，将节点从左至右进行线性排列，符合常规的信号流向认知。
单一职责原则：一个工作流文件仅执行用户期望的一项核心任务。多任务工作流将被拆分为多个独立文件。
最小化自定义节点：在能够实现相同功能的前提下，优先使用 ComfyUI 原生节点进行搭建，降低对外部插件的依赖，提升环境兼容性。
恰当地上色：为节点分配背景颜色，通过颜色编码直观区分节点所属的功能模块（如加载、处理、输出等）。

安装与配置指南

该 Skill 支持多种 AI 智能体平台。请根据您实际使用的应用环境，选择对应的安装方式。

重要警告：若已通过 Plugin（插件）方式安装，请勿再使用 npx 命令进行安装，否则会导致 Skill 被重复安装并引发冲突。

1. Claude 桌面应用

导航至 Settings → Customize → Plugins。
选择 + Add → Add marketplace → Add from a repository。
输入仓库名称：nomadoor/comfyui-readable-node。
点击 comfyui-readable-node 旁边的 + 号完成安装。

2. Claude Code (CLI)

在终端中执行以下命令：

claude plugin install comfyui-readable-node --marketplace nomadoor/comfyui-readable-node

3. ChatGPT 桌面应用 (Codex)

打开 Plugins 面板，点击 Add，选择 Add plugin marketplace。
在 Source 字段中输入 Git 仓库地址：https://github.com/nomadoor/comfyui-readable-node.git。
Git ref 和 Sparse paths 字段保持留空。
切换至 Personal 标签页，点击 comfyui-readable-node 旁边的 + 号完成添加。

4. Codex CLI

在终端中依次执行以下两条命令：

codex plugin marketplace add nomadoor/comfyui-readable-node
codex plugin add comfyui-readable-node@comfyui-readable-node

5. 其他 Agent (Gemini CLI, Cursor, GitHub Copilot 等)

通过 npx 进行全局安装。此方式要求系统已安装 Node.js 22.20 或更高版本。

npx skills add nomadoor/comfyui-readable-node -g

注：该 Skill 内部调用的脚本依赖 Python 3 环境，且仅使用 Python 标准库，无需额外安装第三方 Python 包。

操作流程与执行规范

1. 前置准备

在执行重构任务前，必须确保本地 ComfyUI 服务处于运行状态。Skill 需要连接至正在运行的 ComfyUI 实例，以读取当前环境中已安装的节点列表及接口信息。

2. 触发指令

向 Agent 提出明确的重构或搭建请求。为确保 Agent 准确调用该 Skill，建议使用强制调用指令（若以 plugin 方式安装，请使用带命名空间的完整指令）。

重构现有工作流：
“用 /comfyui-readable-node 把 my_workflow.json 整理得易读一些。ComfyUI 运行在 http://127.0.0.1:8188。”
从零搭建工作流：
“用 /comfyui-readable-node 搭一个 Flux 的 Text to Image 工作流。”

3. 预期耗时

AI 解析与重构过程需要一定的计算时间。包含约 25 个节点的工作流通常需要 10 分钟左右；规模较大的复杂工作流可能需要 20 至 40 分钟。

输出交付物说明

任务完成后，Skill 将生成以下文件，且不会覆盖原始工作流文件：

重构后的工作流文件：文件名为原文件名追加 _readable 后缀的 .json 文件（例如 my_workflow_readable.json）。用户可直接将其加载至 ComfyUI 中进行功能验证。
report.html 分析报告：可在浏览器中直接打开，该报告详细记录了 AI 的重构过程与最终工作流的解析，包含三个核心板块：
- Original：与原始工作流的直观对照。
- Rebuilt：以时间轴形式回放 AI 逐步移动和连接节点的完整重构过程。
- Walkthrough：按功能模块分部分讲解重构后工作流的设计逻辑。