using-cron

Manage scheduled tasks — create, query, update, and delete. CRITICAL - When user message contains any future time intent (e.g. "in 2 days", "tomorrow at 8am", "every morning"), you MUST load this skill first. NEVER write custom scheduler scripts.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Scheduled Message Task Management

Manage scheduled message tasks through scripts, supporting create, list, get, update, and delete operations.

Core Capabilities

Create one-time or recurring scheduled message tasks
Query and filter existing scheduled task lists
Get task details
Update task configuration (name, time, enabled status, etc.)
Delete tasks

Quick Start

Typical Workflow

1. Create task (create.py)
   ↓ Get returned schedule_id
2. Query list (list.py) - Optional
   ↓ Confirm task was created
3. Get details (get.py) - Optional
   ↓ View complete task info
4. Update task (update.py) - As needed
5. Delete task (delete.py) - As needed

Available Scripts

create.py - Create Scheduled Task

Create a new scheduled message task.

SYNOPSIS

python scripts/create.py --task-name <name> --message-content <content> --type <type> --time <HH:MM> [OPTIONS]

DESCRIPTION

Create a scheduled message task, supporting one-time execution and daily/weekly/monthly repeat modes.

When to pass --specify-topic 1: Pass 1 only when both hold: (1) the task is recurring (daily_repeat / weekly_repeat / monthly_repeat), and (2) the user intent implies that the next run time or trigger depends on the current or previous run's result (e.g. "run again 3 days after each completion", "next time based on last result"). For one-time tasks or fixed-schedule tasks that do not depend on previous results, omit this option or pass 0.

OPTIONS

Option	Type	Required	Description
`--task-name <name>`	string	Yes	Task name
`--message-content <content>`	string	Yes	Message content (same as detail message_content/task_describe)
`--type <type>`	string	Yes	Schedule type, see table below
`--time <HH:MM>`	string	Yes	Execution time
`--day <value>`	string	Conditional	Depends on schedule type, see table below
`--deadline <YYYY-MM-DD HH:MM:SS>`	string	No	Expiry datetime; format YYYY-MM-DD HH:MM:SS. If only date or unclear format is given, the system will interpret and complete (e.g. to 00:00:00 that day)
`--specify-topic <0\|1>`	integer	No	Whether to specify topic; 0=no, 1=yes; default 0. Pass 1 only when the user intent is a recurring task whose next run depends on the previous run's result; otherwise use default 0

Schedule type --type and --day mapping:

`--type`	Description	`--day`
`no_repeat`	No repeat, one-time execution	Execution date `YYYY-MM-DD` (required)
`daily_repeat`	Repeat daily	Not needed
`weekly_repeat`	Repeat weekly	Day of week `0`-`6`, `0`=Sunday (required)
`monthly_repeat`	Repeat monthly	Day of month `1`-`31` (required)

OUTPUT

On success: {"id": "<schedule_id>"}

EXAMPLES

python scripts/create.py \
  --task-name "每日早报" \
  --message-content "请生成今日早报" \
  --type daily_repeat \
  --time "9:00"

list.py - Query Task List

Query the scheduled task list with optional filtering.

SYNOPSIS

python scripts/list.py [OPTIONS]

DESCRIPTION

Query all scheduled tasks or filter by conditions, with pagination support. Results are scoped to the current project; project_id is taken from the current session and must not be passed.

OPTIONS

Option	Type	Required	Description
`--task-name <name>`	string	No	Fuzzy search by task name
`--enabled <0\|1>`	integer	No	`1`=enabled `0`=disabled
`--completed <0\|1>`	integer	No	`1`=completed `0`=not completed
`--page <n>`	integer	No	Page number, default 1
`--page-size <n>`	integer	No	Items per page, default 50

OUTPUT

On success: {"total": N, "schedules": [{"id": "...", "task_name": "...", "task_describe": "...", "status": "...", "enabled": 0|1, "time_config": {...}, "deadline": ...}]}. Each item includes: id, task_name, task_describe, status, enabled, time_config, deadline.

EXAMPLES

# 查询全部
python scripts/list.py

# 按条件过滤
python scripts/list.py --task-name "早报" --enabled 1 --completed 0

get.py - Get Task Details

Get the complete details of a specific scheduled task.

SYNOPSIS

python scripts/get.py --id <schedule_id>

DESCRIPTION

Query complete task information by task ID.

OPTIONS

Option	Type	Required	Description
`--id <schedule_id>`	string	Yes	Task ID

OUTPUT

On success: Returns complete task info including id, task_name, task_describe, message_content, time_config, status, enabled, deadline.

EXAMPLES

python scripts/get.py --id "<schedule_id>"

update.py - Update Task

Update the configuration of a specific scheduled task; only pass fields to be modified.

SYNOPSIS

python scripts/update.py --id <schedule_id> [OPTIONS]

DESCRIPTION

Update scheduled task configuration. Only pass fields to be modified; unspecified fields remain unchanged. --type and --time must be provided together.

OPTIONS

Option	Type	Required	Description
`--id <schedule_id>`	string	Yes	Task ID
`--task-name <name>`	string	No	New task name
`--message-content <content>`	string	No	Message content (same as detail message_content/task_describe)
`--type <type>`	string	No	Schedule type (must be provided with `--time`)
`--time <HH:MM>`	string	No	Execution time (must be provided with `--type`)
`--day <value>`	string	No	Date/weekday/day-of-month, depends on `--type`
`--deadline <YYYY-MM-DD HH:MM:SS>`	string	No	Expiry datetime; format YYYY-MM-DD HH:MM:SS, auto-completed if only date or unclear
`--enabled <0\|1>`	integer	No	`1`=enable `0`=disable

OUTPUT

On success: {"id": "<schedule_id>"}

EXAMPLES

# 修改任务名称
python scripts/update.py --id "<schedule_id>" --task-name "新名称"

# 修改任务详情
python scripts/update.py --id "<schedule_id>" --message-content "新的任务详情内容"

# 修改调度时间
python scripts/update.py --id "<schedule_id>" --type daily_repeat --time "10:00"

# 修改截止日期
python scripts/update.py --id "<schedule_id>" --deadline "2026-12-31 23:59:59"

# 禁用任务
python scripts/update.py --id "<schedule_id>" --enabled 0

# 重新启用任务
python scripts/update.py --id "<schedule_id>" --enabled 1

delete.py - Delete Task

Delete a specific scheduled task.

SYNOPSIS

python scripts/delete.py --id <schedule_id>

DESCRIPTION

Permanently delete a scheduled task by task ID.

OPTIONS

Option	Type	Required	Description
`--id <schedule_id>`	string	Yes	Task ID

OUTPUT

On success: {"id": "<schedule_id>"}

EXAMPLES

python scripts/delete.py --id "<schedule_id>"

Usage Examples

In Agent environment, use shell_exec tool to execute scripts:

# 创建任务
shell_exec(
    command='python scripts/create.py --task-name "每日早报" --message-content "请生成今日早报" --type daily_repeat --time "9:00"'
)

# 查询任务列表
shell_exec(
    command="python scripts/list.py"
)

# 获取任务详情
shell_exec(
    command='python scripts/get.py --id "<schedule_id>"'
)

# 更新任务
shell_exec(
    command='python scripts/update.py --id "<schedule_id>" --enabled 0'
)

# 删除任务
shell_exec(
    command='python scripts/delete.py --id "<schedule_id>"'
)

Repository: dtyq/magic
Path: backend/super-magic/agents/skills/using-cron/SKILL.md
Commit: 41d7ef4

Last updated: about 13 hours ago
First committed: 4 months ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.