编程

calendar-reminder-free

试用

面向个人开发者的 Outlook 日历提醒 Skill 免费版。每晚 22:00 扫描明日 Outlook 日历, 将上午日程与下午日程分别按"提前 2 小时"和"当天 12:00 统一"两种基础策略推送飞书提醒. 基于 owa-outlook skill 提供的 owa_calendar.py 读取日历数据,通过 skill-platform CLI 注册 cron. 适用于个人每日日程前置提醒的基础场景。高级特性(跨时区处理、团队群共享、安静时段、 多渠道通知)请升级付费版.

它能做什么

面向个人开发者的 Outlook 日历提醒 Skill 免费版。每晚 22:00 扫描明日 Outlook 日历, 将上午日程与下午日程分别按"提前 2 小时"和"当天 12:00 统一"两种基础策略推送飞书提醒. 基于 owa-outlook skill 提供的 owa_calendar.py 读取日历数据,通过 skill-platform CLI 注册 cron. 适用于个人每日日程前置提醒的基础场景。高级特性(跨时区处理、团队群共享、安静时段、 多渠道通知)请升级付费版.

技能文档

Calendar Reminder Free 日历提醒(免费版)

输入规范

参数名类型必填说明
inputstring日历提醒(免费版)处理的输入数据或指令
optionsobject附加配置选项,如模式选择、格式偏好等
callback_urlstring异步处理完成后的回调通知URL

技能简介

Calendar Reminder Free 是日历提醒 Skill 的免费版本,提供基础的每晚 22:00 扫描明日 Outlook 日历并按上下午时段推送飞书提醒的能力。适合个人开发者快速搭建每日日程提醒工作流.

能力清单

1. 每晚 22:00 扫描明日日历

在每晚 22:00(Asia/Shanghai 时区)自动拉取明日 Outlook 日历的全部日程,包括会议主题、开始时间、结束时间、组织者、地点等基础字段。扫描完成后立即发送一条汇报消息到飞书.

2. 上下午差异化提醒

  • 上午日程(开始时间 < 12:00):提前 2 小时飞书提醒.
  • 下午日程(开始时间 >= 12:00):当天 12:00 统一汇总提醒.

3. Cron 定时任务注册

通过 skill-platform cron add 命令注册每日扫描任务,任务持久化在 skill-platform 中.

输出格式

完成响应以Markdown格式返回,包含任务状态(成功/失败)、解析摘要和具体输出数据。失败时返回错误码和错误信息,便于定位问题。- 验证返回数据的完整性和格式正确性

安装与配置

运行环境

  • Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
  • 操作系统: Windows / macOS / Linux

依赖项

依赖项类型是否必需获取方式
LLM APIAPI必需由Agent内置LLM提供

API Key 配置

需要配置对应API Key,详见上文环境配置章节

可用性分类

  • 分类: MD+EXEC()

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

典型场景

场景一:个人开发者每日晨会提醒

  • 输入: 配置飞书 open_id 后,每晚 22:00 自动触发
  • 输出: 次日 07:30 收到飞书提醒"09:30 晨会",12:00 收到下午日程汇总
  • 价值: 避免早晨匆忙错过晨会

场景二:基础日程预览

  • 输入: 明日有 3 场会议
  • 输出: 22:00 收到飞书汇报"明日共 3 场会议,上午 1 场,下午 2 场"
  • 价值: 睡前掌握明日安排

使用说明

步骤一:确认依赖

python3 --version  # 需要 3.9+
skill-platform --version

步骤二:配置飞书 open_id

编辑 calendar_reminder.pysend_feishu 函数,将 target 改为你的飞书 open_id:

"--target", "user:ou_xxxxxxxxxxxxxxxx",

步骤三:注册 cron 任务

skill-platform cron add \
  --name "calendar-daily-scan" \
  --cron "0 22 * * *" \
  --tz "Asia/Shanghai" \
  --session main \
  --system-event "CALENDAR_SCAN: 请立即运行 python3 ~/.skill-platform/workspace/skills/calendar-reminder/calendar_reminder.py 并等待完成" \
  --description "每晚22:00扫描明天日历并设置提醒"

