用途:通过已配置的 Xero 集成查询会计数据,适用于读取组织、记录与报表等只读场景。
主要能力:发现并使用现有已认证的 Xero 连接器、API 客户端或 CLI,检查其当前 schema、帮助或源码;按用户指定的组织或租户选择匹配标识符;查询记录与报表,并保留现金制与权责发生制、含税与不含税、草稿与已过账记录之间的区别。
使用方式:凭据由已配置客户端或密钥管理器提供,须避免出现在命令参数、日志、项目 .env 文件与示例中;允许客户端自带的令牌刷新与私有令牌缓存,不要复制缓存或创建临时凭据文件。遵循集成的分页与过滤规则,每次请求或进程树通常限制在 30 秒内。直接使用已配置的 API 集成,不要用浏览器抓取替代;直接 API 操作前查阅 Xero 官方开发者文档中的认证流程、租户要求与端点。
限制:本技能不提供私有仓库、账户清单或凭据;若访问缺失,应报告缺少的配置,而不是擅自克隆客户端或启动认证。不要假设默认租户;模糊选择可能改变结果时须先询问。名为“balances”或“report”的命令也可能写入行或同步数据库,运行前须检查行为,优先使用文档化的只读模式。本地同步与远程变更需用户明确请求。报告部分访问、缺失页面与过期缓存数据,不得将部分响应等同于完整账本。凭据与 API 失败仅在证据可区分时分别报告,不要凭沉默猜测或自动重试不确定的写入。返回结果时附组织、期间、币种、会计基础与检索时间,并将合计与返回记录或报表核对,缺口应说明而非估算填补。