Metadata
- slug
- calendar-sync-tool
- name
- calendar-sync-tool
- version
- 1.0.0
- displayName
- 日历工具
- summary
- 管理飞书Lark日历,列出/搜索/查日程/同步事件,办公协同。Manage Feishu (Lark) calendars by listing, searching, checking s
- summary_zh
- 管理飞书Lark日历,列出/搜索/查日程/同步事件,办公协同。Manage Feishu (Lark) calendars by listing, searching, checking s
- license
- MIT
- description
- Manage Feishu (Lark) calendars by listing, searching, checking schedules, syncing events, and mar。Use when 用户需要calendar-sync-tool相关功能时使用。不适用于超出本技能能力范围的复杂需求。
- tags
- ["通信","api","依赖说明","不支持","agent","确认运行"]
- tools
- ["read","exec","glob","grep"]
- homepage
- category
- Automation
feishu-calendar
专业版增值服务
| 能力 |
免费版 |
付费版 |
| 基础功能 |
支持 |
支持 |
| 多渠道消息批量发送 |
不支持 |
支持 |
| 消息模板与变量注入 |
不支持 |
支持 |
| 送达状态实时回调 |
不支持 |
支持 |
| 通信记录归档与检索 |
不支持 |
支持 |
| 消息频控与智能排队 |
不支持 |
支持 |
主要能力
- Manage Feishu (Lark) calendars by listing, searching, checking schedules,
syncing events, and mar
安装步骤
- 确认运行环境满足依赖说明中的要求
- 在AI Agent对话中调用本技能,提供必要的输入参数
- 检查输出结果,根据需要进行后续处理
详细的输入输出格式请参考下方章节说明。
应用场景
| 场景 |
输入 |
输出 |
| 日程管理 |
日期范围与筛选条件 |
日程列表与详情 |
| 事件同步 |
日历ID与事件数据 |
同步状态与事件ID |
| 日程查询 |
时间范围参数 |
日程列表与冲突检测 |
不适用于:需要人工判断的复杂决策场景
参数说明
| 参数名 |
类型 |
必填 |
说明 |
| content |
string |
否 |
处理的内容输入 |
| mode |
string |
否 |
处理模式, 可选值: json/text/markdown |
| style |
string |
否 |
输出风格, 参考 references/style.md |
输出规范
{
"success": true,
"data": {
"result": "处理结果",
"status": "success",
"metadata": {
"metadata": {
"template_used": "reviewer",
"word_count": 0,
"style": "专业"
}
},
"error": null
}
输出模板参考: assets/output.json
异常恢复流程
| 错误场景 |
原因 |
处理方式 |
| 配置错误 |
参数缺失或格式错误 |
检查依赖说明中的配置要求 |
| 运行时错误 |
运行环境不满足 |
确认运行环境符合依赖说明 |
| 网络错误 |
连接超时或不可达 |
|
前置条件
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
依赖说明(补充)
| 依赖项 |
类型 |
是否必需 |
获取方式 |
| LLM API |
API |
必需 |
由Agent内置LLM提供 |
API Key 配置
可用性分类
- 分类: MD+execute()
- 说明: 基于Markdown的AI Skill,
API Key配置方式:
export API_KEY="${API_KEY:?请设置环境变量}"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
热门问题
Q1: 如何开始使用feishu-calendar?
A: 请参考使用流程和依赖说明章节,确保运行环境满足要求后调用本技能。
异常处理指引
| 错误场景(续) |
原因 |
处理方式 |
| LLM响应超时或无响应 |
网络延迟或模型负载过高 |
请求重试;确认Agent平台LLM服务正常 |
| 输入内容格式不正确 |
用户输入不符合skill预期格式 |
检查输入是否符合skill使用说明中的格式要求,参考示例章节 |
| 执行结果与预期不符 |
指令描述不够明确或上下文不足 |
提供更详细的指令描述,补充必要的上下文信息 |
| 命令执行失败 |
运行环境不满足要求或权限不足 |
确认运行环境符合依赖说明中的要求;检查命令权限设置 |
常见问题FAQ
Q1: 如何在日历工具中搜索特定日期的事件?
A: 在日历工具中,您可以通过输入日期范围和关键词来搜索特定日期的事件。例如,输入“2023-12-01”和“会议”可以搜索2023年12月1日所有包含“会议”关键词的事件。
Q2: 如果同步事件失败,我该如何处理?
A: 如果同步事件失败,首先检查网络连接是否稳定。如果网络正常,检查事件数据格式是否符合要求。如果问题依旧,请联系技术支持以获取进一步的帮助。
Q3: 日历工具支持哪些类型的日历同步?
A: 日历工具支持与飞书Lark日历的同步,包括个人日历和共享日历。目前不支持与其他第三方日历服务的同步。
Q4: 我能否在日历工具中设置事件提醒?
A: 目前日历工具不支持设置事件提醒功能。您需要在飞书Lark日历中手动设置事件提醒。
Q5: 如果我需要查看多个日历的日程,应该如何操作?
A: 您可以在日历工具中指定多个日历ID,系统将列出这些日历的日程列表。确保在调用技能时提供所有相关日历的ID。
诊断与修复
| 错误现象 |
可能原因 |
诊断步骤 |
解决方案 |
| 无法列出日历 |
日历ID错误 |
检查提供的日历ID是否正确 |
修正日历ID并重新尝试 |
| 同步事件失败 |
事件数据格式错误 |
检查事件数据格式是否符合规范 |
修正事件数据格式并重新同步 |
| 网络连接问题 |
网络不稳定 |
检查网络连接 |
确保网络连接稳定或重试操作 |
| 无响应 |
运行环境问题 |
检查运行环境是否满足依赖要求 |
确保运行环境符合要求或更新环境配置 |
安全提示
| 风险项 |
等级 |
防护措施 |
验证方法 |
| API Key泄露 |
高 |
使用环境变量存储API Key |
定期检查环境变量,确保无泄露 |
| 日历数据未加密 |
中 |
对敏感数据进行加密存储 |
定期检查加密配置,确保数据安全 |
| 网络攻击 |
高 |
使用HTTPS协议 |
检查服务是否使用HTTPS |
| 权限滥用 |
中 |
限制API Key权限 |
定期审查API Key权限,确保最小权限原则 |
| 恶意代码 |
高 |
使用代码审计工具 |
定期进行代码审计,检测潜在恶意代码 |
创新特色
| 效率提升量化分析 |
| 减少手动操作时间 |
| 提高日程同步效率 |
| 增加日程管理灵活性 |
| 降低错误率 |
| 差异化对比表格 |
| 功能 |
| :----------------- |
| 日历同步 |
| 事件搜索 |
| 日程冲突检测 |
| 多日历管理 |
| 事件提醒设置 |
功能矩阵
- 自动化执行: 管理飞书Lark日历,列出/搜索/查日程/同步事件,办公协同。Manage Feishu (Lark) calendar
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
- 信息检索: 快速搜索和过滤目标数据
效率指标
| 操作场景 |
手动耗时 |
自动化耗时 |
效率提升 |
| 文件解析与提取 |
5-10分钟/个 |
<5秒/个 |
60-120x |
| 批量文件处理(100个) |
8-16小时 |
<5分钟 |
96-192x |
| API调用与响应解析 |
2-3分钟/次 |
<1秒/次 |
120-180x |
| 多接口数据聚合 |
15-30分钟 |
<10秒 |
90-180x |
| 命令执行与结果收集 |
3-5分钟/次 |
<2秒/次 |
90-150x |
| 重复任务批量执行 |
因任务而异 |
线性缩减 |
5-50x |
| 错误排查与修复 |
10-30分钟 |
<30秒 |
20-60x |
优势对比
| 对比维度 |
日历工具 |
传统手动方式 |
通用脚本工具 |
| 自动化程度 |
全流程自动 |
完全手动 |
部分自动 |
| 错误处理 |
内置错误恢复 |
依赖人工经验 |
基本try-catch |
| 可复用性 |
参数化配置 |
一次性脚本 |
模板化 |
| 安全合规 |
内置安全检查 |
无安全保障 |
无安全保障 |
| 适用场景 |
管理飞书Lark日历,列出/搜索/查日程/同步事件,办公协同。Manage Fe |
通用场景 |
通用场景 |
错误恢复流程
针对日历工具使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 |
原因分析 |
解决方案 |
| API认证失败(401) |
API密钥错误或过期 |
检查密钥配置,重新生成token |
| 接口限流(429) |
请求频率超出限制 |
降低调用频率,启用重试退避策略 |
| 响应超时(504) |
网络延迟或服务端负载过高 |
增加超时阈值,检查网络连接 |
| 文件不存在 |
路径错误或文件未创建 |
检查路径拼写,确认文件已生成 |
| 文件格式不支持 |
扩展名不在支持列表中 |
转换为支持的格式后重试 |
| 权限不足 |
当前用户无读写权限 |
检查文件权限,以管理员身份运行 |
| 命令执行失败 |
参数错误或环境依赖缺失 |
检查命令语法,确认依赖已安装 |
| 进程超时 |
命令执行时间过长 |
增加超时设置,优化命令参数 |
| 网络连接失败 |
DNS解析失败或防火墙拦截 |
检查网络配置,确认代理设置 |
日历工具通用排查步骤
- 检查输入参数: 确认所有必填参数已提供且格式正确
- 查看日志输出: 定位具体错误行和异常类型
- 验证环境配置: 确认依赖库版本和运行环境满足要求
- 逐步调试: 缩小问题范围,隔离故障模块