cron-scheduling — скилл для Claude Code: расписания и установка
Скилл cron-scheduling для Claude Code помогает задавать cron-расписания и планировать фоновые задачи в Node.js, Java и Python. Описывает периодические запуски и распределённое планирование.
MIT 162 установок ★ 50 обновлён 2026-10-23
npx skills add claude-dev-suite/claude-dev-suite --skill cron-scheduling -a claude-codeЧто делает cron-scheduling
Скилл разбирает синтаксис cron и показывает, как задавать расписания для node-cron, Spring @Scheduled и APScheduler. В материалах есть примеры запуска по времени, через фиксированный интервал и после завершения предыдущего запуска, включая настройку часового пояса.
Отдельно разобраны распределённые блокировки через Redlock и ShedLock, обработка ошибок, журналирование, мониторинг времени выполнения и корректное завершение. Для нескольких инстансов без Redlock или ShedLock одна задача может запуститься повторно. Долгие операции с очередями предлагается выносить в job-queues, а не держать внутри cron-задачи.
Какие задачи решает
- составить cron-выражение для периодического запуска
- настроить расписание в
node-cron - добавить запуск задач через Spring
@Scheduled - запланировать асинхронную работу в APScheduler
- предотвратить дублирование запусков между инстансами
Примеры запросов агенту
- Составь cron-выражение для запуска очистки по будням в 9:00.
- Добавь в сервис на Node.js задачу через
node-cron, которая синхронизирует данные каждые 5 минут. - Покажи, как защитить почасовой отчёт от параллельного запуска через Redlock.
Как установить cron-scheduling
1Через Skills CLI (Vercel)
npx skills add claude-dev-suite/claude-dev-suite --skill cron-scheduling -a claude-code2Вручную: положить файлы
~/.claude/skills/cron-scheduling/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cron-scheduling/
1Через Skills CLI (Vercel)
npx skills add claude-dev-suite/claude-dev-suite --skill cron-scheduling -a codex2Вручную: положить файлы
.agents/skills/cron-scheduling/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add claude-dev-suite/claude-dev-suite --skill cron-scheduling -a cursor2Вручную: положить файлы
.cursor/skills/cron-scheduling/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install claude-dev-suite/claude-dev-suite skills/infrastructure/cron-scheduling2Вручную: положить файлы
.github/skills/cron-scheduling/SKILL.md1Через Skills CLI (Vercel)
npx skills add claude-dev-suite/claude-dev-suite --skill cron-scheduling -a gemini-cli2Командой платформы
gemini skills install https://github.com/claude-dev-suite/claude-dev-suite --path skills/infrastructure/cron-schedulingВручную: положить файлы
.devin/skills/cron-scheduling/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add claude-dev-suite/claude-dev-suite --skill cron-scheduling -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о cron-scheduling
Как установить cron-scheduling в Claude Code?
Выполните npx skills add claude-dev-suite/claude-dev-suite --skill cron-scheduling -a claude-code. Файл скилла находится по пути ~/.claude/skills/cron-scheduling/SKILL.md.
Что делает cron-scheduling?
Скилл помогает проектировать cron-выражения и расписания для node-cron, Spring @Scheduled и APScheduler. Он также показывает схемы блокировок Redlock и ShedLock для распределённых запусков.
Как избежать повторного запуска cron-задачи на нескольких инстансах?
Используйте распределённую блокировку: Redlock для Node.js или ShedLock для Spring. Без блокировки несколько инстансов могут выполнить одну задачу одновременно.
Исходный текст
SKILL.md · MIT
---
name: cron-scheduling
description: |
Cron and scheduled task management. node-cron, cron expressions, Spring
@Scheduled, APScheduler (Python), and distributed scheduling patterns.
USE WHEN: user mentions "cron", "scheduled task", "cron job", "node-cron",
"@Scheduled", "APScheduler", "periodic task", "crontab"
DO NOT USE FOR: job queues with workers - use `job-queues`;
one-off delayed tasks - use `job-queues`
allowed-tools: Read, Grep, Glob, Write, Edit
---
# Cron Scheduling
## Cron Expression Syntax
```
┌─────── minute (0-59)
│ ┌────── hour (0-23)
│ │ ┌───── day of month (1-31)
│ │ │ ┌──── month (1-12)
│ │ │ │ ┌─── day of week (0-7, 0 and 7 = Sunday)
│ │ │ │ │
* * * * *
```
| Expression | Schedule |
|------------|----------|
| `0 * * * *` | Every hour |
| `*/15 * * * *` | Every 15 minutes |
| `0 9 * * 1-5` | Weekdays at 9:00 AM |
| `0 0 1 * *` | First day of month, midnight |
| `0 */6 * * *` | Every 6 hours |
## Node.js (node-cron)
```typescript
import cron from 'node-cron';
// Run every day at 2:00 AM
cron.schedule('0 2 * * *', async () => {
console.log('Running daily cleanup...');
await cleanupExpiredSessions();
}, {
timezone: 'America/New_York',
});
// Run every 5 minutes
cron.schedule('*/5 * * * *', async () => {
await syncExternalData();
});
```
### With Distributed Locking (prevent duplicate runs)
```typescript
import { Redlock } from 'redlock';
const redlock = new Redlock([redis]);
cron.schedule('0 * * * *', async () => {
let lock;
try {
lock = await redlock.acquire(['cron:hourly-report'], 60000);
await generateHourlyReport();
} catch (err) {
if (err instanceof Redlock.LockError) return; // Another instance has the lock
throw err;
} finally {
await lock?.release();
}
});
```
## Spring @Scheduled (Java)
```java
@Component
@EnableScheduling
public class ScheduledTasks {
@Scheduled(cron = "0 0 2 * * *") // Daily at 2 AM
public void dailyCleanup() {
sessionRepo.deleteExpired();
}
@Scheduled(fixedRate = 300000) // Every 5 minutes
public void syncData() {
externalService.sync();
}
@Scheduled(fixedDelay = 60000) // 60s after last completion
public void processQueue() {
queueService.processNext();
}
}
```
### Distributed Scheduling (ShedLock)
```java
@Scheduled(cron = "0 */10 * * * *")
@SchedulerLock(name = "syncInventory", lockAtLeastFor = "5m", lockAtMostFor = "10m")
public void syncInventory() {
inventoryService.syncAll();
}
```
## Python (APScheduler)
```python
from apscheduler.schedulers.asyncio import AsyncIOScheduler
from apscheduler.triggers.cron import CronTrigger
scheduler = AsyncIOScheduler()
@scheduler.scheduled_job(CronTrigger(hour=2, minute=0))
async def daily_cleanup():
await cleanup_expired_sessions()
@scheduler.scheduled_job('interval', minutes=5)
async def sync_data():
await sync_external_data()
scheduler.start()
```
## Anti-Patterns
| Anti-Pattern | Fix |
|--------------|-----|
| Cron on multiple instances without locking | Use distributed lock (Redlock, ShedLock) |
| Long-running cron blocks next run | Use job queue for heavy work |
| No error handling in cron | Wrap in try-catch, log errors, alert |
| Hardcoded schedule | Use environment variable or config |
| No monitoring of cron execution | Log start/end times, track failures |
## Production Checklist
- [ ] Distributed locking for multi-instance deployments
- [ ] Error handling with alerting
- [ ] Execution time monitoring
- [ ] Timezone explicitly set
- [ ] Graceful shutdown (finish current job)
- [ ] Cron expressions documented
© claude-dev-suite · MIT · claude-dev-suite/claude-dev-suite