尧图网站建设 
用 Rube MCP 驱动 Xero 记账自动化awesome-codex-skills 中 Xero Automation 技能全解析【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills本文系统讲解 awesome-codex-skills 仓库中 Xero Automation 技能 的完整用法如何在 Codex 会话中通过 Rube MCP 服务器连接 Xero 云端会计软件自动化处理发票查询、联系人管理、收款登记、银行交易记账、科目表Chart of Accounts查看等多租户记账工作流。读完本文你将掌握该技能的连接配置、9 个核心工具的参数语义与调用格式以及多租户路由、OData 过滤语法、分页等关键实战避坑点可直接在小企业记账场景中落地使用。技能定位面向小企业记账的 Xero 自动化指令包Xero 是面向小型企业的云端会计平台涵盖发票、联系人、付款、银行交易与科目表等核心记账对象。在 awesome-codex-skills 的composio-skills目录下每个子目录对应一个由 Composio 提供的自动化技能Xero Automation 正是其中专注于会计记账场景的一个。该技能的元数据定义在文件头部的 YAML frontmatter 中composio-skills/xero-automation/SKILL.md--- name: Xero Automation description: Xero Automation: manage invoices, contacts, payments, bank transactions, and accounts in Xero for cloud-based bookkeeping requires: mcp: [rube] ---这段元数据的含义是技能名称为Xero Automationdescription声明其能力范围——管理发票、联系人、付款、银行交易与账户用于云端记账requires.mcp声明它依赖名为rube的 MCP 服务器。Codex 正是依据description来判断何时自动触发该技能参见仓库 README.md 对 Codex Skills 触发机制的说明因此描述中精准写明记账/发票/银行交易等关键词便于 Agent 在相关请求出现时自动命中。该技能与仓库中同目录下的其他 Composio 技能如 QuickBooks Automation、FreshBooks Automation共用同一套 Rube MCP 基础设施但工具集与参数体系各自针对 Xero 的 API 模型定制本文聚焦 Xero 部分。环境准备连接 Rube MCP 与 Xero 租户第一步挂载 Rube MCP 服务器执行任何 Xero 工具之前必须先让 Codex 会话可用 Rube MCP 服务器其端点地址为https://rube.app/mcp。从仓库中同族的 composio-automation 技能 可知Rube 的接入方式是将其添加为客户端配置中的 MCP server无需 API Key——添加端点即可工作。挂载后会话中会出现RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL等一组 Rube 工具它们是对底层 1000 集成能力含 Xero的统一入口。第二步建立 Xero toolkit 连接在调用任何XERO_*工具前必须确认存在xerotoolkit 的活动连接若尚无连接通过RUBE_MANAGE_CONNECTIONS指定 toolkit 为xero发起连接流程按照返回的认证链接完成 Xero 账户授权OAuth 流程由 Rube 托管确认连接状态为 ACTIVE 后再执行工作流。第三步多租户确认可选但重要若你同时管理多个 Xero 组织org / tenant需先调用XERO_GET_CONNECTIONS列出当前活动的租户连接取出正确的tenant_id供后续所有工具调用使用。快速自检清单Rube MCP 已挂载 →RUBE_SEARCH_TOOLS可响应 →RUBE_MANAGE_CONNECTIONS中xero连接为 ACTIVE → 多租户场景下已用XERO_GET_CONNECTIONS锁定tenant_id。技能安装可选若希望将该技能安装到本地 Codex 环境可参照仓库提供的 skill-installer 技能 使用其脚本python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/xero-automation安装后重启 Codex 以加载新元数据参见 README.md 的安装说明。核心工作流一发票的查询与过滤工具与参数工具XERO_LIST_INVOICES参数说明Statuses逗号分隔的状态过滤取值DRAFT、SUBMITTED、AUTHORISED、PAIDContactIDs逗号分隔的 Contact ID 列表按联系人过滤InvoiceIDs逗号分隔的 Invoice ID 列表按发票 ID 过滤whereOData 风格过滤表达式如Status\AUTHORISED\ AND Total100order排序表达式如Date DESC、InvoiceNumber ASCpage分页页码If-Modified-SinceUTC 时间戳仅返回该时间之后被修改过的发票增量同步tenant_idXero 组织 ID省略时默认使用第一个租户调用示例Tool: XERO_LIST_INVOICES Arguments: Statuses: AUTHORISED,PAID order: Date DESC page: 1实战要点状态过滤是最高频用法例如应收账龄分析时通常需要先取AUTHORISED已确认待收与PAID已收款状态的发票。增量同步周期性任务如每日同步应记录上次运行时间并传入If-Modified-Since只拉取增量数据避免全量重复拉取。多条件组合where可与Statuses、order、page叠加使用注意where中字符串值须用转义双引号包裹见后文已知陷阱。核心工作流二联系人的检索与管理联系人Contact是发票、银行交易等对象的外键基础先检索出正确的ContactID是后续记账的前提。工具与参数工具XERO_GET_CONTACTS参数说明searchTerm不区分大小写的搜索词覆盖 Name、FirstName、LastName、Email、ContactNumber 字段ContactID按 ID 获取单个联系人whereOData 过滤如ContactStatus\ACTIVE\page/pageSize分页控制order排序如UpdatedDateUTC DESCincludeArchived设为true时包含已归档联系人summaryOnly设为true时返回轻量响应减少负载调用示例Tool: XERO_GET_CONTACTS Arguments: searchTerm: acme page: 1 pageSize: 25实战要点优先用searchTerm而非复杂where原文档特别提示在高流量数据量大的账户上某些where过滤条件如IsCustomer、IsSupplier可能被 Xero 拒绝此时应回退到searchTerm 分页。summaryOnly优化性能仅需确认联系人存在或获取 ID 列表时开启轻量模式可显著减少响应体积适合大批量核对场景。核心工作流三创建付款记录付款Payment将发票与银行账户关联起来是客户付了钱这一记账动作的落点。工具与参数工具XERO_CREATE_PAYMENT参数必填说明InvoiceID✅付款所对应的 Xero 发票 IDAccountID✅收款银行账户 IDAmount✅付款金额数字类型Date—付款日期格式YYYY-MM-DDReference—付款参考或描述CurrencyRate—外币付款时的汇率调用示例Tool: XERO_CREATE_PAYMENT Arguments: InvoiceID: a1b2c3d4-e5f6-7890-abcd-ef1234567890 AccountID: b2c3d4e5-f6a7-8901-bcde-f12345678901 Amount: 1500.00 Date: 2026-02-11 Reference: Payment for INV-0042实战要点InvoiceID与AccountID均为 UUID 格式应分别通过XERO_LIST_INVOICES与XERO_LIST_ACCOUNTS或银行账户列表预先解析获得切忌凭空编造。外币场景务必传入CurrencyRate否则 Xero 可能按默认汇率处理导致对账偏差。核心工作流四创建银行交易银行交易Bank Transaction用于登记资金流出SPEND付款出去与资金流入RECEIVE收进来是日常记账最常用的动作之一。工具与参数工具XERO_CREATE_BANK_TRANSACTION参数必填说明Type✅SPEND支出或RECEIVE收入ContactID✅Xero 联系人 IDBankAccountCode✅科目表中的银行账户代码LineItems✅行项目数组每项包含Description必填描述、UnitAmount必填单价、AccountCode必填分类科目代码、Quantity数量默认 1、TaxType税率类型OUTPUT、INPUT、NONEDate—交易日期格式YYYY-MM-DDReference—交易参考Status—AUTHORISED或DELETEDCurrencyCode—货币代码如USD、EUR调用示例Tool: XERO_CREATE_BANK_TRANSACTION Arguments: Type: SPEND ContactID: a1b2c3d4-e5f6-7890-abcd-ef1234567890 BankAccountCode: 090 LineItems: [ { Description: Office supplies, UnitAmount: 75.00, AccountCode: 429, Quantity: 1, TaxType: INPUT } ] Date: 2026-02-11 Reference: Feb office supplies实战要点科目代码必须真实有效BankAccountCode与行项目内的AccountCode都必须匹配科目表中实际存在的代码。应先调用XERO_LIST_ACCOUNTS获取有效代码清单再构造请求见已知陷阱中的说明。税类型语义INPUT表示进项税采购抵扣、OUTPUT表示销项税销售收取、NONE表示不涉及税。中国等实行增值税的场景需与 Xero 中的税率映射对照。行项目默认数量为 1省略Quantity时按单价全额入账。核心工作流五付款与银行交易的查询对已发生的收款和银行流水进行复核是记账对账闭环的重要一环。工具XERO_LIST_PAYMENTS—— 列出将发票与银行交易关联起来的付款记录XERO_LIST_BANK_TRANSACTIONS—— 列出 SPEND/RECEIVE 银行交易通用参数参数说明whereOData 过滤如Status\AUTHORISED\order排序如Date DESCpage分页页码If-Modified-Since增量更新仅返回该时间戳之后的变更tenant_id组织 ID典型场景对账时用XERO_LIST_PAYMENTS找出已标记付款但状态异常的发票用XERO_LIST_BANK_TRANSACTIONS按日期范围复核银行流水是否与银行对账单一致。两个查询都支持分页与增量参数适合纳入定时对账脚本。核心工作流六科目表与连接信息查看记账分类的正确性依赖科目表多租户路由的正确性依赖连接信息。工具XERO_LIST_ACCOUNTS—— 获取全部科目代码用于给银行交易行项目做分类XERO_GET_CONNECTIONS—— 列出活动的 Xero 租户连接多租户场景的第一步XERO_LIST_ATTACHMENTS—— 列出某实体发票、联系人等上的附件这三个工具虽不直接产生记账分录但分别是选对科目、选对租户、核对凭证附件的前置能力建议在复杂工作流开始时先调用XERO_GET_CONNECTIONS与XERO_LIST_ACCOUNTS建立上下文。典型端到端流程从收款到入账综合以上工作流一个完整的收到客户付款自动化流程可编排为调用XERO_GET_CONNECTIONS确认租户取出tenant_id调用XERO_LIST_INVOICESStatuses: AUTHORISED找到待收款发票取其InvoiceID调用XERO_LIST_ACCOUNTS确认银行账户与科目代码调用XERO_CREATE_PAYMENT将发票与银行账户关联、登记收款如需拆分入账调用XERO_CREATE_BANK_TRANSACTION登记RECEIVE类型的银行流水调用XERO_LIST_PAYMENTS复核付款记录是否生成正确。该编排与仓库中 QuickBooks Automation 的先解析外键 ID → 再创建主记录 → 最后验证推荐执行计划一脉相承体现了 Composio 技能族共同的最佳实践所有外键ContactID、AccountID、AccountCode都必须先经查询工具解析再用于写操作。已知陷阱与避坑指南下表汇总了原文档列出的六大高频问题务必在编写工作流时逐一规避陷阱详情多租户路由省略tenant_id时默认使用第一个已连接租户。管理多个组织时务必先用XERO_GET_CONNECTIONS核对当前租户避免把账记到错误的公司。高流量账户的过滤被拒在数据量大的账户上某些where过滤如IsCustomer、IsSupplier可能被 Xero 拒绝。回退方案改用searchTerm 分页。OData 过滤语法必须使用双等号例如StatusAUTHORISED写成单等号会报错。这是 Xero API 的 OData 风格约定。必须分页大多数列表端点都会分页返回。务必检查响应中是否还有下一页并持续拉取直到取完全部数据否则会遗漏记录。日期格式所有日期必须是YYYY-MM-DD格式If-Modified-Since时间戳必须是完整的 ISO 8601 UTC 日期时间。银行科目代码有效性银行交易中的BankAccountCode必须匹配科目表中真实存在的代码。用XERO_LIST_ACCOUNTS先发现有效代码再构造请求。补充建议结合 composio-automation 技能 的通用陷阱提示执行任何 Xero 工具前建议先通过RUBE_SEARCH_TOOLS获取最新工具 schema避免因工具参数结构变更导致调用失败工作流内复用同一个 session ID新工作流再生成新 session。工具速查表工具 Slug用途XERO_LIST_INVOICES带过滤与分页地列出发票XERO_GET_CONTACTS检索与查询联系人XERO_CREATE_PAYMENT创建付款将发票关联到银行账户XERO_CREATE_BANK_TRANSACTION登记一笔 SPEND 或 RECEIVE 银行交易XERO_LIST_PAYMENTS列出付款记录XERO_LIST_BANK_TRANSACTIONS列出银行交易XERO_LIST_ACCOUNTS获取科目表XERO_GET_CONNECTIONS列出活动的 Xero 租户连接XERO_LIST_ATTACHMENTS列出某实体上的附件这 9 个工具覆盖了读发票/联系人/付款/银行流水/科目表→ 写付款/银行交易→ 查连接/附件的完整记账闭环足以支撑应收管理、应付登记、银行对账、多组织记账等常见小企业场景。结语Xero Automation 技能通过 Rube MCP 把 Xero 的记账能力封装成一组语义清晰、参数规范的XERO_*工具配合技能自身的 OData 过滤、分页、多租户与增量同步约定可以让 Codex 在对话中直接完成从发票查询到收款入账的完整记账操作。使用时的三条主线值得牢记先连接Rube MCP RUBE_MANAGE_CONNECTIONSXERO_GET_CONNECTIONS→ 再解析外键ContactID、AccountID、AccountCode→ 最后写入并复核创建后用 List 类工具验证。把握好这三点即可在 Xero 云端记账场景中稳定复用该技能并与仓库中其他 Composio 会计类技能协同构建完整的 AI 记账自动化体系。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 用 Rube MCP 驱动 Xero 记账自动化：awesome-codex-skills 中 Xero Automation 技能全解析
用 Rube MCP 驱动 Xero 记账自动化awesome-codex-skills 中 Xero Automation 技能全解析【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills本文系统讲解 awesome-codex-skills 仓库中 Xero Automation 技能 的完整用法如何在 Codex 会话中通过 Rube MCP 服务器连接 Xero 云端会计软件自动化处理发票查询、联系人管理、收款登记、银行交易记账、科目表Chart of Accounts查看等多租户记账工作流。读完本文你将掌握该技能的连接配置、9 个核心工具的参数语义与调用格式以及多租户路由、OData 过滤语法、分页等关键实战避坑点可直接在小企业记账场景中落地使用。技能定位面向小企业记账的 Xero 自动化指令包Xero 是面向小型企业的云端会计平台涵盖发票、联系人、付款、银行交易与科目表等核心记账对象。在 awesome-codex-skills 的composio-skills目录下每个子目录对应一个由 Composio 提供的自动化技能Xero Automation 正是其中专注于会计记账场景的一个。该技能的元数据定义在文件头部的 YAML frontmatter 中composio-skills/xero-automation/SKILL.md--- name: Xero Automation description: Xero Automation: manage invoices, contacts, payments, bank transactions, and accounts in Xero for cloud-based bookkeeping requires: mcp: [rube] ---这段元数据的含义是技能名称为Xero Automationdescription声明其能力范围——管理发票、联系人、付款、银行交易与账户用于云端记账requires.mcp声明它依赖名为rube的 MCP 服务器。Codex 正是依据description来判断何时自动触发该技能参见仓库 README.md 对 Codex Skills 触发机制的说明因此描述中精准写明记账/发票/银行交易等关键词便于 Agent 在相关请求出现时自动命中。该技能与仓库中同目录下的其他 Composio 技能如 QuickBooks Automation、FreshBooks Automation共用同一套 Rube MCP 基础设施但工具集与参数体系各自针对 Xero 的 API 模型定制本文聚焦 Xero 部分。环境准备连接 Rube MCP 与 Xero 租户第一步挂载 Rube MCP 服务器执行任何 Xero 工具之前必须先让 Codex 会话可用 Rube MCP 服务器其端点地址为https://rube.app/mcp。从仓库中同族的 composio-automation 技能 可知Rube 的接入方式是将其添加为客户端配置中的 MCP server无需 API Key——添加端点即可工作。挂载后会话中会出现RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL等一组 Rube 工具它们是对底层 1000 集成能力含 Xero的统一入口。第二步建立 Xero toolkit 连接在调用任何XERO_*工具前必须确认存在xerotoolkit 的活动连接若尚无连接通过RUBE_MANAGE_CONNECTIONS指定 toolkit 为xero发起连接流程按照返回的认证链接完成 Xero 账户授权OAuth 流程由 Rube 托管确认连接状态为 ACTIVE 后再执行工作流。第三步多租户确认可选但重要若你同时管理多个 Xero 组织org / tenant需先调用XERO_GET_CONNECTIONS列出当前活动的租户连接取出正确的tenant_id供后续所有工具调用使用。快速自检清单Rube MCP 已挂载 →RUBE_SEARCH_TOOLS可响应 →RUBE_MANAGE_CONNECTIONS中xero连接为 ACTIVE → 多租户场景下已用XERO_GET_CONNECTIONS锁定tenant_id。技能安装可选若希望将该技能安装到本地 Codex 环境可参照仓库提供的 skill-installer 技能 使用其脚本python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/xero-automation安装后重启 Codex 以加载新元数据参见 README.md 的安装说明。核心工作流一发票的查询与过滤工具与参数工具XERO_LIST_INVOICES参数说明Statuses逗号分隔的状态过滤取值DRAFT、SUBMITTED、AUTHORISED、PAIDContactIDs逗号分隔的 Contact ID 列表按联系人过滤InvoiceIDs逗号分隔的 Invoice ID 列表按发票 ID 过滤whereOData 风格过滤表达式如Status\AUTHORISED\ AND Total100order排序表达式如Date DESC、InvoiceNumber ASCpage分页页码If-Modified-SinceUTC 时间戳仅返回该时间之后被修改过的发票增量同步tenant_idXero 组织 ID省略时默认使用第一个租户调用示例Tool: XERO_LIST_INVOICES Arguments: Statuses: AUTHORISED,PAID order: Date DESC page: 1实战要点状态过滤是最高频用法例如应收账龄分析时通常需要先取AUTHORISED已确认待收与PAID已收款状态的发票。增量同步周期性任务如每日同步应记录上次运行时间并传入If-Modified-Since只拉取增量数据避免全量重复拉取。多条件组合where可与Statuses、order、page叠加使用注意where中字符串值须用转义双引号包裹见后文已知陷阱。核心工作流二联系人的检索与管理联系人Contact是发票、银行交易等对象的外键基础先检索出正确的ContactID是后续记账的前提。工具与参数工具XERO_GET_CONTACTS参数说明searchTerm不区分大小写的搜索词覆盖 Name、FirstName、LastName、Email、ContactNumber 字段ContactID按 ID 获取单个联系人whereOData 过滤如ContactStatus\ACTIVE\page/pageSize分页控制order排序如UpdatedDateUTC DESCincludeArchived设为true时包含已归档联系人summaryOnly设为true时返回轻量响应减少负载调用示例Tool: XERO_GET_CONTACTS Arguments: searchTerm: acme page: 1 pageSize: 25实战要点优先用searchTerm而非复杂where原文档特别提示在高流量数据量大的账户上某些where过滤条件如IsCustomer、IsSupplier可能被 Xero 拒绝此时应回退到searchTerm 分页。summaryOnly优化性能仅需确认联系人存在或获取 ID 列表时开启轻量模式可显著减少响应体积适合大批量核对场景。核心工作流三创建付款记录付款Payment将发票与银行账户关联起来是客户付了钱这一记账动作的落点。工具与参数工具XERO_CREATE_PAYMENT参数必填说明InvoiceID✅付款所对应的 Xero 发票 IDAccountID✅收款银行账户 IDAmount✅付款金额数字类型Date—付款日期格式YYYY-MM-DDReference—付款参考或描述CurrencyRate—外币付款时的汇率调用示例Tool: XERO_CREATE_PAYMENT Arguments: InvoiceID: a1b2c3d4-e5f6-7890-abcd-ef1234567890 AccountID: b2c3d4e5-f6a7-8901-bcde-f12345678901 Amount: 1500.00 Date: 2026-02-11 Reference: Payment for INV-0042实战要点InvoiceID与AccountID均为 UUID 格式应分别通过XERO_LIST_INVOICES与XERO_LIST_ACCOUNTS或银行账户列表预先解析获得切忌凭空编造。外币场景务必传入CurrencyRate否则 Xero 可能按默认汇率处理导致对账偏差。核心工作流四创建银行交易银行交易Bank Transaction用于登记资金流出SPEND付款出去与资金流入RECEIVE收进来是日常记账最常用的动作之一。工具与参数工具XERO_CREATE_BANK_TRANSACTION参数必填说明Type✅SPEND支出或RECEIVE收入ContactID✅Xero 联系人 IDBankAccountCode✅科目表中的银行账户代码LineItems✅行项目数组每项包含Description必填描述、UnitAmount必填单价、AccountCode必填分类科目代码、Quantity数量默认 1、TaxType税率类型OUTPUT、INPUT、NONEDate—交易日期格式YYYY-MM-DDReference—交易参考Status—AUTHORISED或DELETEDCurrencyCode—货币代码如USD、EUR调用示例Tool: XERO_CREATE_BANK_TRANSACTION Arguments: Type: SPEND ContactID: a1b2c3d4-e5f6-7890-abcd-ef1234567890 BankAccountCode: 090 LineItems: [ { Description: Office supplies, UnitAmount: 75.00, AccountCode: 429, Quantity: 1, TaxType: INPUT } ] Date: 2026-02-11 Reference: Feb office supplies实战要点科目代码必须真实有效BankAccountCode与行项目内的AccountCode都必须匹配科目表中实际存在的代码。应先调用XERO_LIST_ACCOUNTS获取有效代码清单再构造请求见已知陷阱中的说明。税类型语义INPUT表示进项税采购抵扣、OUTPUT表示销项税销售收取、NONE表示不涉及税。中国等实行增值税的场景需与 Xero 中的税率映射对照。行项目默认数量为 1省略Quantity时按单价全额入账。核心工作流五付款与银行交易的查询对已发生的收款和银行流水进行复核是记账对账闭环的重要一环。工具XERO_LIST_PAYMENTS—— 列出将发票与银行交易关联起来的付款记录XERO_LIST_BANK_TRANSACTIONS—— 列出 SPEND/RECEIVE 银行交易通用参数参数说明whereOData 过滤如Status\AUTHORISED\order排序如Date DESCpage分页页码If-Modified-Since增量更新仅返回该时间戳之后的变更tenant_id组织 ID典型场景对账时用XERO_LIST_PAYMENTS找出已标记付款但状态异常的发票用XERO_LIST_BANK_TRANSACTIONS按日期范围复核银行流水是否与银行对账单一致。两个查询都支持分页与增量参数适合纳入定时对账脚本。核心工作流六科目表与连接信息查看记账分类的正确性依赖科目表多租户路由的正确性依赖连接信息。工具XERO_LIST_ACCOUNTS—— 获取全部科目代码用于给银行交易行项目做分类XERO_GET_CONNECTIONS—— 列出活动的 Xero 租户连接多租户场景的第一步XERO_LIST_ATTACHMENTS—— 列出某实体发票、联系人等上的附件这三个工具虽不直接产生记账分录但分别是选对科目、选对租户、核对凭证附件的前置能力建议在复杂工作流开始时先调用XERO_GET_CONNECTIONS与XERO_LIST_ACCOUNTS建立上下文。典型端到端流程从收款到入账综合以上工作流一个完整的收到客户付款自动化流程可编排为调用XERO_GET_CONNECTIONS确认租户取出tenant_id调用XERO_LIST_INVOICESStatuses: AUTHORISED找到待收款发票取其InvoiceID调用XERO_LIST_ACCOUNTS确认银行账户与科目代码调用XERO_CREATE_PAYMENT将发票与银行账户关联、登记收款如需拆分入账调用XERO_CREATE_BANK_TRANSACTION登记RECEIVE类型的银行流水调用XERO_LIST_PAYMENTS复核付款记录是否生成正确。该编排与仓库中 QuickBooks Automation 的先解析外键 ID → 再创建主记录 → 最后验证推荐执行计划一脉相承体现了 Composio 技能族共同的最佳实践所有外键ContactID、AccountID、AccountCode都必须先经查询工具解析再用于写操作。已知陷阱与避坑指南下表汇总了原文档列出的六大高频问题务必在编写工作流时逐一规避陷阱详情多租户路由省略tenant_id时默认使用第一个已连接租户。管理多个组织时务必先用XERO_GET_CONNECTIONS核对当前租户避免把账记到错误的公司。高流量账户的过滤被拒在数据量大的账户上某些where过滤如IsCustomer、IsSupplier可能被 Xero 拒绝。回退方案改用searchTerm 分页。OData 过滤语法必须使用双等号例如StatusAUTHORISED写成单等号会报错。这是 Xero API 的 OData 风格约定。必须分页大多数列表端点都会分页返回。务必检查响应中是否还有下一页并持续拉取直到取完全部数据否则会遗漏记录。日期格式所有日期必须是YYYY-MM-DD格式If-Modified-Since时间戳必须是完整的 ISO 8601 UTC 日期时间。银行科目代码有效性银行交易中的BankAccountCode必须匹配科目表中真实存在的代码。用XERO_LIST_ACCOUNTS先发现有效代码再构造请求。补充建议结合 composio-automation 技能 的通用陷阱提示执行任何 Xero 工具前建议先通过RUBE_SEARCH_TOOLS获取最新工具 schema避免因工具参数结构变更导致调用失败工作流内复用同一个 session ID新工作流再生成新 session。工具速查表工具 Slug用途XERO_LIST_INVOICES带过滤与分页地列出发票XERO_GET_CONTACTS检索与查询联系人XERO_CREATE_PAYMENT创建付款将发票关联到银行账户XERO_CREATE_BANK_TRANSACTION登记一笔 SPEND 或 RECEIVE 银行交易XERO_LIST_PAYMENTS列出付款记录XERO_LIST_BANK_TRANSACTIONS列出银行交易XERO_LIST_ACCOUNTS获取科目表XERO_GET_CONNECTIONS列出活动的 Xero 租户连接XERO_LIST_ATTACHMENTS列出某实体上的附件这 9 个工具覆盖了读发票/联系人/付款/银行流水/科目表→ 写付款/银行交易→ 查连接/附件的完整记账闭环足以支撑应收管理、应付登记、银行对账、多组织记账等常见小企业场景。结语Xero Automation 技能通过 Rube MCP 把 Xero 的记账能力封装成一组语义清晰、参数规范的XERO_*工具配合技能自身的 OData 过滤、分页、多租户与增量同步约定可以让 Codex 在对话中直接完成从发票查询到收款入账的完整记账操作。使用时的三条主线值得牢记先连接Rube MCP RUBE_MANAGE_CONNECTIONSXERO_GET_CONNECTIONS→ 再解析外键ContactID、AccountID、AccountCode→ 最后写入并复核创建后用 List 类工具验证。把握好这三点即可在 Xero 云端记账场景中稳定复用该技能并与仓库中其他 Composio 会计类技能协同构建完整的 AI 记账自动化体系。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考