← Back to Skills Marketplace
mayafans

Xyfcli Order Guide

by mayafans · GitHub ↗ · v1.4.4 · MIT-0
cross-platform ⚠ suspicious
454
Downloads
0
Stars
1
Active Installs
15
Versions
Install in OpenClaw
/install xyfcli-order-guide
Description
肥料订单下单与客户/供应商管理技能。使用 xyfcli CLI 执行:(1) 下单/订货/采购肥料;(2) 查询产品信息/价格/库存;(3) 查询客户/供应商/经销商信息;(4) 解析订货单图片。触发词:下单、订货、买肥料、查产品、查客户、供应商信息、产品列表、客户编码。
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install xyfcli-order-guide
  3. After installation, invoke the skill by name or use /xyfcli-order-guide
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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
Metadata
Slug xyfcli-order-guide
Version 1.4.4
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 15
Frequently Asked Questions

What is Xyfcli Order Guide?

肥料订单下单与客户/供应商管理技能。使用 xyfcli CLI 执行:(1) 下单/订货/采购肥料;(2) 查询产品信息/价格/库存;(3) 查询客户/供应商/经销商信息;(4) 解析订货单图片。触发词:下单、订货、买肥料、查产品、查客户、供应商信息、产品列表、客户编码。 It is an AI Agent Skill for Claude Code / OpenClaw, with 454 downloads so far.

How do I install Xyfcli Order Guide?

Run "/install xyfcli-order-guide" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Xyfcli Order Guide free?

Yes, Xyfcli Order Guide is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Xyfcli Order Guide support?

Xyfcli Order Guide is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Xyfcli Order Guide?

It is built and maintained by mayafans (@mayafans); the current version is v1.4.4.

💬 Comments