mcpField
S
schedule-manager

schedule-manager

github.com/niracler生产力11179 次安装15 周前更新
代码仓库

关于 schedule-manager

Schedule Manager 是一项 macOS 技能，使用 osascript 和 reminders-cli 管理 Calendar 事件与 Reminders，并遵循 GTD 方法。它可整合日程、待办事项和可选的项目 YAML 数据，用于每周规划。

主要功能

  1. 01查看、创建和删除 Calendar 事件
  2. 02创建并完成 Reminders 待办
  3. 03区分固定时间事件与待办事项
  4. 04整合日历和提醒进行规划
  5. 05使用项目排期 YAML 制定周计划

适用场景

  1. 01将任务快速记录到 Reminders
  2. 02在 Calendar 中安排会议
  3. 03通过时间块规划一天
  4. 04回顾一周并检查项目产能

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/niracler/skill --skill schedule-manager

安装后在 Claude Code 中输入/schedule-manager确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
gtd-methodology.md
osascript-calendar.md
osascript-reminders.md
reminders-cli-guide.md
scripts/
check_dependencies.sh
check_permissions.sh

详细介绍

来自项目 README

Schedule Manager

通过 osascript (Calendar) 和 reminders-cli (Reminders) 管理日程，遵循 GTD 方法论。

Prerequisites

ToolTypeRequiredInstall
macOSsystemYesThis skill requires macOS
osascriptcliYesBuilt-in on macOS
reminders-clicliYesbrew install keith/formulae/reminders-cli
Schedule YAMLdataNo~/code/*/planning/schedules/*.yaml — for cross-project weekly planning

Do NOT proactively verify these tools on skill load. If a command fails due to a missing tool, directly guide the user through installation and configuration step by step.

权限配置

首次运行需要授权，进入系统设置 → 隐私与安全性：

  1. 日历 - 勾选 Terminal / iTerm / 你使用的终端应用
  2. 提醒事项 - 同上

⚠️ 修改权限后需重启终端应用

核心原则（GTD 风格）

工具用途示例
Calendar固定时间承诺会议、约会、截止日期
Reminders待办事项（无固定时间）购物清单、任务、想法

决策流程：

有具体时间？ → Calendar 事件
无具体时间？ → Reminders 待办
需要提醒？ → 两者都可设置提醒

模式选择

用户意图模式操作
「安排会议」「创建事件」Calendar创建带时间的事件
「添加待办」「创建提醒」「记一下」Reminders创建任务
「查看日程」「今天有什么」查询查询 Calendar + Reminders
「规划下周」「周回顾」规划综合工作流

Calendar 操作

通过 osascript 管理 Calendar 事件（查看、创建、删除）。

详见 osascript-calendar.md 获取完整命令模板。

Reminders 操作

推荐使用 reminders-cli（osascript 访问 Reminders 非常慢）。

常用命令速查：

reminders show-lists              # 查看列表
reminders show-all --due-date today  # 今日待办
reminders add "列表" "任务"         # 创建
reminders complete "列表" 0        # 完成

详见 reminders-cli-guide.md 获取完整命令参考。 osascript 备选见 osascript-reminders.md。

常见工作流

场景 1: 快速收集（GTD Capture）

用户说「记一下」「待会做」「别忘了」→ 创建 Reminder 到收件箱

reminders add "提醒" "<任务名>"
场景 2: 安排会议

用户说「安排明天下午 2 点的会议」→ 创建 Calendar 事件（使用 osascript）

场景 3: 每日规划
  1. 查看今日 Calendar 事件（osascript）
  2. 查看 Reminders 待办（reminders show-all）
  3. 为重要任务安排 Time Block（Calendar 事件）
场景 4: 周回顾（GTD Weekly Review）
  1. 查看本周完成的提醒
  2. 查看下周 Calendar 事件（osascript）
  3. 整理 Reminders 列表（reminders show-all）

详见 gtd-methodology.md。

场景 5: 跨项目周规划（需要 Schedule YAML）

当 ~/code/*/planning/schedules/*.yaml 存在时，「规划下周」工作流增加项目排期上下文：

  1. 扫描 ~/code/*/planning/schedules/*.yaml，解析每个文件的 project、timeline、capacity
  2. 查看下周 Calendar 已有事件（osascript）
  3. 查看 Reminders 待办（reminders show-all）
  4. 从 schedule YAML 中提取下周相关 module（按 weeks 字段匹配）
  5. 按 capacity.days_per_week 估算各项目时间分配
  6. 合并展示：Calendar 事件 + Reminders 待办 + 各项目模块任务
  7. 标注产能冲突（总分配 > 可用工作日）
  8. 建议 Calendar time block（展示建议，用户确认后创建）

无 Schedule YAML 时：跳过步骤 4-7，退化为标准的场景 4 周回顾流程。

常见错误

错误原因解决
AppleEvent timed out权限未授予在系统设置中授权
Can't get list列表不存在先用 reminders show-lists 查看可用列表
Invalid date日期格式错误使用 current date 作为基准
reminders: command not found未安装brew install keith/formulae/reminders-cli
osascript Reminders 卡顿已知性能问题改用 reminders-cli

评论

支持 Markdown