核心能力
xyfcli-order-guide 是一款专为农资行业设计的智能订单管理技能，通过自然语言交互实现肥料采购全流程自动化。该技能深度集成 xyfcli CLI 工具，覆盖从客户查询、产品检索到订单提交的完整业务链条。
显著优点
1. 自然语言驱动的高效交互
- 支持"一句话下单"：用户可用口语化表达完成复杂订单，如"帮吉林市文英化肥经销有限责任公司下26吨Y14002510160020000，吉林新洋丰基地出发..."
- 智能意图识别：自动区分下单、查询、地址管理等7大类业务场景
- 并行验证机制：一次性完成客户、产品、库存、地址等多维度校验，避免反复确认
2. 完善的B端业务支撑
- 产品权限管控：严格验证客户可购买的产品范围，防止越权下单
- 库存实时校验：对接基地库存系统，确保可发货
- 地址生命周期管理：支持查询、新增、修改客户收货地址
- 多产品订单支持：单订单可批量提交多种产品（需满足同一基地/地址/收货人约束）
3. 灵活的输入模式
- 完整信息下单：全参数一句话直达
- 分步引导下单：智能补全缺失信息，一次性展示所有选项
- 图片OCR下单：识别纸质订货单自动录入
- 搜索式浏览：模糊查询产品列表后选择
潜在局限
1. 系统依赖性强
- 必须预装 xyfcli CLI 并配置服务端点与认证令牌
- 完全依赖上游系统的可用性和数据准确性
- 未缓存产品/客户数据，每次操作均实时调用API
2. 业务规则约束严格
- 单订单限制：同一订单必须保持发货基地、收货地址、运输方式、提货方式完全一致，多地址场景需拆单
- 地址强校验：必须使用系统中已保存的地址ID，不支持临时地址
- 产品权限隔离：无法购买未授权产品，无越权下单通道
3. 安全与权限边界
- 以当前登录销售员的权限执行业务，无法跨账号操作
- 所有资金类操作（统派车付款方式）均走原系统流程，本技能仅做入口
适合人群
- 农资企业销售员：需要频繁为客户下单、查库存、管地址
- 经销商业务代表：移动端快速响应客户订货需求
- 区域业务经理：批量查看名下客户列表与账户余额
- 内勤/客服角色：处理纸质订货单的数字化录入
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 误操作风险 | 自然语言解析歧义导致下单信息错误 | 严格执行"确认-提交"二次确认流程 |
| 数据泄露 | 客户列表、余额等敏感信息在对话中暴露 | 建议在企业内网/私有化环境部署 |
| 库存超卖 | 并发场景下库存校验与实际扣减存在时间差 | 依赖上游系统的最终一致性保障 |
| CLI注入 | 用户输入拼接至命令行参数 | xyfcli应对参数做转义处理（需确认）|
技术实现特点
- 命令编排层：将自然语言映射为精确的 xyfcli 子命令序列
- 验证聚合层：并行执行 getsalercode → getdealercode → getproductlist → getstock → getdealeraddresses 等前置校验
- 状态机流转：下单流程采用"解析→验证→确认→执行"四阶段状态机，支持任意阶段回退
使用建议
首次使用建议先执行"查客户列表"建立客户认知，再通过"查产品"熟悉可售商品范围，最后尝试简单单产品订单熟悉完整流程。复杂多产品订单建议参考 workflow_guide.md 了解拆单规则与最佳实践。