Agent Skills
› NeverSight/learn-skills.dev
› lfy-base
lfy-base
GitHub获取客户编辑场景的基础下拉选项数据,支持客户状态、标签、区域和行业。通过指定property和object_id调用接口,返回id/name列表,用于修改客户信息时的选项选择。
Trigger Scenarios
用户需要获取客户状态可选值
用户需要获取客户标签可选值
用户需要获取客户区域可选值
用户需要获取客户行业可选值
准备修改客户基础信息字段
Install
npx skills add NeverSight/learn-skills.dev --skill lfy-base -g -y
SKILL.md
Frontmatter
{
"name": "lfy-base",
"version": "1.0.4",
"metadata": {
"cliHelp": "lfy-cli base --help",
"requires": {
"bins": [
"lfy-cli"
]
}
},
"description": "客户编辑场景基础数据(下拉选项)。当用户需要获取客户状态、标签、区域、行业的可选 id 列表用于修改客户信息时使用;通过 lfy-cli base get_options,property 仅四类;API 上 cli 可省略(默认 false);Agent 示例仍推荐 cli=true。"
}
基础下拉选项技能(客户字段)
示例里
cli一般为true(仅id、name,无color,适合 Agent)。不传cli或cli:false(默认)时每项 必有color键(值可为"")。
通过 lfy-cli base get_options '<json>' 获取下拉数据;需已完成 lfy-cli init(与其它品类相同自动注入凭证)。
property 取值(仅此四种)
| property | 含义 |
|---|---|
customer_status |
客户状态 |
customer_tags |
客户标签 |
customer_region |
区域 |
customer_industry |
行业 |
命令示例
客户状态(将 <customer_id> 换成真实客户 id):
lfy-cli base get_options '{"object_id": <customer_id>, "property": "customer_status", "cli": true}'
区域:
lfy-cli base get_options '{"object_id": <customer_id>, "property": "customer_region", "cli": true}'
行业:
lfy-cli base get_options '{"object_id": <customer_id>, "property": "customer_industry", "cli": true}'
标签:
lfy-cli base get_options '{"object_id": <customer_id>, "property": "customer_tags", "cli": true}'
返回与错误
- 成功:
result为选项数组。省略cli或cli:false:每项id、name、color(color必有键);cli:true:每项仅id、name(无color字段)。 object_id传0:返回空数组(不查客户)。- 终端若出现
Error: 当前客户信息不存在(对应接口业务码4004):客户不存在、未激活或无效上下文的客户 id。 property拼写错误:错误文案含「无效,支持 customer_status,customer_tags,customer_region,customer_industry」。
与客户技能的衔接
customer_id(即 JSON 里的 object_id)从哪来
- 最常见:手头只有公司名称/关键字时,先用客户搜索,
result里每条有customer_id,任选一条作为object_id:
lfy-cli customer search '{"keywords": "<名称或关键字片段>"}'
- 已知 id:会话、工单、CRM 链接、或其它工具已给出数字 id,可直接用作
object_id。 - 列表/详情里已有:若在走
customer get_list、get_details等流程,响应里的客户主键同为customer_id,与这里object_id含义一致。
下拉选项里各字段的 id 如何用(写回客户),见 lfy-customer 技能正文与 references。
Version History
- e0220ca Current 2026-07-05 21:23


