

锐英源软件原创内容,禁止转载和任何形式的非法内容使用,违者必究
📑 本文目录
打开飞书Skill开发添加到智能体平台,导入日历后,打开飞书能自动看到日历,满足智能体平台办公要求。

小满的 Skill 是一套声明式的 YAML 文件,告诉 Agent "遇到什么场景、用什么 App、优先怎么做、失败了怎么 fallback"。本文以`open-feishu-calendar` 为例,从创建到推送、从 deeplink 探测到 channel 选择,展示一个 Skill 的完整生命周期。我们还会对比:如果不用 Skill,模型会启动飞书 → 点底部导航 → 找 Calendar Tab(3 步 GUI 操作 + 无障碍依赖);用 Skill 后,一行 deeplink`feishu://client/mine/calendar` 直跳(0 步 GUI,无崩溃风险)。
- Skill 文件格式速览
- YAML frontmatter:`name` 、`description` 、`apps` 、`channel` 、`deeplinks`
- Markdown body:自然语言的执行步骤(模型会读!)
- 支持的 channel:`deeplink-then-gui` (先试 deeplink,失败了退回 GUI)、`gui` 、`api` 等
创建过程
- 先探测 deeplink:`adb shell am start -d "feishu://client/mine/calendar"` → 返回`Status: ok` +`Activity: com.ss.android.lark/.main.router.RouterActivity` ✅
- 对比`sslocal://calendar` →`Error: Activity not started` ❌
- 第一次创建用了`channel: deeplink-only` → lint 报错(不支持的 channel)→ 改`deeplink-then-gui`
推送和加载
python cli/xiaoman.py push "skills/examples/open-feishu-calendar"
# 输出:1 skill(s) checked, 1 ok, 0 problem(s)
# pushed → /sdcard/Android/data/dev.xiaoman.app/files/skills/
# skills reloaded(广播触发 App 内 reload)
Skill 被模型怎么用
- `list_skills` 工具列出所有 skill
- phone_task 的`skill` 参数指定用哪个
- Agent prompt 里会注入 Skill 内容(`skillSection()` )
- 模型读 deeplink 映射 + 步骤说明 → 输出 deeplink action
为什么 Skill 比直接 Prompt 好
- 可复用:一次写好,所有任务都能用
- 可版本化:SKILL.md 进 git
- 可分享:`cli/xiaoman.py push` 即推即用
- 比长 Prompt 更精准:模型看到明确的 deeplink URL
---
name: open-feishu-calendar
description: 打开飞书日历查看日程(deeplink 直跳,无需 GUI 操作)
apps: [com.ss.android.lark]
channel: deeplink-then-gui
deeplinks:
open: "feishu://client/mine/calendar"
---
# 打开飞书日历
目标:打开飞书 App 的日历页面,让用户查看已写入的日程。
1. 用 deeplink `feishu://client/mine/calendar` 直接跳转。
2. deeplink 失败时(极少见),启动飞书,点底部导航「日历」Tab。
3. 看到飞书日历页面后 finish,summary 写「已打开飞书日历」。
本文是系列文章的第四章,全部文章在锐英源软件网站和“AI技术与原创内容出品”微信公众号上公布。