n8n AI 代码工具指南
帮助你为 n8n AI Agent 编写符合工具运行契约的 JavaScript 或 Python 代码。
技能明确区分 Code Tool 与 Code node，限制外部 HTTP、凭据、状态访问，并建议改用其他工具；这降低了权限和数据流风险。未说明敏感数据处理、用户确认、回滚/恢复、依赖安全或实际部署隔离；发布者未获验证，因此扣分。
文档结构一致，覆盖输入、输出、常见错误、替代方案和异常反馈，且示例路径基本可复现。没有针对关键路径的已提交测试或 CI 执行证据，版本兼容性说明也存在 v1.2/v1.3 与 v1.1+ 的边界不完全清晰；静态上限内扣分。
名称、受众、触发条件、适用场景及与 toolWorkflow/HTTP Request Tool 的边界描述清楚。内容主要面向英文 n8n 用户，未提供中文支持或中国大陆网络可达性说明；对具体 n8n 版本和运行环境的边界证据有限。
主文档、输入 schema 和错误目录形成了较好的渐进式结构，包含安装前提、示例、限制、版本和 MIT 许可信息。维护责任、变更日志、更新路径和正式依赖锁定信息不充分，且部分维护信息来自仓库级 README 而非目标技能自身。
技能直接提供 JS/Python 模板、返回格式、schema 配置、错误修复和工具选择建议，核心任务很可能可直接完成，边际价值明确。由于未执行示例或验证 n8n 版本行为，不能确认所有“working”示例在目标环境中无需修改；按静态评估上限计分。
文档列出 n8n、ToolCode 和 LangChain 的官方来源，并给出可审计的错误字符串和配置片段。没有本地测试套件、CI 结果或第三方执行记录，且外部来源内容未在本次静态材料中独立核验，因此仅给有限分数。
- 不要把该技能当作已验证的安全边界：对敏感输入、凭据、外部副作用和生产部署仍需人工审查。
- 在目标 n8n 版本中执行并验证 v1.2/v1.3 schema 行为、Python 变量绑定、返回类型和错误处理；文档未提供可复现测试证据。
- 发布者身份未通过 FollowSkills 企业注册表验证，官方来源链接和维护状态应在采用前复核。
这个 Skill 能做什么，适合哪些场景？
该技能专门指导 n8n Custom Code Tool，而不是普通的 n8n Code 节点。它解释如何读取 AI 传入的 query、处理非结构化或结构化输入，并返回字符串结果。内容覆盖工具命名、输入 schema、常见错误及沙箱限制。适合需要在 AI Agent 中执行纯计算、解析、格式化或校验逻辑的 n8n 用户。
提供 JavaScript 和 Python Custom Code Tool 示例；说明如何从 query 或 _query 读取输入；指导使用 specifyInputSchema、jsonSchemaExample、inputSchema 和 DynamicStructuredTool 定义结构化参数；说明如何用 JSON.stringify 返回结构化结果；解释 Wrong output type returned、No execution data available 等错误；列出 Code Tool 沙箱不可用的变量和助手；比较 Code Tool、toolWorkflow 与 HTTP Request Tool 的适用场景。
- n8n AI Agent 开发者需要编写一个计算贷款、价格或其他数值的确定性工具。
- 工作流作者需要解析 AI 传入的 JSON 字符串，并将结果作为工具观察值返回。
- 调试者遇到 Wrong output type returned 或 response property should be a string 错误。
- 需要多个类型化参数的生产工具开发者希望使用 specifyInputSchema 进行输入验证。
- 开发者发现代码需要 HTTP 请求、凭据或跨调用状态，需要判断是否应改用 toolWorkflow 或 HTTP Request Tool。
这个 Skill 有哪些优点和局限？
- 明确区分 Custom Code Tool 与普通 Code 节点的节点类型、输入和返回契约。
- 同时覆盖 JavaScript、Python、非结构化输入和结构化 schema。
- 针对常见错误提供原因、修复方式和面向 LLM 的错误提示建议。
- 明确说明 $fromAI、$input、$json 和 HTTP helper 等沙箱限制。
- 仅聚焦 n8n Custom Code Tool，不是完整的 n8n 工作流开发指南。
- Code Tool 沙箱不提供常见数据访问、HTTP、凭据和持久状态能力。
- 结构化输入需要支持相应 schema 功能的 n8n 版本；文档未给出完整版本兼容矩阵。
- 源材料没有提供独立于整个仓库的测试结果或平台覆盖证明。
如何安装这个 Skill？
该技能属于 n8n-skills 集合。集合要求先安装并配置 n8n-mcp MCP server。Claude Code 可运行 /plugin install czlonkowski/n8n-skills；手动安装时克隆仓库并执行 cp -r n8n-skills/skills/* ~/.claude/skills/。在 Claude.ai 中，可下载 skills/n8n-code-tool 文件夹，将其压缩后通过 Settings → Capabilities → Skills 上传。源材料未提供单独的 Codex 安装命令。
如何使用这个 Skill？
安装后，用明确描述 n8n Custom Code Tool 的问题触发，例如：Why does my Code Tool throw 'Wrong output type returned'? 或 How do I define structured input for an n8n AI Agent Code Tool? 编写工具时读取 JavaScript 的 query 或 Python 的 _query，并返回字符串；结构化输出通常使用 JSON.stringify()。
这个 Skill 与同类方案有什么区别？
相较于普通 n8n Code 节点，Custom Code Tool 面向 AI Agent 调用，读取 query 并返回字符串，而不是返回 [{json:{...}}]。如果需要 $fromAI()、凭据、HTTP 请求或其他节点访问，应考虑 toolWorkflow；如果核心需求是单次 API 调用，应考虑 HTTP Request Tool。