n8n 多实例定位助手
帮助 MCP 会话安全选择、验证并切换目标 n8n 实例，避免误读和误写。
文档明确要求先发现实例、切换后确认 current，并在凭证写入前再次核验；对 INSTANCE_AMBIGUOUS 设有 fail-closed 处理，也提醒凭证属于高风险数据。扣分在于普通读写和显式错误切换仍可能静默误路由，未提供通用回滚或撤销方案，敏感数据处理主要依赖未包含的其他 skill，且发布者身份未被验证。
SKILL.md 提供了较完整的工具模式、错误代码、恢复步骤和并行调用陷阱，正常路径具有可执行性。扣分在于仅有静态文档证据，没有针对关键路径的提交测试或 CI 复现；README 还将规则数量描述为“五条”而正文实际列出六条，降低了一致性和故障诊断信心。
触发条件、适用的多实例环境、单实例不适用边界和典型场景都较明确，并覆盖复制、误路由和凭证操作。扣分在于未说明中文交互支持、未讨论中国大陆网络可达性，也未充分界定 n8n-mcp 版本或工具变体差异。
文档结构清晰，包含核心规则、工具形状、恢复表、快速参考、集成关系、版本 1.0.0、兼容性说明和 MIT 许可。扣分在于没有变更日志、明确维护责任人或更新路径，README 与目标 skill 的规则数量存在不一致，且 README 的仓库级测试声明不能证明该 skill 的覆盖情况。
该 skill 直接给出 list、switch、核验、重试和跨实例复制的操作顺序，能够覆盖其声明的核心决策问题，预计可减少错误重建和误写凭证。扣分在于未执行验证，且没有可复现的代表性输出或第三方结果证据；复制工作流和凭证仍依赖其他 skill 的具体参数知识。
源文件包含具体调用形状、错误代码、响应字段、恢复表和版本信息，具备有限的审计性。扣分在于提供的“真实响应”“生产测试”等说法未由目标 skill 内的测试套件、CI 或第三方证据独立 corroborate，静态审查无法验证行为是否与 n8n-mcp 实际实现一致。
- 显式切换到错误实例不会被 INSTANCE_AMBIGUOUS 拦截；凭证写入前必须人工确认 current，普通写操作也应先核验目标。
- 目标 skill 未包含自动化测试或 CI 证据；部署前应在隔离的 staging 实例验证切换、删除实例后的 fallback 和误路由恢复行为。
- 文档未说明中文支持或中国大陆网络可达性；实际采用前需确认 n8n-mcp 服务和相关 MCP 连接可访问。
这个 Skill 能做什么，适合哪些场景？
这是 n8n-skills 仓库中的一个独立 Agent Skill，专门处理 n8n-mcp 连接访问多个 n8n 实例的情况。它指导助手先发现可用实例，再按名称切换当前会话目标，并在凭据写入或破坏性操作前验证目标。它还覆盖错误实例导致的 NOT_FOUND、空数据和 INSTANCE_AMBIGUOUS 场景。该 Skill 只负责实例定位与恢复流程，不替代其他 Skill 对工作流或凭据字段的具体操作指导。
指导助手调用 n8n_instances 的 list 模式读取 current、default 和 available 实例；调用 switch 模式按名称绑定当前 MCP 会话；要求将切换与后续依赖操作分开执行；在凭据创建、更新、删除及删除性工作流编辑前重新确认 current；针对 UNKNOWN_INSTANCE、INSTANCE_AMBIGUOUS、NOT_FOUND 和错误或空数据提供恢复步骤；指导在不同实例之间读取并复制工作流或凭据。
- 管理生产和预发布两个 n8n 实例的用户，需要在操作前确认当前会话指向正确环境。
- 服务多个团队或客户、每个团队拥有独立 n8n 实例的用户，需要按实例名称切换目标。
- 已知工作流或数据表存在却收到 NOT_FOUND 的用户，需要判断是否误连了其他实例。
- 准备创建、更新或删除凭据的用户，需要在写入秘密前重新验证目标实例。
- 凭据操作返回 INSTANCE_AMBIGUOUS 的用户，需要在当前会话中明确执行切换后重试。
这个 Skill 有哪些优点和局限？
- 明确规定先列出实例、再切换并验证目标，降低静默误路由风险。
- 特别强调凭据写入前的目标确认，并解释 INSTANCE_AMBIGUOUS 的 fail-closed 行为。
- 提供针对 NOT_FOUND、空数据和实例删除后回退默认实例等情况的恢复流程。
- 覆盖跨实例复制工作流或凭据的操作顺序。
- 必须使用提供 n8n_instances 工具的 n8n-mcp 多实例环境；单实例账户应直接使用 n8n 工具。
- Skill 主要解决实例选择和恢复，不提供其他 n8n 工具的完整 CRUD 参数说明。
- 源材料没有给出独立于 Claude Code、Claude.ai 或 MCP 会话的运行方式。
- 显式切换到错误实例仍可能静默写入，安全性仍依赖操作者正确确认目标。
如何安装这个 Skill？
该 Skill 随 n8n-skills 集合安装。Claude Code 推荐执行：/plugin install czlonkowski/n8n-skills。手动安装可先运行 git clone https://github.com/czlonkowski/n8n-skills.git，再将 n8n-skills/skills/* 复制到 ~/.claude/skills/。使用前还需要已安装并配置 n8n-mcp MCP server，以及配置 .mcp.json。Claude.ai 可下载 skills/n8n-multi-instance 文件夹并通过 Settings → Capabilities → Skills 上传。
如何使用这个 Skill？
当 n8n_instances 工具可用、需要操作多个 n8n 环境，或出现错误实例、空数据、NOT_FOUND、INSTANCE_AMBIGUOUS 时使用。例如："切换到 prod 实例后查看工作流"，或"凭据写入返回 INSTANCE_AMBIGUOUS，如何安全恢复？"。实际操作依赖当前 MCP 会话中可用的 n8n 工具。