步骤四:手动验证

# 本技能的核心实现逻辑
# 请参考上方使用说明进行配置和调用
echo "implementation_ready"

检查飞书是否收到扫描汇报消息.

案例展示

案例1:个人开发者的晨会提醒

背景: 开发者每日 09:30 有站会,经常因早晨处理事务错过. 运行数据:

  • 22:00 扫描启动,拉取明日 3 条日程
  • 22:02 飞书收到汇报:"明日共 3 场会议,上午 1 场(09:30 站会),下午 2 场"
  • 次日 07:30 飞书提醒:"09:30 站会即将开始(提前 2 小时提醒)"
  • 次日 12:00 飞书汇总:"下午 2 场会议:14:00 代码评审 / 16:00 周会"

效果: 开发者 07:30 收到提醒后提前准备站会内容.

案例2:明日无日程的静默处理

背景: 周末明日无任何日程. 运行数据:

  • 22:00 扫描启动,拉取明日 0 条日程
  • 22:01 飞书收到汇报:"明日无日程安排,扫描已完成"

效果: 用户确认扫描正常运行,无需担心任务失效.

异常处置

1. owa_calendar.py 调用失败

原因: owa-outlook skill 未安装或 Outlook 凭据过期. 处理: 执行 python3 -c "import owa_calendar; owa_calendar.list_events()" 验证 skill 可用;若凭据过期,重新运行 owa-outlook 登录流程刷新 token;网络问题检查代理配置后检查网络连接和配置后重试.

2. 飞书消息推送失败

原因: open_id 格式错误或机器人 token 过期. 处理: 检查 target 是否以 user: 前缀开头;若返回 token 错误码,重新获取 app_access_token;建议对飞书 API 失败做 3 次检查网络连接和配置后重试.

3. zoneinfo 模块导入失败

原因: Python 版本低于 3.9 或 Linux 未安装 tzdata. 处理: 升级 Python 到 3.9+;在 Debian/Ubuntu 执行 sudo apt install tzdata;macOS 通常已内置.

4. cron 任务未触发

原因: skill-platform 服务未运行或时区配置错误. 处理: 执行 skill-platform cron list 确认任务存在;检查 --tz 参数使用 IANA 时区名(如 Asia/Shanghai);手动触发 skill-platform cron trigger calendar-daily-scan 验证.

5. 扫描结果中日程缺失

原因: Outlook 部分日程为"私有"标记或存在多个日历文件夹. 处理: 在 owa-outlook 配置中开启拉取私有事件;在脚本中明确指定要扫描的日历名称,避免 Holidays 等系统日历干扰.

问答速查

Q1: 如何将提醒从个人飞书改为其他渠道?

免费版仅内置飞书推送。若需钉钉、企业微信等渠道,请升级付费版,付费版支持多渠道通知后端切换.

Q2: 明日没有日程时还会推送消息吗?

会推送一条"明日无日程安排"的汇报消息,确保用户知道扫描已正常执行。若希望静默,可在脚本中增加 if not events: return 跳过推送.

Q3: 如何调整上午/下午的分界时间?

calendar_reminder.py 中找到 afternoon_threshold 变量,修改为目标时间(如 13:00)。免费版需同时手动调整下午统一提醒的 cron 时间.

Q4: 如何临时禁用某一天的扫描?

执行 skill-platform cron pause calendar-daily-scan 暂停,假期结束后执行 skill-platform cron resume calendar-daily-scan 恢复.

错误恢复方案

错误场景原因处理方式
LLM响应超时或无响应网络延迟或模型负载过高检查网络连接和配置后重试;确认Agent平台LLM服务正常
输入内容格式不正确用户输入不符合skill预期格式检查输入是否符合skill使用说明中的格式要求,参考示例章节
执行结果与预期不符指令描述不够明确或上下文不足提供更详细的指令描述,补充必要的上下文信息
命令执行失败运行环境不满足要求或权限不足确认运行环境符合依赖说明中的要求;检查命令权限设置

