Awesome Codex Skills 实战：用 Zoho Books Automation 技能以自然语言驱动发票、账单与收款全流程

Awesome Codex Skills 实战用 Zoho Books 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 中的 Zoho Books Automation 技能 为核心讲解如何借助 Rube MCP 网关与 Composio 的 Zoho Books 工具集在 Codex CLI/API 会话中通过自然语言完成组织发现、发票创建与管理、账单跟踪、联系人查找、收款核对及批量 PDF 导出等会计工作流。读完本文你将掌握该技能的全部工具调用参数、端到端开票流水线以及实战中容易踩坑的关键细节。一、技能定位让 Codex 拥有会记账的能力在 Awesome Codex Skills 仓库中技能Skill是以SKILL.md为载体的模块化指令包文件头部的 YAML frontmatter 记录技能的name与descriptionCodex 依据description判断何时触发技能触发后才加载正文从而保持上下文精简参见 README.md 的 What Are Codex Skills? 一节。本技能 composio-skills/zoho-books-automation/SKILL.md 的 frontmatter 声明如下--- name: Zoho Books Automation description: Automate Zoho Books accounting workflows including invoice creation, bill management, contact lookup, payment tracking, and multi-organization support through natural language commands requires: mcp: - rube ---关键信息有三点nameZoho Books Automation即技能的标识名。description声明技能覆盖的会计能力边界——发票创建、账单管理、联系人查找、收款跟踪、多组织支持全部通过自然语言命令完成。这也是 Codex 自动触发该技能的依据。requires.mcp声明运行前置条件——需要名为rube的 MCP 服务器即 Rube MCP 网关端点https://rube.app/mcp。Rube 是技能与 Composio 1000 集成之间的桥梁Codex 通过 Rube 暴露的工具tool slug间接调用 Composio 托管的 Zoho Books 连接器认证、授权与 API 转发均由网关侧处理。因此整个自动化的调用链可以概括为自然语言 → Codex → Rube MCP工具发现与执行→ Composio Zoho Books 工具集 → Zoho Books 云端 API。二、环境准备安装技能并完成 Zoho Books 连接2.1 将技能安装进 Codex按照 README.md 的 Quickstart 章节有两种安装方式方式一使用 Skill Installer推荐git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/zoho-books-automation安装脚本会将技能放置到$CODEX_HOME/skills/skill-name默认~/.codex/skills然后重启 Codex 以加载新元数据。方式二手动复制将composio-skills/zoho-books-automation/整个目录复制到$CODEX_HOME/skills/重启 Codex在会话中自然描述任务或直接提及技能名Codex 会根据 frontmatter 的description匹配触发。安装完成后可用ls ~/.codex/skills和head ~/.codex/skills/skill/SKILL.md验证。2.2 添加 Rube MCP 服务器并连接 Zoho Books技能源文档给出的 Setup 共三步添加 Rube MCP 服务器在 Codex 的 MCP 配置中添加端点https://rube.app/mcp。连接 Zoho Books 账户按提示完成 Composio 侧的 OAuth 授权流程。开始下发自然语言命令。同系列技能 composio-skills/zoho_books-automation/SKILL.md 对连接环节补充了更严格的检查步骤值得在实际使用时对照执行先调用RUBE_SEARCH_TOOLS确认 Rube MCP 已可用调用RUBE_MANAGE_CONNECTIONS并传入 toolkit 标识zoho_books若连接状态不是ACTIVE则按返回的授权链接完成设置确认连接状态为ACTIVE后再运行任何工作流。OAuth 令牌过期后需重新授权。注意连接粒度是账户 组织。同一 Zoho 账户下可能挂载多个组织Organization下文工作流一就是解决选哪个组织的问题。三、先理解 Rube MCP 的执行原语工具发现优于硬编码虽然本技能文档直接给出了具体的工具 slug如ZOHO_BOOKS_CREATE_INVOICE但从 composio-skills/zoho_books-automation/SKILL.md 的源码结构看Rube 网关实际暴露了一组通用执行原语技能文档中的 slug 是这些原语的业务参数原语用途RUBE_SEARCH_TOOLS按 use case 检索可用工具返回工具 slug、推荐执行计划、已知陷阱与输入 schemaRUBE_MANAGE_CONNECTIONS管理集成连接创建、检查状态、重新授权RUBE_MULTI_EXECUTE_TOOL按 schema 合规参数批量执行工具RUBE_GET_TOOL_SCHEMAS当搜索结果返回schemaRef而非完整input_schema时加载完整输入 schemaRUBE_REMOTE_WORKBENCH在远端工作台批量/并行执行如run_composio_tool()配合线程池推荐执行模式是Search Before Action先RUBE_SEARCH_TOOLS拉取当前工具 schema工具集可能随版本演进硬编码 slug 有失效风险再RUBE_MULTI_EXECUTE_TOOL传参执行。例如RUBE_SEARCH_TOOLS: queries[{use_case: invoices, expenses, contacts, payments, and accounting, known_fields: }]该调用会返回可用工具 slug、推荐执行步骤、已知陷阱与边界情况以及每个工具的输入 schema——这正是下文各工作流参数表的底层来源。四、核心工作流一发现组织一切操作的前置工具ZOHO_BOOKS_LIST_ORGANIZATIONS该工具无需任何参数返回已认证用户可访问的全部组织信息包括组织 ID、名称与元数据。技能文档明确强调始终先调用此工具获取organization_id——几乎其他所有 Zoho Books 工具都需要它。这是因为 Zoho Books 的 API 以组织账套为数据隔离边界发票、账单、联系人、收款都挂在具体组织之下。组织 ID 缺失是实践中最高频的报错原因详见下文陷阱表。示例提示词List my Zoho Books organizations五、核心工作流二创建与管理发票发票模块是本技能参数最丰富的部分共覆盖 6 个工具。5.1 创建发票ZOHO_BOOKS_CREATE_INVOICE关键参数如下参数必填说明organization_id是目标组织customer_id是开票客户line_items是行项目数组每个行项目包含item_id或name引用既有商品或创建临时行项目、quantity、rate数量与单价可选description、tax_id、discountdate/due_date否日期统一使用YYYY-MM-DD格式invoice_number否自定义发票号需设置ignore_auto_number_generationtrue以关闭自动编号discount/discount_type否发票级折扣discount_type取值为entity_level或item_levelnotes/terms否打印在发票上的备注与条款send否创建后是否立即邮件发送该发票payment_terms否付款期限天数注意line_items至少需要一行且每行必须携带item_id或name之一否则创建会失败。示例提示词Create an invoice for customer 1234567890 with 2 line items: 10 units of Widget A at $25 each, and 5 units of Widget B at $50 each, due in 30 days5.2 列出发票ZOHO_BOOKS_LIST_INVOICES参数说明organization_id必填status状态过滤取值sent、draft、overdue、paid、void、unpaid、partially_paid、viewedcustomer_id/customer_name按客户过滤date_start/date_end日期范围过滤YYYY-MM-DDsearch_text按发票号、参考号或客户名搜索sort_column/sort_order排序可依据date、due_date、total、balance等字段page/per_page分页单页上限 200 条文档特别提示ZOHO_BOOKS_LIST_INVOICES存在一个未文档化的response_option参数0完整数据1完整汇总2仅计数该参数可能在没有通知的情况下变更属于不稳定接口使用需谨慎。5.3 获取发票详情ZOHO_BOOKS_GET_INVOICE通过invoice_id获取单张发票accept参数决定返回格式json、pdf或html。其中 PDF 格式适合直接归档或转发。5.4 删除发票ZOHO_BOOKS_DELETE_INVOICE通过invoice_id删除发票。删除是不可逆操作建议先GET_INVOICE核对后再执行。5.5 批量导出 PDFZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF将最多 25 张发票合并导出为单个 PDF 文件适合月末归档或批量对账。5.6 批量打印ZOHO_BOOKS_BULK_PRINT_INVOICES生成最多 25 张发票的合并打印版 PDF与批量导出的区别在于版面按打印需求排版。六、核心工作流三跟踪与管理供应商账单面向应付侧AP的工作流覆盖 3 个工具。6.1 列出账单ZOHO_BOOKS_LIST_BILLS参数说明organization_id必填status取值paid、open、overdue、void、partially_paidvendor_id/vendor_name_contains按供应商过滤bill_number/bill_number_contains按账单号过滤date_start/date_end日期范围过滤total_greater_than/total_less_than金额范围过滤sort_column/sort_order排序可依据vendor_name、bill_number、date、due_date、total等page/per_page分页上限 2006.2 获取账单详情ZOHO_BOOKS_GET_BILL通过bill_id与organization_id获取完整账单。6.3 更新账单ZOHO_BOOKS_UPDATE_BILL修改既有账单即使做局部更新也必须同时提供bill_id、organization_id、vendor_id、bill_number四个字段这是该工具最容易踩的参数坑。示例提示词List all overdue bills for my organization, sorted by due date七、核心工作流四查找联系人客户与供应商工具ZOHO_BOOKS_LIST_CONTACTS联系人是发票客户与账单供应商的公共基础数据建议在创建发票/账单前先用本工具核实 ID。参数说明organization_id必填contact_typecustomer或vendorcontact_name_contains/contact_name_startswith联系人姓名过滤email_contains/email_startswith邮箱过滤company_name_contains公司名过滤filter_by状态过滤Status.Active、Status.Inactive、Status.Duplicate等search_text按联系人名或备注搜索最长 100 字符sort_column排序可依据contact_name、email、outstanding_receivable_amount、created_time等page/per_page分页上限 200示例提示词Find all active customers whose company name contains Acme八、核心工作流五跟踪发票收款工具ZOHO_BOOKS_LIST_INVOICE_PAYMENTS针对单张发票核对已入账收款两个必填参数invoice_id—— 要核对的发票organization_id—— 所属组织。返回该发票的全部已登记付款交易包括金额、日期与付款方式信用卡、银行转账等可用于应收账款核对与逾期催收判断。示例提示词Show all payments recorded against invoice 451025000000123045九、核心工作流六端到端开票流水线将上述工具串联即可形成一条完整的开票管理链路组织ZOHO_BOOKS_LIST_ORGANIZATIONS—— 获取organization_id联系人ZOHO_BOOKS_LIST_CONTACTS—— 查找或核实customer_id创建ZOHO_BOOKS_CREATE_INVOICE—— 携带行项目创建发票复核ZOHO_BOOKS_GET_INVOICE—— 获取发票详情或 PDF 检查内容跟踪ZOHO_BOOKS_LIST_INVOICE_PAYMENTS—— 监控回款状态归档ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF—— 批量导出留档。技能文档给出了一个把多步骤浓缩进单条提示词的示例Find the customer ID for Acme Corp, create an invoice for them with consulting services, and then get the PDFCodex 收到后会按上述依赖顺序自动编排先查组织、再查联系人、创建发票、最后取 PDF。若涉及更复杂的批量场景可参考 composio-skills/zoho_books-automation/SKILL.md 中的建议使用RUBE_REMOTE_WORKBENCH配合run_composio_tool()与线程池做并行执行。十、已知陷阱清单务必逐条核对技能文档总结了 8 条实战高发陷阱原文完整罗列如下陷阱详情Organization ID always required几乎所有端点都需要organization_id——始终先调用ZOHO_BOOKS_LIST_ORGANIZATIONSLine items required for invoicesZOHO_BOOKS_CREATE_INVOICE至少需要一个行项目且行项目须携带item_id或nameInvoice ID format使用发票对象中的数字型invoice_id例如7472322000000264123不要使用invoice_url中的编码 IDBulk limitsZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF与ZOHO_BOOKS_BULK_PRINT_INVOICES均最多接受 25 个发票 IDPagination max 200所有 list 端点单页上限 200 条——需遍历分页才能取全结果Bill update requires all fieldsZOHO_BOOKS_UPDATE_BILL即使做部分更新也要求bill_id、organization_id、vendor_id、bill_number四个字段Date format所有日期参数统一使用YYYY-MM-DD格式response_option undocumentedZOHO_BOOKS_LIST_INVOICES存在未文档化的response_option参数0完整1完整汇总2仅计数可能未经通知即变更结合 Rube 网关的执行特性还可以补充几条同系列技能强调的注意事项连接状态检查执行前确认 Zoho Books 连接为ACTIVEOAuth 令牌过期会直接导致调用失败需通过RUBE_MANAGE_CONNECTIONS重新授权。Schema 合规始终按RUBE_SEARCH_TOOLS/RUBE_GET_TOOL_SCHEMAS返回的最新 schema 传参避免硬编码过期参数。限流退避遇到 rate limit 错误时降低请求频率并实现退避重试。先查后建创建新资源前先搜索是否已存在避免重复数据。十一、工具速查表技能文档末尾给出了全部 12 个工具的一页速查完整继承如下动作工具 Slug关键参数列出组织ZOHO_BOOKS_LIST_ORGANIZATIONS无创建发票ZOHO_BOOKS_CREATE_INVOICEorganization_id、customer_id、line_items列出发票ZOHO_BOOKS_LIST_INVOICESorganization_id、status、date_start获取发票ZOHO_BOOKS_GET_INVOICEinvoice_id、organization_id、accept删除发票ZOHO_BOOKS_DELETE_INVOICEinvoice_id、organization_id批量导出 PDFZOHO_BOOKS_BULK_EXPORT_INVOICES_PDForganization_id、invoice_ids批量打印ZOHO_BOOKS_BULK_PRINT_INVOICESorganization_id、invoice_ids列出账单ZOHO_BOOKS_LIST_BILLSorganization_id、status、vendor_id获取账单ZOHO_BOOKS_GET_BILLbill_id、organization_id更新账单ZOHO_BOOKS_UPDATE_BILLbill_id、organization_id、vendor_id列出联系人ZOHO_BOOKS_LIST_CONTACTSorganization_id、contact_type、search_text列出收款ZOHO_BOOKS_LIST_INVOICE_PAYMENTSinvoice_id、organization_id十二、落地建议与扩展阅读从最小闭环开始首次使用时按工作流一 → 工作流四 → 工作流二的顺序跑通查组织 → 查客户 → 开发票再逐步叠加收款核对与批量导出。把常用流水线固化成提示词模板端到端开票流水线的六步可以封装为一段固定提示词配合 Codex 的自动触发机制形成可复用的日常记账助手。注意技能边界本技能聚焦 Zoho Books 的发票、账单、联系人、收款同仓库的 invoice-organizer 面向发票数据抽取与规整、connect 面向更广泛的 Composio 连接管理可按需组合使用。深入学习入口技能源文档位于 composio-skills/zoho-books-automation/SKILL.md同系列更偏 Rube 网关执行细节的版本见 composio-skills/zoho_books-automation/SKILL.md技能的整体安装与触发机制见 README.md如需自行编写类似技能可参考 template-skill 与 skill-creator。本技能由 Composio 提供技术支撑Toolkit 文档位于 composio.dev 的 zoho_books 页面。在确认连接状态为ACTIVE、牢记先查组织 ID、再按 schema 传参、列表记得翻页三条铁律的前提下Zoho Books 的日常记账工作即可稳定地交给自然语言驱动。【免费下载链接】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），仅供参考