loyverse-automation

loyverse-automation skill 概览

loyverse-automation 能做什么

loyverse-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 自动化 Loyverse 销售点（point-of-sale）相关操作。它不会让 agent 猜测 API 字段，也不会硬编码可能过期的 schema；相反，这个 skill 会要求 agent 先用 RUBE_SEARCH_TOOLS 发现当前可用的 Loyverse tools，再用 RUBE_MANAGE_CONNECTIONS 验证 Loyverse 连接，随后执行合适的 Rube tool calls。

因此，当你希望 AI agent 协助处理 Loyverse 运营任务，同时保持与实时 Composio tool schema 一致时，loyverse-automation skill 最有价值。

适合的用户与工作流

如果你正在处理 Loyverse 数据，并希望 Claude 帮你触发或规划 Composio Loyverse toolkit 暴露的 store、item、inventory、receipt、customer、employee 或 POS 相关工作流，可以使用 loyverse-automation。它适合门店运营人员、自动化搭建者、no-code/low-code 团队，以及已经使用支持 MCP 的 AI client 的开发者。

它真正要解决的问题不是“编写 Loyverse API 代码”，而是：“针对一个具体的 Loyverse 业务任务，安全、正确地使用当前可用的 Rube MCP tools。”

关键采用前提

核心依赖是 Rube MCP。你的 client 必须已经配置 MCP server https://rube.app/mcp，RUBE_SEARCH_TOOLS 必须可用，并且必须通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit loyverse 激活 Loyverse 连接。

如果你的 AI client 无法使用 MCP tools，或者你需要完全离线的自动化，这个 skill 并不适合。

如何使用 loyverse-automation skill

loyverse-automation 安装与设置

使用以下命令从 repository 安装 skill：

npx skills add ComposioHQ/awesome-claude-skills --skill loyverse-automation

然后在你的 client 中添加 Rube MCP：

https://rube.app/mcp

在请求任何 Loyverse 操作之前，先确认以下事项：

1. RUBE_SEARCH_TOOLS 能在你的 client 中正常响应。
2. RUBE_MANAGE_CONNECTIONS 可以检查 toolkit loyverse。
3. Loyverse 连接状态为 ACTIVE。
4. 如果连接未激活，按照返回的 authorization link 完成授权，然后重新检查状态。

这个 skill 在 repo path 下只有 SKILL.md，所以应先阅读该文件。它没有附带 scripts、examples 或 reference folders 可供依赖；实时的 Rube tool discovery 步骤才是事实来源。

如何更有效地提示 loyverse-automation skill

一个较弱的 prompt 是：

Automate Loyverse inventory.

更适合 loyverse-automation 使用场景的 prompt 是：

Use the loyverse-automation skill. First search Rube tools for current Loyverse inventory-related schemas. Check that the Loyverse connection is active. Then identify the safest tool plan to update stock for item SKU ABC-123 at store Downtown to quantity 25. Show the tool slug, required fields, assumptions, and ask before executing any write operation.

这样效果更好，因为它包含了业务对象、标识符、目标操作、门店位置上下文、安全要求，以及执行边界。

对于只读任务，也要明确说明：

Use loyverse-automation to retrieve recent Loyverse receipts for the last 7 days. Discover tools first, use the active Loyverse connection, and return a table with receipt number, date, total, payment type, and customer if available.

推荐的工作流模式

可靠的 loyverse-automation 使用方式通常遵循以下顺序：

1. 发现 tools：使用 RUBE_SEARCH_TOOLS，并围绕你的具体用例查询，而不是使用泛泛的关键词。
2. 检查 schemas：重点查看 Rube 返回的 required fields、identifiers、date formats 和 pagination。
3. 检查连接：使用 RUBE_MANAGE_CONNECTIONS 检查 toolkit loyverse。
4. 先规划再执行：尤其是 create、update、delete 或 bulk changes。
5. 运行选定的 tool：只有当输入与发现到的 schema 匹配后再执行。
6. 验证结果：检查返回的 IDs、status fields、errors，或通过后续 read operations 复核。

