【Skill 创作】飞书全栈助手 —— 一条命令完成从日程到周报的全流程自动化

SOLO技能创作赛
1

一句话介绍：一个集成日历、任务、周报、文档、消息、会议纪要的飞书智能助手 Skill，基于 TRAE SOLO 开发，让 AI 真正成为你的职场效率搭档。

1、Skill 简介

**飞书全栈助手（Feishu Omni-Agent）**是一个面向职场人士的飞书生态智能助手 Skill。它将飞书分散的日历、任务、文档、消息、会议等能力整合为一个统一入口，用户只需一句自然语言，即可完成从日程查询到周报生成的全流程自动化。

核心解决的问题：职场人每周写周报耗时 30-60 分钟、会议纪要手动整理容易遗漏、跨工具切换效率低下、缺乏统一的个人工作流自动化方案。

能力类别 具体功能
:date: 日程管理 获取日历事件、查询忙闲状态、推荐空闲时段
:white_check_mark: 任务管理 创建待办、更新任务状态、查看任务列表
:memo: 周报生成 自动采集日程+任务，生成结构化周报
:page_facing_up: 文档创建 创建飞书云文档、写入内容、设置权限
:speech_balloon: 消息推送 发送群消息、@指定人员、发送卡片消息
:studio_microphone: 会议纪要 获取会议转写、AI提取决策和待办
:books: 知识库管理 文档摘要生成、智能检索、标签管理

适合人群：所有使用飞书进行日常办公的职场人士，尤其是需要频繁写周报、整理会议纪要、管理多任务的项目经理和团队负责人。

2、使用场景

场景一：一句话生成周报

**为什么做它？**作为产品经理，每周写周报占用大量时间，而且经常遗漏重要工作。日历事件和任务分散在飞书不同模块，手动汇总效率极低。

之前遇到的麻烦：

  • 每周五下午花 30-60 分钟回忆和整理本周工作

  • 日历事件、飞书任务、文档修改记录分散在不同地方，容易遗漏

  • 周报格式不统一，每次都要重新排版

  • 经常忘记把周报发到群里通知领导

做出来之后省掉了什么：

  • 一句话触发，30 秒自动生成完整周报

  • 自动采集日历事件 + 任务列表，不再遗漏

  • 统一格式输出，直接创建飞书云文档

  • 可选自动推送到群聊，领导即时收到

使用前

  • 手动回忆本周工作

  • 逐个打开日历、任务、文档

  • 整理排版 30-60 分钟

  • 手动创建文档并发群

使用后

  • 一句话触发自动生成

  • AI 自动采集所有数据源

  • 30 秒生成完整周报

  • 自动创建文档+推送群聊

场景二：智能任务管理

**为什么做它？**工作中经常突然想到要做的待办，打开飞书任务应用创建需要多个步骤，打断工作流。

之前遇到的麻烦：

  • 想到一个待办，需要打开飞书 → 找到任务应用 → 点击创建 → 填写信息

  • 经常因为嫌麻烦就先记在脑子里，然后忘了

  • 任务截止时间不好设置，经常忘记更新

做出来之后省掉了什么：

  • 一句话创建任务：“帮我创建一个待办，明天完成方案”

  • 自动识别截止时间（“明天”、"下周五"等自然语言）

  • 5 秒完成任务创建，不打断工作流

任务创建效果截图：

场景三：日程查询与会议整理

**为什么做它？**每天早上想知道今天有什么安排，需要打开日历查看；会议结束后整理纪要耗时且容易遗漏待办。

做出来之后省掉了什么：

  • “今天有什么安排？” → 自动展示今日日程，标注空闲时段

  • “整理一下今天的会议” → 自动获取会议信息，AI 提取决策和待办

  • 会议待办可一键创建为飞书任务，不再遗漏

日程安排效果截图：

会议整理效果截图：

3、创作过程

灵感来源

作为产品经理，我每周五下午都要花大量时间写周报。日历事件在飞书日历里、待办在飞书任务里、文档修改记录散落各处——每次汇总都是一场"考古"。更痛苦的是，会议纪要整理也是重复劳动：听转写、提取决策、创建待办……这些流程高度标准化，完全可以让 AI 来做。

TRAE SOLO 的 Skill 机制让我看到了机会：把飞书 CLI 的能力封装成一个智能助手，用自然语言驱动飞书的全套办公能力。

技术选型

技术组件 选择 原因
开发工具 TRAE SOLO 官方参赛要求，Skill 运行环境
飞书 API lark-cli 官方 CLI 工具，覆盖日历/任务/文档/消息/会议等全套能力
Skill 规范 SKILL.md + references/ + prompts/ + examples/ 遵循 Agent Skills 规范，结构清晰可维护
内容格式 Markdown 飞书云文档原生支持，渲染效果好

踩坑记录（重点！）

开发过程截图：

踩坑 1：lark-cli 任务创建参数名不是 --title

最初参考文档使用了 --title 参数创建任务，实际 lark-cli 的 task +create 使用的是 --summary。导致第一次端到端测试时报错。通过查看 lark-task skill 的参考文档才发现了正确的参数名。

教训：一定要用 lark-cli schema 查看实际参数结构，不要凭经验猜测。

踩坑 2：docs +create 不支持 --format 参数

创建文档时传了 --format json 参数，导致命令报错。docs +create 的输出格式由 CLI 自动处理，不需要手动指定。