限制条件

  • 仅支持 Outlook 日历,不支持 Google Calendar、Apple Calendar
  • 提醒策略固定为"上午提前 2 小时 / 下午 12:00 汇总",不支持按优先级差异化
  • 不支持跨时区日程的智能识别与安静时段判断
  • 仅支持飞书推送,不支持团队群共享与多渠道通知
  • 依赖 skill-platform cron,服务停止则扫描不执行

升级提示

当前为免费版本,提供基础的日历扫描与飞书提醒功能。升级到付费版可获得以下高级特性:

  • 跨时区日程智能处理:自动识别 UTC 时间并正确换算本地提醒时间
  • 团队群共享提醒:支持配置群 chat_id,全员共享明日日程
  • 安静时段保护:凌晨 23:00-07:00 不推送,延后合并提醒
  • 全天事件单独处理:避免全天事件被误判为上午日程
  • 多渠道通知:支持钉钉、企业微信、Slack 等渠道切换
  • 扫描结果增强汇报:标注重点会议、组织者、会议链接

请访问 skill 商城升级到 calendar-reminder 付费版获取完整能力.

差异化分析

效率提升量化分析

操作步骤手动耗时自动化耗时时间节约准确率提升
手动检查日历30分钟/天2分钟/天28分钟/天100%
手动发送提醒10分钟/天1分钟/天9分钟/天100%
处理日程冲突15分钟/周5分钟/周10分钟/周100%
更新日程信息20分钟/周5分钟/周15分钟/周100%
汇总日程安排30分钟/周10分钟/周20分钟/周100%

差异化对比

对比维度本技能手动操作Python脚本专业软件
功能复杂度简单复杂中等
易用性中等
成本中等
扩展性中等
准确率

核心痛点解决

痛点描述影响范围解决方案量化效果
忘记日程容易忘记重要日程,导致错过会议或活动个人工作效率自动提醒功能时间节约 28分钟/天
处理日程冲突手动处理日程冲突耗时且容易出错个人工作效率自动识别冲突并提醒时间节约 10分钟/周
更新日程信息更新日程信息需要手动操作,效率低个人工作效率自动更新日程时间节约 15分钟/周

诊断与修复

错误现象可能原因诊断步骤解决方案
飞书提醒未收到飞书open_id配置错误检查open_id配置是否正确修正open_id配置
日历数据未扫描没有注册cron任务检查cron任务是否注册成功重新注册cron任务
扫描任务失败Outlook日历访问权限不足检查Outlook日历访问权限修改Outlook日历访问权限
提醒时间错误时区设置错误检查时区设置是否正确修正时区设置
日程信息错误日历数据格式错误检查日历数据格式修正日历数据格式

安全规范

  1. 确保API Key安全,避免泄露到版本控制系统。
  2. 定期检查技能的运行日志,及时发现并处理异常。
  3. 限制技能的访问权限,仅授权必要的用户和系统。
  4. 避免在公共网络环境下运行技能,以防止数据泄露。
  5. 定期更新技能依赖的库和工具,以修复已知的安全漏洞。

安全风险防范

风险项等级防护措施验证方法
API密钥泄露通过环境变量配置,禁止硬编码定期检查代码和配置文件
命令执行风险仅执行白名单命令,避免拼接用户输入使用沙箱环境测试
网络通信安全使用HTTPS协议,验证SSL证书定期检查证书有效期
敏感数据暴露输出结果中不包含密钥、令牌等敏感信息日志脱敏审查
未授权访问限制访问权限,实施认证机制定期审计访问日志

功能介绍

  • 自动化执行: 每晚22点扫描明日Outlook日历,基础飞书提醒,支持手动运行与cron注册。面向个人开发者的 Outlook 日历提
  • 文件处理: 支持多种文件格式的读取、解析和写入操作
  • API集成: 通过标准化接口调用外部服务并处理响应
  • 命令执行: 在安全沙箱中执行系统命令并收集结果

指南中心

Q1: 日历提醒(免费版)支持哪些输入格式?

A1: 每晚22点扫描明日Outlook日历,基础飞书提醒,支持手动运行与cron注册。面向个人开发者的 Outlook 日历提醒 Skill 免费版。每晚 22:00。支持文本指令和结构化参数输入,具体格式参考使用流程章节。

