Smart Task Scheduler

智能任务与排班管理系统，支持多时段工作安排、动态排班和上班时间自适应提醒

Install

openclaw skills install smart-task-scheduler

智能任务与排班管理系统

一个先进的个人任务与排班管理系统，能根据您复杂的多时段工作安排动态调整提醒，支持从表格文件导入排班，并通过自然语言修改排班。

核心优势

多时段工作支持：完整支持"早"、"晚"、"早晚"等多种工作时段安排
排班自适应提醒：根据您每天实际的多个工作时段动态计算提醒时间
灵活提醒规则：支持基于特定工作时段开始前/后的提醒
表格导入：支持上传Excel/CSV排班表，自动解析并存储
自然语言修改：可通过对话直接修改排班信息
智能时段选择：为任务自动选择最合适的工作时段

功能特性

1. 多时段排班管理

多时段工作安排：支持单个时段、多个时段的复杂工作安排
排班表格导入：支持上传Excel/CSV文件，自动解析复杂排班信息
自然语言修改：通过对话直接修改特定日期的上班时间和时段安排
时段智能选择：为任务自动选择最合适的工作时段
排班查询：查询任意日期的排班信息和时段安排

2. 智能任务管理

动态提醒计算：根据当天实际工作时段计算提醒时间
多时段提醒规则：
- before_shift_start:X：指定时段开始前X分钟提醒
- after_shift_start:X：指定时段开始后X分钟提醒
- between_shifts:X：两个工作时段之间提前X分钟提醒
- fixed_time:HH:MM：固定时间提醒
时段自动匹配：根据任务描述自动推荐最合适的工作时段

3. 智能提醒系统

智能体对话提醒：在适当时间主动发起对话提醒，支持交互操作
时段关联提醒：为同一任务在不同时段设置不同提醒

工具接口

`import_schedule`

导入排班表

从Excel或CSV文件导入排班信息。文件格式需包含日期、工作时段等列。

参数：

file_path: (字符串) 排班表文件路径
format: (字符串) 文件格式，excel 或 csv

示例： /import_schedule /path/to/schedule.xlsx excel

`update_schedule`

更新排班信息

通过自然语言修改特定日期的排班信息。

参数：

date: (字符串) 要修改的日期，格式为 YYYY-MM-DD 或自然语言如"明天"、"下周一"
change_description: (字符串) 变更描述，如"明天上早晚班"、"周三晚班"

示例： /update_schedule 明天早晚班，9:30-11:30 和 16:00-21:30

`show_schedule`

查看排班

查看指定日期范围的排班信息。

参数：

start_date: (字符串，可选) 开始日期，默认为今天
end_date: (字符串，可选) 结束日期，默认为7天后
format: (字符串，可选) 输出格式，table(表格) 或 list(列表)

示例： /show_schedule 2026-04-01 2026-04-07 table

`add_smart_task`

添加智能任务

添加能根据排班动态调整提醒时间的任务。系统会根据任务类型和时段自动选择最合适的提醒时段。

参数：

description: (字符串) 任务描述
due_date: (字符串) 截止日期，格式为 YYYY-MM-DD 或自然语言
reminder_rule: (字符串) 提醒规则，支持：
- before_first_shift:30 (第一时段开始前30分钟)
- after_first_shift_start:15 (第一时段开始后15分钟)
- before_second_shift:30 (第二时段开始前30分钟)
- between_shifts:60 (两时段之间提前60分钟)
- fixed_time:14:00 (固定时间)
task_type: (字符串，可选) 任务类型，帮助系统选择时段，如morning_task, between_shift_task, evening_task
priority: (字符串，可选) 优先级，high/medium/low

示例： /add_smart_task 买早餐明天 before_first_shift:20 high morning_task

`calculate_reminders`

计算提醒时间

为所有任务计算基于排班的实际提醒时间。

参数：

date: (字符串，可选) 计算指定日期的提醒，默认为明天

示例： /calculate_reminders 2026-04-01

配置要求

环境变量

飞书应用配置 (必需)

FEISHU_APP_ID=your_app_id

FEISHU_APP_SECRET=your_app_secret

文件路径配置 (可选)

SCHEDULE_FILE_PATH=/path/to/schedule.json

TASKS_FILE_PATH=/path/to/tasks.json

定时任务配置

创建以下定时任务以实现自动化：

每日排班同步（每晚22:00运行，同步明天的排班和任务）：

openclaw cron add \

--name "每日排班同步" \

--cron "0 22 * * *" \

--tz "Asia/Shanghai" \

--session isolated \

--message "请执行以下操作：1. 调用'smart-task-scheduler'技能的'calculate_reminders'功能，为明天的任务计算基于排班的提醒时间。2. 返回执行摘要，格式：[排班同步] 已为X个任务计算提醒时间。明天的工作时段是：Z。" \

