1. 命令作用

• npm install -g @larksuite/cli
  全局安装飞书 CLI 工具本体，终端才能识别 lark-cli 命令。
• npx skills add https://github.com/larksuite/cli -y -g
  从 GitHub 拉取AI 技能说明书，让 AI 更会用 lark-cli。
• lark-cli config init --new
  初始化配置，生成 .lark-cli 隐藏目录，保存飞书授权。

2. 技能 vs CLI 本质

• lark-cli：真正能调用飞书接口的命令工具（必须装）。
• skills：给 AI 看的使用说明书（不装也能用，只是体验差）。
• 只装技能不装 CLI → AI 只会说不会执行

3. 隐藏目录含义

• .lark-cli：飞书 CLI 配置、授权凭证（全局共用）。
• .agents：skills 技能存放目录（Cursor/Trae 共用）。
• . 开头 = 系统隐藏配置文件夹，勿删。

4. 跨软件共用

• skills -g 全局安装后，Cursor、Trae 通用。
• skills list 不显示不代表失败，AI 直接读文件夹即可用。

5. 执行顺序与依赖

• 先装 @larksuite/cli（基础）
• 再装 skills 技能（优化）
• 最后配置初始化。配置一次永久生效，重启 / 换软件无需重复执行。