Agent Skills › DotHarness/dotcraft › cron

cron

GitHub

用于管理 DotCraft 定时任务，支持添加、列出和删除。涵盖一次性延迟、周期性间隔及每日固定时间三种调度模式，配置结果投递目标，并提供常见验证错误的恢复指南。

src/DotCraft.Core/Skills/BuiltIn/cron/SKILL.md DotHarness/dotcraft

触发场景

用户需要设置定时提醒或周期性后台任务用户希望查看当前所有已调度的 Cron 任务用户想要取消或删除某个已存在的定时任务

安装

npx skills add DotHarness/dotcraft --skill cron -g -y

更多选项

非标准路径

npx skills add https://github.com/DotHarness/dotcraft/tree/main/src/DotCraft.Core/Skills/BuiltIn/cron -g -y

不安装直接使用

npx skills use DotHarness/dotcraft@cron

指定 Agent (Claude Code)

npx skills add DotHarness/dotcraft --skill cron -a claude-code -g -y

安装 repo 全部 skill

npx skills add DotHarness/dotcraft --all -g -y

预览 repo 内 skill

npx skills add DotHarness/dotcraft --list

SKILL.md

Frontmatter

{
    "name": "cron",
    "description": "Use when scheduling, listing, removing, or troubleshooting DotCraft Cron jobs with the Cron tool; choose scheduleKind at, every, or daily, set required schedule fields, configure delivery, and recover from Cron validation errors."
}

Cron

Use Cron for scheduled background agent runs that should happen later or repeatedly. Do not use it for a short blocking wait inside the current turn.

Workflow

Choose action: add, list, or remove.
For add, always include scheduleKind.
Keep the schedule fields for the selected kind readable; ignore unrelated auto-filled schedule fields because scheduleKind is authoritative.
Use list before remove when you do not know the job id.

Add Jobs

Kind	Required fields	Optional fields	Use for
`at`	`message`, `delaySeconds`	`name`, `deliver`, `channel`, `toUser`	One-time delay jobs
`every`	`message`, `everySeconds`	`delaySeconds`, `name`, `deliver`, `channel`, `toUser`	Recurring interval jobs
`daily`	`message`, `dailyTime` or `dailyHour`	`dailyMinute`, `timeZone`, `name`, `deliver`, `channel`, `toUser`	Fixed local clock time jobs

Examples:

Cron(action: "add", scheduleKind: "at", message: "Remind me to check the build", delaySeconds: 600)
Cron(action: "add", scheduleKind: "every", message: "Summarize CI status", everySeconds: 3600)
Cron(action: "add", scheduleKind: "every", message: "Ping service", everySeconds: 3600, delaySeconds: 300)
Cron(action: "add", scheduleKind: "daily", message: "Prepare standup notes", dailyTime: "09:30", timeZone: "Asia/Hong_Kong")

Delivery

By default, deliver is true and DotCraft sends the run result back to the creator's current channel or session target. Set deliver: false only when the job should update state without notifying the user. Use channel and toUser only when the user explicitly wants a different delivery target.

List And Remove

Cron(action: "list")
Cron(action: "remove", jobId: "abc12345")

Validation Recovery

Missing scheduleKind: retry with at, every, or daily.
scheduleKind: "at" requires a positive delaySeconds.
scheduleKind: "every" requires a positive everySeconds; delaySeconds is only the first-run delay.
scheduleKind: "daily" requires dailyTime or dailyHour; dailyMinute defaults to 0.
Daily time zones should be IANA ids such as Asia/Hong_Kong; omitted means UTC.