mcpField
R
reminder-scheduler

reminder-scheduler

github.com/cklxx生産性11111 回インストール31 週間前に更新
リポジトリ

reminder-scheduler について

単発リマインダーと定期プランを管理するスキルおよび Python コマンドラインツールです。作成、一覧表示、取消・削除、期限到来の確認、実行後の次回予定への更新に対応します。

主な機能

  1. 01遅延付き単発リマインダーの設定
  2. 02単発リマインダーの一覧と取消
  3. 03定期プランの作成と更新
  4. 04プランの一覧と削除
  5. 05期限到来プランの確認
  6. 06次回実行時刻の更新

活用シーン

  1. 01後で通知するリマインダーの設定
  2. 02週次振り返りリマインダーの管理
  3. 03期限が来た定期プランの確認
  4. 04通知実行後のプラン更新

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cklxx/elephant.ai --skill reminder-scheduler

インストール後、Claude Code で/reminder-schedulerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

run.py
tests/
__init__.py
test_reminder_scheduler.py

詳細

プロジェクトの README より

reminder-scheduler

一个 skill 同时覆盖两类能力:

  • 单次提醒:延迟触发(如 30 分钟后提醒)
  • 周期计划:维护长期提醒计划(如每周复盘)

调用

# 单次提醒:设置、查看、取消
python3 skills/reminder-scheduler/run.py set_once --delay 30m --task "喝水提醒"
python3 skills/reminder-scheduler/run.py list_once
python3 skills/reminder-scheduler/run.py cancel_once --id timer-12345

# 周期计划:创建/更新、查看、删除、到期扫描、执行后推进
python3 skills/reminder-scheduler/run.py upsert_plan --name weekly-retro --schedule "0 18 * * 5" --task "发送复盘提醒" --next-run-at 2026-03-06T10:00:00Z
python3 skills/reminder-scheduler/run.py list_plans
python3 skills/reminder-scheduler/run.py due_plans --now 2026-03-06T10:00:00Z
python3 skills/reminder-scheduler/run.py delete_plan --name weekly-retro
python3 skills/reminder-scheduler/run.py touch_plan --name weekly-retro --next-run-at 2026-03-13T10:00:00Z

参数

set_once
参数类型必填说明
delaystring是延迟时间(30s / 5m / 2h)
taskstring是提醒内容
cancel_once
参数类型必填说明
idstring是单次提醒 ID
upsert_plan
参数类型必填说明
namestring是计划名(唯一键)
schedulestring是周期表达式(cron 字符串)
taskstring是提醒内容
next_run_atstring否下一次执行时间(ISO8601)
channelstring否渠道,默认 lark
enabledbool否是否启用,默认 true
metadataobject否扩展元数据
list_plans

无参数,返回当前所有周期计划。

delete_plan
参数类型必填说明
namestring否计划名;与 id 至少提供一个
idstring否计划 ID;与 name 至少提供一个

当同时提供 name 和 id 时,必须命中同一条记录才会删除。

due_plans
参数类型必填说明
nowstring否当前时间(ISO8601);未提供时取系统 UTC 时间
touch_plan
参数类型必填说明
namestring否计划名;与 id 至少提供一个
idstring否计划 ID;与 name 至少提供一个
next_run_atstring否更新下一次执行时间(ISO8601)

当同时提供 name 和 id 时,必须命中同一条记录才会更新。

コメント