Skip to content

An always-on second brain you talk to. Voice notes in Telegram → typed, linked knowledge in your Obsidian vault. Runs 24/7 on the Claude subscription you already have.

feat(cron): skill for natural-language job management

smixs48d900f5b4e4
diff --git a/tests/test_cron_skill_contract.py b/tests/test_cron_skill_contract.py
new file mode 100644
index 0000000..726fed8
--- /dev/null
+++ b/tests/test_cron_skill_contract.py
@@ -0,0 +1,29 @@
+"""Contract test for the cron skill: the brain learns to manage its own
+schedule from this file, so its key invariants are pinned here."""
+
+from pathlib import Path
+
+SKILL = Path(__file__).parent.parent / "vault/.claude/skills/cron/SKILL.md"
+
+
+def test_skill_exists():
+ assert SKILL.exists()
+
+
+def test_skill_teaches_the_cli():
+ text = SKILL.read_text()
+ assert "python -m d_brain.cron" in text
+ for cmd in ("add", "list", "remove", "enable"):
+ assert cmd in text
+
+
+def test_skill_pins_oneshot_and_silent_conventions():
+ text = SKILL.read_text()
+ assert "--delete-after-run" in text
+ assert "[SILENT]" in text
+
+
+def test_skill_forbids_sleep_emulation_and_recursion():
+ text = SKILL.read_text().lower()
+ assert "sleep" in text # the "never emulate schedules with sleep" rule
+ assert "cron job" in text # the recursion-guard rule references the marker
diff --git a/vault/.claude/skills/cron/SKILL.md b/vault/.claude/skills/cron/SKILL.md
new file mode 100644
index 0000000..05dfc9e
--- /dev/null
+++ b/vault/.claude/skills/cron/SKILL.md
@@ -0,0 +1,66 @@
+---
+name: cron
+description: Управление собственным расписанием — напоминания, рутины, периодические задачи. Триггеры — "напомни", "каждый день/час/утро", "по расписанию", "schedule", "reminder", "отмени напоминание", "что запланировано".
+---
+
+# Cron: расписания и напоминания
+
+Ты управляешь своим расписанием сам — через CLI, который редактирует
+`jobs.json`. Бот перечитывает файл каждую минуту и запускает задания в
+отдельной cron-сессии. Результат запуска уходит пользователю в Telegram.
+
+## Команды
+
+Рабочая директория — vault, проект уровнем выше (`--project ..`):
+
+```bash
+# Повторяющееся по cron-выражению (время — местное, указывай --tz)
+uv run --project .. python -m d_brain.cron add \
+ --prompt "Собери утреннюю сводку: вчерашний daily, goals недели" \
+ --cron "0 9 * * *" --tz Asia/Tashkent --id morning-brief
+
+# Интервал в секундах
+uv run --project .. python -m d_brain.cron add \
+ --prompt "Проверь inbox в vault, новое разложи по карточкам. Если пусто — начни ответ с [SILENT]" \
+ --every 3600
+
+# Разовое напоминание: ВСЕГДА --at + --delete-after-run
+uv run --project .. python -m d_brain.cron add \
+ --prompt "Напомни про звонок с подрядчиком" \
+ --at "2026-06-12T18:00:00+05:00" --delete-after-run
+
+uv run --project .. python -m d_brain.cron list
+uv run --project .. python -m d_brain.cron remove <id>
+uv run --project .. python -m d_brain.cron enable <id> # вернуть авто-отключённый
+```
+
+Ошибка → exit 2 и текст в stderr: прочитай и исправь аргументы.
+
+## Перевод естественного языка в расписание
+
+| Просьба | Аргументы |
+|---|---|
+| «каждый день в 9» | `--cron "0 9 * * *" --tz <зона пользователя>` |
+| «по будням в 18:30» | `--cron "30 18 * * 1-5" --tz ...` |
+| «каждое воскресенье» | `--cron "0 10 * * 0" --tz ...` |
+| «каждый час» | `--every 3600` |
+| «каждые 15 минут» | `--every 900` |
+| «через 20 минут» | вычисли ISO-время: now+20m → `--at <ISO> --delete-after-run` |
+| «завтра в 15» | `--at "<завтра>T15:00:00+05:00" --delete-after-run` |
+
+## Правила
+
+1. **Никогда не эмулируй расписание** через `sleep`, циклы в Bash или
+ фоновые процессы — только этот CLI.
+2. Разовое («напомни…») — всегда `--at` + `--delete-after-run`.
+3. `--at` пиши со смещением зоны (`+05:00`); naive-время трактуется в `--tz`.
+4. **Prompt задания — самодостаточный**: исполняет отдельная сессия без
+ контекста текущего разговора. Включай в prompt всё нужное (пути, имена,
+ критерии).
+5. Мониторинговым заданиям («проверь и скажи, если что-то новое») вели в
+ prompt: «если ничего важного — начни ответ строкой [SILENT]» — тогда
+ пользователь не получит пустой спам.
+6. **Recursion guard**: если текущий запрос сам помечен `[CRON JOB ...]` —
+ ты внутри планового запуска; создавать/менять/удалять задания ЗАПРЕЩЕНО.
+7. После add/remove подтверди пользователю результат строкой из `list`
+ (id, расписание, next run).