Q2: 需要配置API Key吗?

A2: 是的,部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求,并通过环境变量安全配置。

Q3: 命令行执行失败怎么办?

A3: 检查命令参数是否正确,确认运行环境支持exec能力。如遇权限问题,请参照错误处理章节排查。

日历提醒(免费版)通用排查步骤

  1. 检查输入参数: 确认所有必填参数已提供且格式正确
  2. 查看日志输出: 定位具体错误行和异常类型
  3. 验证环境配置: 确认依赖库版本和运行环境满足要求
  4. 逐步调试: 缩小问题范围,隔离故障模块

故障恢复

针对日历提醒(免费版)使用中可能遇到的常见问题,提供以下排查方案:

错误类型原因分析解决方案
API认证失败(401)API密钥错误或过期检查密钥配置,重新生成token
接口限流(429)请求频率超出限制降低调用频率,启用重试退避策略
响应超时(504)网络延迟或服务端负载过高增加超时阈值,检查网络连接
文件不存在路径错误或文件未创建检查路径拼写,确认文件已生成
文件格式不支持扩展名不在支持列表中转换为支持的格式后重试
权限不足当前用户无读写权限检查文件权限,以管理员身份运行
命令执行失败参数错误或环境依赖缺失检查命令语法,确认依赖已安装
进程超时命令执行时间过长增加超时设置,优化命令参数
网络连接失败DNS解析失败或防火墙拦截检查网络配置,确认代理设置

相关技能

Let your AI assistant manage your Outlook calendar for you. Just say what you need — add, change, or delete events, set up repeating meetings, or ask when you're free — and it happens on your own calendar.

管理飞书(Lark)日历,支持列出日历、搜索日程、检查安排与同步事件。Use when 需要SEO优化、关键词分析、排名提升、搜索流量优化时使用。不适用于黑帽SEO手段。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互,无需复杂配置即开即用。输出结果可直接使用,减少二次加工成本。提供结构化输出和错误处理机制。

1 次安装

通过 porteden CLI 安全管理 Google 与 Outlook 日历,支持事件查询、创建与更新。Use when 需要安全检测、合规审计、漏洞扫描、加密防护时使用。不适用于渗透测试未授权目标。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互,无需复杂配置即开即用。输出结果可直接使用,减少二次加工成本。

全库唯一的提醒发送方:把其他 SKILL 入队的复习、错题复测、计划任务、探索任务合并成每天一条摘要发出。只在学生说出**明确的提醒动词**时激活:“帮我设置提醒”“提醒我复习二次根式”“我今天该复习什么”“暂停提醒”“查看我的提醒”。提到“提醒”但不是要操作提醒的话(“老师提醒过我”“提醒一下自己要早睡”)不激活;其他 SKILL 完成任务后也不自动入队,要学生当轮说“要”。提醒内容本身不在这里生成——错题由错题本、词卡由英语词汇 DNA、任务由 30 天学习计划提供,本 SKILL 只做排期、合并与发送。未获授权时只给“建议提醒方案”,不创建实际提醒,也不做闲置唤醒。

5 次安装

Read and write the signed-in user's Microsoft 365 / Outlook.com personal calendar via Microsoft Graph. Calendar API surface only — but note: this skill shares one device-code login with the outlook-contacts and outlook-todo skills, so the shared consent also grants their Calendars/Tasks/Contacts read-write scopes (fully disclosed in the Scope table below). Use when the user wants to list today's events, look at next week, create / update / delete a single event by id, or check token status. Trigger keywords: "outlook calendar", "ms calendar", "graph calendar", "我的 outlook 日历", "微软日历".

核心能力: 日程管理领域的专业化 AI 辅助工具,提供核心基础功能支持. 适用场景: 个人用户与轻量级场景,涵盖日常操作、自动化工作流与智能决策辅助. 差异化: FREE 版本,面向个人用户提供核心功能、简洁操作与社区支持. 适用关键词: calendar, 日历, 同步, 日程, 事件, 提醒, 跨平台

1 次安装