--announce \

--agent smart-task-scheduler

时段智能提醒（根据实际工作时段的开始时间动态触发）：

openclaw cron add \

--name "工作时段提醒" \

--cron "0 7,9,13,15,20 * * 1-5" \

--tz "Asia/Shanghai" \

--session main \

--system-event "请检查当前时间是否需要触发提醒。调用'smart-task-scheduler'技能的'check_shift_reminders'功能，如果当前时间接近任何任务的提醒时间，在对话中提醒我。" \

--wake hourly \

--agent smart-task-scheduler

数据结构

1. 多时段排班表 (`workspace/work_schedule.json`)

json

{

"schedule": [

{

"date": "2026-04-01",

"work_shifts": [

{

"shift_type": "晚班",

"start": "15:30",

"end": "22:30",

"shift_index": 0

}

"notes": "周三晚班",

"tags": ["晚班"]

{

"date": "2026-04-02",

"work_shifts": [

{

"shift_type": "早班",

"start": "09:30",

"end": "11:30",

"shift_index": 0

{

"shift_type": "晚班",

"start": "16:00",

"end": "21:30",

"shift_index": 1

}

"notes": "周四早晚班",

"tags": ["早晚班", "多时段"]

{

"date": "2026-04-03",

"work_shifts": [

{

"shift_type": "早班",

"start": "08:00",

"end": "15:30",

"shift_index": 0

}

"notes": "周五早班",

"tags": ["早班"]

}

"default_schedule": {

"work_shifts": [

{

"shift_type": "标准班",

"start": "09:30",

"end": "18:30",

"shift_index": 0

}

]

"shift_types": {

"早班": {"typical_start": "08:00", "typical_end": "16:00"},

"晚班": {"typical_start": "15:00", "typical_end": "23:00"},

"早晚班": {"description": "分早晚两个时段"}

"last_updated": "2026-03-31T14:20:00Z"

}

2. 智能任务文件 (`workspace/smart_tasks.json`)

json

{

"smart_tasks": [

{

"id": "st_20260401_001",

"description": "上班前买晚餐食材",

"due_date": "2026-04-01",

"reminder_rule": "before_shift_start:60",

"target_shift": 0,

"target_shift_type": "晚班",

"calculated_time": "2026-04-01 14:30",

"priority": "high",

"completed": false,

"notes": "超市17点关门，记得下班前去"

{

"id": "st_20260402_001",

"description": "两班之间去银行",

"due_date": "2026-04-02",

"reminder_rule": "between_shifts:30",

"calculated_time": "2026-04-02 11:30", // 第一时段结束后，第二时段开始前

"priority": "medium",

"completed": false,

"recurring_source": "weekly_bank"

{

"id": "st_20260402_002",

"description": "早班后去健身房",

"due_date": "2026-04-02",

"reminder_rule": "after_shift_end:15",

"target_shift": 0,

"calculated_time": "2026-04-02 11:45",

"priority": "medium"

}

"recurring_rules": [

{

"id": "weekly_bank",

"description": "每周银行办事",

"cycle": "weekly",

"cycle_config": {"day_of_week": 4}, // 周四

"reminder_rule": "between_shifts:30",

"shift_preference": "between_shifts",

"active": true

}

"settings": {

"feishu_reminder_minutes": 10,

"default_shift_type": "标准班",

"timezone": "Asia/Shanghai"

}

3. Excel/CSV排班表格式

支持多种格式，最推荐格式如下：

推荐格式：

日期	班次类型	时段1开始	时段1结束	时段2开始	时段2结束	备注
2026-04-01	晚班	15:30	22:30			周三晚班
2026-04-02	早晚班	09:30	11:30	16:00	21:30	周四早晚班
2026-04-03	早班	08:00	15:30			周五早班

简化格式（单时段自动解析）：

日期	排班描述	备注
2026-04-01	晚（15:30-22:30）	周三晚班
2026-04-02	早晚（9:30-11:30 16:00-21:30）	周四早晚班
2026-04-03	早（8:00-15:30）	周五早班

自动解析规则：

"早（8:00-15:30）" → 解析为早班，时段：08:00-15:30
"晚（15:30-22:30）" → 解析为晚班，时段：15:30-22:30
"早晚（9:30-11:30 16:00-21:30）" → 解析为两个时段：09:30-11:30 和 16:00-21:30

使用示例

场景一：上传多时段排班表

准备排班表（Excel格式，使用推荐格式）
上传排班表：用户：帮我上传这个月的排班表

（用户发送排班表文件）

技能：/import_schedule /path/to/uploaded/schedule.xlsx excel

（解析并存储排班信息，自动识别多时段）

场景二：设置基于不同时段的提醒

晚班前的任务：

用户：明晚上晚班，下午3点提醒我去超市

技能：检测到明天是晚班（15:30-22:30）。/add_smart_task 去超市采购明天 before_shift_start:30

（自动计算：15:30前30分钟 = 15:00提醒）

早晚班之间的任务：

用户：周四早晚班之间提醒我去银行

技能：检测到周四是早晚班（09:30-11:30 和 16:00-21:30）。/add_smart_task 去银行办事 2026-04-02 between_shifts:30

（自动计算：第一时段结束后，第二时段开始前30分钟 = 11:30提醒）

早班后的任务：

用户：周五早班后提醒我去健身房

技能：检测到周五是早班（08:00-15:30）。/add_smart_task 健身房锻炼 2026-04-03 after_shift_end:15

（自动计算：15:30后15分钟 = 15:45提醒）

场景三：自然语言修改多时段排班

用户：下周三改成早晚班

技能：/update_schedule 2026-04-08 早晚班，时段1：9:30-11:30，时段2：16:00-21:30

（更新2026-04-08的work_shifts为两个时段）

用户：下周四的晚班时间改成16:30开始

技能：/update_schedule 2026-04-09 晚班，16:30-23:00

（更新2026-04-09的晚班开始时间）

用户：查看下周排班

技能：/show_schedule 2026-04-06 2026-04-12 table

（以表格形式显示下周排班）

场景四：自动时段匹配

用户：添加每周四的午间提醒任务

技能：系统会检查周四的排班：

如果是早晚班：建议在between_shifts时段提醒

如果是单时段班：建议在午休时间（12:00-13:00）提醒

会询问：您希望将提醒设置在哪个时段？

提醒计算逻辑

1. 时段选择策略

系统根据任务类型和排班自动选择最合适的时段：

任务类型/时间	单时段（早班）	单时段（晚班）	多时段（早晚班）
早晨任务	before_shift_start	before_shift_start	before_first_shift_start
午间任务	fixed_time:12:00	fixed_time:12:00	between_shifts
晚间任务	after_shift_end	before_shift_start	before_second_shift_start
休息日任务	fixed_time:09:00	fixed_time:09:00	fixed_time:09:00

2. 时间计算示例

早晚班（09:30-11:30，16:00-21:30）：
- before_first_shift_start:30 → 09:00提醒
- between_shifts:60 → 11:30提醒（第一时段结束后，第二时段开始前60分钟）
- before_second_shift_start:15 → 15:45提醒
- after_second_shift_end:30 → 22:00提醒
晚班（15:30-22:30）：
- before_shift_start:45 → 14:45提醒
- after_shift_start:60 → 16:30提醒
- after_shift_end:30 → 23:00提醒

注意事项

多时段处理：对于早晚班，系统会识别两个时段之间的间隔，between_shifts规则会自动在两时段之间设置提醒。
时段索引：shift_index从0开始，0表示第一个工作时段，1表示第二个工作时段。
自动时段选择：如果不指定具体时段，系统会根据任务描述和时间自动选择最合适的时段。
休息日处理：如果某天没有排班记录，视为休息日，使用默认的固定时间提醒。
时间冲突检测：如果计算的提醒时间与工作时间冲突，系统会自动调整。

故障排除

排班表导入失败：
1. 检查文件格式是否为支持的Excel(.xlsx/.xls)或CSV
2. 确认时间格式为HH:MM（24小时制）
3. 多时段排班确保时段之间不重叠
提醒时间计算错误：
1. 检查当天的排班记录是否包含正确的工作时段
2. 确认提醒规则语法正确
3. 对于多时段，确保指定了正确的shift_index
自然语言修改不生效：
1. 确保时段描述清晰，如"早晚班"或具体时间"9:30-11:30 16:00-21:30"
2. 修改后使用/show_schedule确认修改已生效

提示：对于多时段工作，建议先用/show_schedule查看排班，再根据实际时段设置提醒规则。

Smart Task Scheduler

Install

智能任务与排班管理系统

核心优势

功能特性

1. 多时段排班管理

2. 智能任务管理

3. 智能提醒系统

工具接口

import_schedule

update_schedule

show_schedule

add_smart_task

calculate_reminders

配置要求

环境变量

定时任务配置

数据结构

1. 多时段排班表 (workspace/work_schedule.json)

2. 智能任务文件 (workspace/smart_tasks.json)

3. Excel/CSV排班表格式

使用示例

场景一：上传多时段排班表

场景二：设置基于不同时段的提醒

场景三：自然语言修改多时段排班

场景四：自动时段匹配

提醒计算逻辑

1. 时段选择策略

2. 时间计算示例

注意事项

故障排除

Related skills

`import_schedule`

`update_schedule`

`show_schedule`

`add_smart_task`

`calculate_reminders`

1. 多时段排班表 (`workspace/work_schedule.json`)

2. 智能任务文件 (`workspace/smart_tasks.json`)