这个模式很重要，因为 Loyverse 和 Composio 的 tool schemas 可能变化。这个 skill 的核心差异点，就是在执行前强制进行 discovery。

获得更好输出的实用技巧

提前告诉 agent 运营约束：它是否可以执行写入操作、是否需要审批、如何处理缺失记录、哪些 store 或 terminal 上下文重要，以及如何报告部分失败。

对于 bulk work，先提供一个小样本。要求 agent 在运行完整任务前，先把你的列映射到发现到的 Rube schema。例如，如果你提供一份 item updates 的 CSV，可以要求它先 dry-run 映射 sku、item_name、variant、store 和 quantity 到 RUBE_SEARCH_TOOLS 返回的字段。

loyverse-automation skill FAQ

loyverse-automation 只适合开发者吗？

不是。如果 MCP client 和 Loyverse 连接已经配置好，非开发者也可以使用这个 skill。不过，仍然需要有人完成 Rube MCP 设置，并批准 Loyverse authorization flow。新手应先从只读检索任务开始，再尝试更新操作。

它相比普通 Loyverse prompt 好在哪里？

普通 prompt 可能会编造 API 字段，或依赖过时的假设。loyverse-automation skill 明确要求在执行前通过 Rube MCP 进行实时 tool discovery。这样 agent 可以拿到当前的 tool slugs、schemas、execution plans 和潜在注意点，从而减少猜测和失败的 tool calls。

什么时候不应该使用这个 skill？

如果你需要的是不通过 MCP 的直接 Loyverse API 代码生成、你的 AI client 无法调用 Rube tools，或者你的组织禁止 AI 辅助访问 POS 数据，就不应使用它。对于高风险的 bulk updates，如果你无法先审阅计划、用小样本测试并在之后验证结果，也应避免使用。

loyverse-automation 对 Workflow Automation 有什么帮助？

在 Workflow Automation 场景中，它可以把自然语言业务请求转化为 tool-driven sequence：发现 Loyverse tools、验证连接、执行选定操作，并汇总结果。它最适合 agentic workflows，尤其是在当前 schemas 和 connection state 比静态 API 示例更重要的场景中。

如何改进 loyverse-automation skill

用完整上下文改进 loyverse-automation prompts

质量提升最大的一点，是把任务说明得更清楚。请包含：

• 目标对象：item、receipt、customer、store、employee、inventory、modifier 或 payment data
• 操作：retrieve、create、update、sync、compare、export 或 validate
• 标识符：SKU、item ID、receipt number、customer email、store name、date range
• 权限：read-only、先生成 draft plan，或确认后执行
• 输出格式：table、JSON、checklist、exception report 或 summary

这能帮助 agent 选择更精准的 RUBE_SEARCH_TOOLS 查询，避免宽泛、低信号的 discovery。

注意常见失败模式

常见问题包括 Loyverse 连接未激活、缺少 store 或 item 标识符、date range 含糊、bulk updates 没有 dry runs，以及在 schema discovery 之前假设字段名。另一个失败模式，是只让 agent “just do it”，却没有说明它是否可以执行写入操作。

为了获得更安全的结果，应要求 agent 在执行前展示发现到的 tool slug 和 required fields。

首次输出后继续迭代

第一次运行后，可以通过这些问题改进工作流：

• 哪些 required fields 缺失？
• 哪些 records 无法被高置信度匹配？
• 是否有结果被 paginated 或 truncated？
• 应该用哪个 validation call 来确认变更？
• 这个流程能否转化为可重复使用的 checklist？

这样可以把一次性的 Loyverse 任务，变成可复用的自动化模式。

负责任地扩展这个 skill

如果你要定制这个 skill，可以为最常见的 Loyverse 操作添加 examples，例如 inventory adjustment、receipt export、customer lookup 或 item synchronization。保留先调用 RUBE_SEARCH_TOOLS 的指令；删除它会削弱这个 skill 最主要的安全性和准确性优势。针对 bulk writes、financial data 和 customer information，加入你所在组织的专属审批规则。