前言¶

要在 Cursor、Codex 或 Claude Code 里让 Agent 操作飞书文档、日程或群聊，通常要先在本机装好官方命令行工具 lark-cli（npm 包 @larksuite/cli），再完成应用创建与 OAuth 授权。手工查 Node 版本、处理 npm 权限、对照开放平台文档逐步点选，步骤多且容易在某一步卡住。

下面介绍 SkillHub 社区 Skill「飞书CLI一键安装助手」（@user_af28adda/feishu-cli-installer）。它把环境检测、CLI 安装、相关 Skills 安装、配置初始化、授权引导与结果校验写成可执行的 Python 脚本，由 Agent 按 SKILL.md 驱动，减少重复手工操作。标签 requires_api_key=false，不依赖额外 API Key 配置。

这是什么¶

一句话定位：面向 AI Agent 的飞书 / Lark CLI（lark-cli）一键安装与配置引导 Skill。

维护与来源：社区发布（community），坐标 @user_af28adda/feishu-cli-installer，当前版本 1.0.0，分类为 dev-programming。SkillHub 页面统计（以抓取资料为准）：评分 100000，下载 8060，安装 214。

解决的问题：把「装 CLI → 装配套 Skills → 初始化配置 → 用户授权 → 验证」串成固定流程；支持记录进度、失败断点续装，并在环境不满足时给出可执行的修复建议（如 Node 版本、npm 权限、镜像源）。

核心功能¶

依据 Skill 包内 SKILL.md 与 scripts/ 实现，已核实能力如下。

1. 智能环境检测（scripts/environment_checker.py）
   检查 Node.js（文档要求 16.0+）、npm/yarn、网络与系统权限，并输出问题说明。

2. 一键自动安装（scripts/one_click_installer.py）
   串联安装 lark-cli（npm install -g @larksuite/cli 或 yarn global add @larksuite/cli）、安装相关 Skills、初始化应用配置、授权引导与安装验证。

3. 断点续装
   使用工作目录下的 .lark_cli_install_progress.json 记录步骤；已完成步骤可跳过，失败可从断点继续。

4. 错误处理与分步入口
   除一键脚本外，可按步骤单独调用 lark_installer.py、skills_installer.py、config_initializer.py、auth_guide.py、installation_validator.py。常见故障在 references/common_issues.md、references/troubleshooting.md 中有说明。

安装成功后的校验命令（Skill 文档约定）：

lark-cli help
lark-cli auth status
lark-cli config list

安装与启用¶

1. 安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时执行：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

说明见 SkillHub 安装文档。

2. 将 Skill 装进当前 Agent 的 skills 目录¶

安装时必须使用 --dir 指向当前客户端的 skills 目录，否则默认落在 ./skills/ 且 Agent 可能无法加载。官方文档给出的常见路径：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

安装命令（需带 namespace）：

skillhub install feishu-cli-installer --namespace user_af28adda --dir ~/.cursor/skills/

也可把下面提示词交给 Agent，让其按 SkillHub 安装说明执行：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_af28adda/feishu-cli-installer`。

安装完成后，按所用客户端要求重启或刷新 Agent，使 Skill 生效。

典型用法¶

在 Skill 目录下一键安装 lark-cli¶

进入已安装的 Skill 目录（路径因 --dir 而异，示例为 Cursor 全局目录）：

cd ~/.cursor/skills/@user_af28adda/feishu-cli-installer
python scripts/one_click_installer.py

文档描述的流程分为五步：环境检测 → 安装 lark-cli → 安装 Skills → 初始化配置（含 App ID / App Secret）→ 浏览器 OAuth 授权 → 运行 installation_validator 校验。

分步执行（需要精细控制时）¶

python scripts/environment_checker.py
python scripts/lark_installer.py
python scripts/skills_installer.py
python scripts/config_initializer.py
python scripts/auth_guide.py
python scripts/installation_validator.py

授权失败或令牌过期时，Skill 文档建议重新执行：

lark-cli auth login

与 Agent 对话¶

Skill 安装并跑通 CLI 后，可按 SKILL.md 中的示例向 Agent 发起飞书相关任务，例如创建云文档、查看日程、搜索群聊等（具体能力取决于已安装的飞书 CLI 子 Skill 与当前登录态）。

适用场景与注意¶

适合谁

• 第一次在本地为 Agent 配置飞书 / Lark CLI 的开发者。
• 安装中断、需要断点续装或排查 Node/npm/网络问题的环境。
• 希望用固定脚本而不是零散复制命令的团队。

限制与注意

• 依赖 Node.js 16+ 与全局 npm/yarn；Linux 上权限不足时需按文档调整 npm 前缀或使用 sudo 安装全局包。
• 配置与授权会涉及飞书开放平台应用信息，请在可信环境操作，勿将 App Secret 提交到公开仓库。
• Skill 通过 SkillHub 安装时需使用 --namespace user_af28adda；仅写完整 slug 而不带 namespace 时，CLI 可能无法从索引解析并下载。
• 社区 Skill，行为以包内 SKILL.md 与脚本为准；飞书 CLI 本身以 larksuite/cli 与飞书开放平台文档为最终依据。

结尾¶

「飞书CLI一键安装助手」把 lark-cli 从环境检查到授权验证收敛成 Agent 可执行的脚本流程，适合作为飞书自动化 Skills 链路的安装前置步骤。官方入口：

• SkillHub API：https://api.skillhub.cn/user_af28adda/feishu-cli-installer
• SkillHub 页面：https://www.skillhub.cn/skills/user_af28adda/feishu-cli-installer