FAQ — 从实战场景中提炼的常见问题

Q1：业务人员需要会敲 CLI 吗？

不需要。

Lovrabet CLI 更像 Agent 背后的执行层。业务人员更应该做的是：

• 把业务问题说清楚
• 说明只读还是允许写入
• 如果有订单号、手机号、客户 ID 这类关键标识，尽量一起给出

真正的命令，通常由 Agent 和 skills 在后台决定。

---

Q2：为什么没有 sql list 和 bff list？

这是有意设计。

原因是 SQL 和 BFF 往往对应真实业务逻辑，不适合让通用 Agent 随便扫一遍再自由执行。更推荐的方式是：

• 由维护同学在 skill 里明确“这个场景该调用哪条 SQL / 哪个 BFF”
• 业务人员只描述业务目标
• Agent 按 skill 执行

---

Q3：--global 到底是什么意思？

它控制配置写到哪里。

简单理解：

• 全局配置：这台机器上都能用
• 项目配置：只在当前项目目录里生效

常见场景：

• auth login 默认偏向全局，方便多项目复用同一把 AK
• app use、config set 在项目里通常优先写项目配置

如果你只是业务侧使用 Agent，通常不用自己管这个细节。

---

Q4：安装时报 PromptScript does not support global skill installation 怎么办？

TIP

这是 skills@1.5.10 的上游短期兼容问题，不是 Lovrabet CLI 本身安装失败。业务人员不需要自己判断 --agent、--all 或 Agent 目录，先确认状态，再交给 Agent 或技术同学在本地终端处理。

先区分两个状态：

• 如果 lovrabet --version 可以正常输出版本号，说明 Lovrabet CLI 已经安装成功。
• Skill 安装失败只影响 AI Agent 是否能正确理解 Lovrabet CLI，不代表 Lovrabet CLI 不可用。

建议处理方式：

• 不要在 Feishu Aily、钉钉悟空等 IM 类 Agent 中反复重试同一条安装命令，避免被 30 秒超时、沙箱路径或 App 私有 SkillHub 误导。
• 让 Agent 或技术同学在真实本地终端执行安装，并用本地 skills CLI 的输出确认结果。
• 临时规避可以固定上一版安装工具：

npx skills@1.5.9 add lovrabet/lovrabet-cli -g -y

• --agent <agent> 只适合技术同学在明确目标工具时使用，例如目标就是 Codex、Claude Code 或 Cursor；业务人员不需要自己填写，也不要让 Agent 猜。
• 如果日志里已经出现 installed 成功信息，再出现 Failed to install 1，需要结合真实本地 npx skills list -g --json 判断，不要只看自然语言总结。

技术参考：上游 Issue #1352 与修复 PR #1362。https://github.com/vercel-labs/skills/issues/1362 会跳转到同一个 PR。

---

Q5：为什么没有 app add？

因为 runtime CLI 已经不再把“本地维护一套应用 profile 列表”当主模型。

当前推荐方式是：

• 用 app list 看当前账号可见应用
• 用 app use 选默认应用
• 让远端应用目录 + 本地 cache 作为事实来源

---

Q6：我一定要知道 appcode、dataset code、sqlcode 吗？

不一定。

理想情况下：

• 业务人员不需要知道
• skill 维护者最好知道
• Agent 在必要时可以先做发现动作

如果你能提供这些信息，执行会更快。如果你不知道，也可以先让 Agent 帮你探路。

---

Q7：怎么提需求更容易让 Agent 做对？

尽量一次说清楚这几件事：

• 哪个业务系统或业务域
• 哪个业务对象
• 时间范围或筛选条件
• 最终想拿到什么结果
• 这次是只读，还是允许写入

例如：

帮我找近 7 天付款成功但未发货的订单，按仓库汇总，只读。

比“帮我查一下订单”有效得多。

---

Q8：写入类需求怎么说更安全？

推荐直接在需求里加一句：

• 先预览，再执行
• 只读，不写数据

这样 Agent 更容易自动走到正确的安全路径上。

---

Q9：--dry-run 有什么用？

它会先展示“这次准备怎么执行”，但不会真的写入。

对以下场景尤其有用：

• 批量修正状态
• 补录数据
• 删除前最后确认
• 你不完全确定这次参数是否正确

---

Q10：现在还支持 Cookie 吗？

当前 Lovrabet Runtime CLI 走的是 AccessKey 主路径。如果你还在用旧文档里的 Cookie 说法，可以直接按新版 AccessKey 理解。

---

Q11：Agent 写错了怎么办？

先分两类看：

• 命令都没跑起来：优先看登录、默认应用、doctor、日志
• 命令跑起来了，但结果不对：优先检查 skill、业务 prompt 和业务流程假设

很多时候问题不在 CLI 本身，而在“技能里绑定的业务流程已经过时”。