← 返回 Skills 市场
mayafans

Xyfcli Order Guide

作者 mayafans · GitHub ↗ · v1.4.4 · MIT-0
cross-platform ⚠ suspicious
454
总下载
0
收藏
1
当前安装
15
版本数
在 OpenClaw 中安装
/install xyfcli-order-guide
功能描述
肥料订单下单与客户/供应商管理技能。使用 xyfcli CLI 执行:(1) 下单/订货/采购肥料;(2) 查询产品信息/价格/库存;(3) 查询客户/供应商/经销商信息;(4) 解析订货单图片。触发词:下单、订货、买肥料、查产品、查客户、供应商信息、产品列表、客户编码。
安全使用建议
Plain-language checklist before installing or running this skill: - The skill uses an external CLI named 'xyfcli' (declared requirement). The repository actually includes a full Python implementation of that CLI, but there is no automated install step — the README shows a manual install command. Don’t assume the CLI is already installed; installing the bundled code will run user-owned code on your machine. - Installing or importing the bundled CLI will create a ~/.xyfcli/config.json file (the code writes a default config if missing). That file will hold the API base URL and any authorization token you set. Only set the token if you trust the backend and know which endpoint you are targeting. - Default API base is http://127.0.0.1:8000 in the sources; if you change base_url to a remote server, the CLI will send requests (and the token) to that server. Make sure the base_url points to a trusted internal system before setting the token. - The skill’s runtime instructions and code appear focused on legitimate ordering tasks and do not request unrelated secrets, but because the skill can talk to an API and persist a token, review the included code (api_client/config/order/shop) yourself or ask an administrator to do so before installing. - If you want minimal risk: do not install the bundled CLI; instead verify you have an existing trusted 'xyfcli' binary from a vetted source, or ask the skill author/maintainer for an official installation package or signed release. Also, confirm whether the agent will be allowed to autonomously invoke the skill (default = permitted); if you’re concerned about accidental automated orders, restrict autonomous invocation until you’ve tested it in a safe environment. If you want, I can list the exact files and code locations you should inspect (e.g., where the config is created and where HTTP endpoints are called) or produce a short step-by-step safe-install checklist.
功能分析
Type: OpenClaw Skill Name: xyfcli-order-guide Version: 1.4.4 The skill bundle provides a legitimate CLI tool (xyfcli) and agent instructions for managing fertilizer orders, customer data, and delivery addresses. The Python code (scripts/xyfcli/) is a standard implementation using Typer and HTTPX to interact with a business API, with configuration stored locally in ~/.xyfcli/config.json. The SKILL.md instructions are well-structured, focusing on business logic and user experience, and specifically include a mandatory confirmation step (Phase 3) before executing the final order placement command, which serves as a safeguard against unauthorized actions.
能力评估
Purpose & Capability
Name/description match the actual behavior: the skill drives an xyfcli command-line client to query products, customers, addresses and place orders. Declared requirement (binary 'xyfcli') is appropriate. However, the package also includes a full xyfcli Python implementation in the skill bundle but provides no install spec — this mismatch (instruction-only metadata vs included code) is unexpected and should be clarified.
Instruction Scope
SKILL.md instructs only domain-relevant actions (running xyfcli commands, OCR of order images, queries and validations). It does not instruct reading unrelated system files or unrelated credentials. The guides explicitly require confirmation before placing orders.
Install Mechanism
No install spec is declared (instruction-only), which minimizes automated installation risk. But the skill bundle contains a complete Python CLI (pyproject.toml, package source, README with manual install steps). That means a user or operator will likely run a manual install command to get the 'xyfcli' binary — the install step is not automated and is left to the user. This inconsistency increases operational risk because users may unknowingly install bundled code.
Credentials
The skill declares no required env vars and only requires the xyfcli binary. The included CLI stores API base URL and an authorization token in ~/.xyfcli/config.json; it will ask the user to set a token to communicate with the backend. Storing a token locally and allowing an arbitrary base_url is expected for this use case but means the token and base URL choice are sensitive — if an attacker or misconfigured base_url is used the CLI could send data to an arbitrary endpoint.
Persistence & Privilege
The skill does not request always:true and does not ask to modify other skills. However, the included Python code (api_client/config) will create a ~/.xyfcli directory and write a default config.json if the config is missing (side-effect at import). This is persistent filesystem activity that users should be aware of before installing/ importing the bundled CLI.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install xyfcli-order-guide
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /xyfcli-order-guide 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.4.4
xyfcli-order-guide 1.4.4 - 新增了“下单时指定承运人信息”的能力,包括承运人姓名、车牌号与电话。 - 能力清单和首次引导语中补充了承运人相关功能。 - 全部输入模式下单流程支持收集和提交承运车主、车牌号、车主电话等字段。 - CLI 调用策略调整:可选参数收集到就应传入,严格对齐收集信息与参数传递。 - 文档细节优化:用词更精确,新增/修改处标明承运人信息流程与字段。
v1.4.3
更新技能文件并发布 v1.4.3
v1.4.2
重新安装并发布 v1.4.2
v1.4.1
xyfcli-order-guide v1.4.1 - 支持客户收货地址的新增、修改与验证,完善下单地址流程 - 地址ID、收货人、电话等信息现在作为必填项,系统可自动提取默认值并引导确认 - “单订单一收货地址/发货基地/提货方式”约束明确,检测多组信息需拆单 - 新增发货基地库存与子公司查询指引,完善相关CLI用法 - 优化交互文案,所有操作及选项提示更清晰;补充运输与提货方式的规范选项与映射 - 更新错误提示与流程,遇到缺失地址可直接通过CLI新增或修改,无需跳转其他系统
v1.4.0
发布 v1.4.0 版本
v1.3.0
优化触发条件描述,完善交互式工作流程,增加错误处理示例和输出格式规范
v1.0.6
优化下单流程
v1.2.0
xyfcli-order-guide 1.2.0 - 优化“OpenClaw处理原则”和引导规范,强调提示必须完整清晰、结果展示精确。 - 增补“OpenClaw工作原则”说明,突出领导交代场景与用户输入精简。 - 修改订单确认展示细节,提升订单信息完整度及确认体验。 - 文档内容进一步聚焦实用性指引,强化操作流程说明。
v1.1.0
精简下单流程:一句话交代任务,自动验证下单。支持完整信息、部分信息、搜索式、订货单四种模式。
v1.0.5
新增订货单下单流程
v1.0.4
更新SKILL.md
v1.0.3
移除默认Token,要求用户自行配置
v1.0.2
添加安全说明注释
v1.0.1
添加安装和Token配置指南
v1.0.0
Initial release
元数据
Slug xyfcli-order-guide
版本 1.4.4
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 15
常见问题

Xyfcli Order Guide 是什么?

肥料订单下单与客户/供应商管理技能。使用 xyfcli CLI 执行:(1) 下单/订货/采购肥料;(2) 查询产品信息/价格/库存;(3) 查询客户/供应商/经销商信息;(4) 解析订货单图片。触发词:下单、订货、买肥料、查产品、查客户、供应商信息、产品列表、客户编码。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 454 次。

如何安装 Xyfcli Order Guide?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install xyfcli-order-guide」即可一键安装,无需额外配置。

Xyfcli Order Guide 是免费的吗?

是的,Xyfcli Order Guide 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Xyfcli Order Guide 支持哪些平台?

Xyfcli Order Guide 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Xyfcli Order Guide?

由 mayafans(@mayafans)开发并维护,当前版本 v1.4.4。

💬 留言讨论