教训：不同 skill 的 shortcut 参数规范不同，使用前务必先读参考文档。

踩坑 3：Skill 安装后 TRAE 未识别

第一次将 Skill 文件夹复制到 ~/.trae/skills/ 后，TRAE SOLO 没有识别到新 Skill。原因是需要完全退出 TRAE 后重新打开，让它重新加载 skills 目录。

教训：安装 Skill 后必须重启 TRAE SOLO。

经验总结：开发 Skill 的最佳流程

  1. 先用 lark-cli schema 查看 API 参数结构

  2. 在终端手动测试每条命令，确认参数正确

  3. 将验证过的命令写入 SKILL.md

  4. 安装到 TRAE 后重启，进行端到端测试

4、使用步骤

安装

# 1. 克隆 GitHub 仓库
git clone https://github.com/peachgreenti/feishu-omni-agent.git

# 2. 复制到 TRAE skills 目录
cp -r feishu-omni-agent ~/.trae/skills/

# 3. 重启 TRAE SOLO

配置（可选）

复制 .env.example 为 .env，填入你的飞书应用配置：

LARK_APP_ID=YOUR_APP_ID
LARK_APP_SECRET=YOUR_APP_SECRET
LARK_USER_ID=YOUR_USER_ID
LARK_CHAT_ID=YOUR_CHAT_ID

触发方式

安装完成后，在 TRAE SOLO 对话中直接用自然语言描述需求即可：

你说的话 触发的功能
“帮我生成本周周报” :memo: 周报生成
“创建一个待办，明天完成方案” :white_check_mark: 任务创建
“今天有什么安排？” :date: 日程查询
“我的待办有哪些？” :clipboard: 任务查询
“整理一下今天的会议” :studio_microphone: 会议整理
“新建一个文档” :page_facing_up: 文档创建
“把周报发到工作群” :speech_balloon: 消息推送
“帮我总结一下这个文档” :books: 知识管理

5、效果展示

端到端测试结果

测试项 状态 耗时 说明
lark-cli 授权 :white_check_mark: 通过 - 通过环境变量自动授权
日历获取 :white_check_mark: 通过 2 秒 获取到 7 个今日日程
任务获取 :white_check_mark: 通过 1 秒 获取到 6 个待办任务
任务创建 :white_check_mark: 通过 1 秒 成功创建待办任务
文档创建 :white_check_mark: 通过 2 秒 成功创建飞书云文档
周报生成 :white_check_mark: 通过 5 秒 自动生成完整周报并创建文档

效率提升对比

操作 使用前 使用后 提升
周报生成 30-60 分钟 30 秒 ↑ 90%+
任务创建 2 分钟 5 秒 ↑ 96%+
日程查询 1 分钟 2 秒 ↑ 97%+
会议整理 20 分钟 1 分钟 ↑ 95%+
文档创建 3 分钟 5 秒 ↑ 97%+

真实周报文档：https://my.feishu.cn/docx/HEojdNS8louG5ExPGPrch5YRn4e?from=from_copylink

6、Skill 链接

GitHub 仓库：https://github.com/peachgreenti/feishu-omni-agent

快速安装：git clone https://github.com/peachgreenti/feishu-omni-agent.git && cp -r feishu-omni-agent ~/.trae/skills/

项目结构

feishu-omni-agent/
├── SKILL.md                    # 核心配置文件
├── README.md                   # 项目说明文档
├── .env.example               # 环境变量模板
├── .gitignore                 # Git 忽略规则
├── references/                # 飞书 API 参考文档
│   ├── lark-calendar.md       # 日历操作参考
│   ├── lark-task.md           # 任务操作参考
│   ├── lark-doc.md            # 文档操作参考
│   ├── lark-im.md             # 消息操作参考
│   └── lark-vc.md             # 会议操作参考
├── prompts/                   # AI 提示词模板
│   ├── intent-detection.md    # 意图识别提示词
│   ├── weekly-report.md       # 周报生成提示词
│   ├── meeting-summary.md     # 会议整理提示词
│   └── knowledge-base.md      # 知识管理提示词
└── examples/                  # 使用示例
    ├── weekly-report.md       # 周报生成示例
    ├── meeting-summary.md     # 会议整理示例
    └── knowledge-manage.md    # 知识管理示例

7、总结与展望

最满意的地方

  • 环境自适应：不是生成一套"理想环境"的配置，而是先探测用户的飞书环境再执行操作

  • 一句话可达：每个功能只需一句自然语言即可触发，无需记忆命令

  • 全链路闭环：从数据采集 → AI 处理 → 文档创建 → 消息推送，端到端自动化

  • 可扩展架构：references/ + prompts/ + examples/ 三层结构，易于添加新能力

后续优化方向

  • 支持更多飞书能力：审批流程、OKR 管理、多维表格操作

  • 支持自定义周报模板：用户可以自定义周报格式和内容结构

  • 多语言支持：英文、日文等

  • 定时自动执行：每周五下午自动生成周报并推送

  • 团队协作：支持为团队成员批量生成周报

希望得到的建议

  • 周报生成的内容结构是否合理？还需要补充哪些维度？

  • 意图识别的触发词覆盖是否足够？有没有常见场景遗漏？

  • Skill 的文件结构是否符合最佳实践？

如果你也经常被周报、会议纪要、任务管理这些重复劳动困扰，试试这个 Skill 吧！欢迎在评论区交流使用体验和改进建议 :folded_hands: