Claude
Skill
{job-name}
定时任务执行技能:有状态、幂等、可断点恢复
Download
komagon-hermes-production-patterns-starter-kits_cron-production-ae842b1.zip · 5 KB
Install
skills CLI
npx skills add https://github.com/Komagon/hermes-production-patterns/tree/main/starter-kits/cron-production
Claude Code
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install komagon-hermes-production-patterns@llmmart
Git
git clone https://github.com/Komagon/hermes-production-patterns.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole komagon/hermes-production-patterns collection as a plugin from our marketplace. Git is the plain clone.
README
Cron Production Agent Starter Kit
定时自主运行的 Agent:可靠触发 + 状态 + 断点 + 错误压缩 + 监控。 适合:每日/每周定时任务,失败必须可发现、可恢复。
Patterns Used
| Pattern | 文件 | 作用 |
|---|---|---|
| Cron Job | cron-config.example |
幂等、防重复、防静默失败的调度 |
| State File | STATE.md |
跨运行进度与幂等键 |
| Checkpoint | recovery/ |
中断后从断点恢复 |
| Error Compact | recovery/error_compact.py |
失败不污染上下文 |
| Monitor | monitor/ |
失败可观测,不静默 |
安装
cp -r starter-kits/cron-production ~/my-cron-agent
cd ~/my-cron-agent
# 1. 编辑 cron-config.example 里的 schedule / prompt / skills
# 2. 复制为真实调度配置(Hermes cron 或系统 crontab)
# 3. 按 STATE.md 模板初始化状态
三段式设计(Pre-flight / Execute / Post-flight)
Pre-flight 读 STATE → 幂等键查重 → 确认本批未处理
Execute 按 SKILL 执行 → 每步写回 STATE(检查点)
Post-flight 汇总结果 → Monitor 记录成败 → 失败进入 recovery
验证
- 手动重跑不产生重复数据(幂等键生效)
- 中途 kill 后从断点恢复,不重头跑
- 失败时 Monitor 有记录/告警,不静默
- 错误以压缩摘要进上下文,非全文
Skill manifest
执行协议
Pre-flight(幂等闸门)
- 读 STATE.md,取 Idempotency Keys
- 生成本轮 key
{job}-{YYYYMMDD}-{batch} - 若 key 已存在 → 本轮已处理,直接退出
Execute(带检查点)
- 执行主逻辑,每处理
CHECKPOINT_EVERY个单元写回 STATE.md - 中间产物落盘
reports/{date}/,不占上下文
Post-flight
- 汇总结果 → 写 STATE.md(进度 + 本轮 key)
- Monitor 记录成功;失败 → error_compact 压缩 → recovery 重试
陷阱
- 无幂等键直接跑 → 重跑即重复
- 失败静默 → Monitor 必须记录
- 错误全文进上下文 → 先压缩
Files (hermes-production-patterns)
-
monitor
-
README.md 412 B
Loading… -
runs.log 152 B · in bundle
-
-
recovery
-
error_compact.py 1.1 KB
Loading… -
README.md 450 B
Loading…
-
-
tests
-
test_idempotency.py 427 B
Loading…
-
-
cron-config.example 596 B · in bundle
-
README.md 1.3 KB
# Cron Production Agent Starter Kit > 定时自主运行的 Agent:可靠触发 + 状态 + 断点 + 错误压缩 + 监控。 > 适合:每日/每周定时任务,失败必须可发现、可恢复。 ## Patterns Used | Pattern | 文件 | 作用 | |:---|:---|:---| | Cron Job | `cron-config.example` | 幂等、防重复、防静默失败的调度 | | State File | `STATE.md` | 跨运行进度与幂等键 | | Checkpoint | `recovery/` | 中断后从断点恢复 | | Error Compact | `recovery/error_compact.py` | 失败不污染上下文 | | Monitor | `monitor/` | 失败可观测,不静默 | ## 安装 ```bash cp -r starter-kits/cron-production ~/my-cron-agent cd ~/my-cron-agent # 1. 编辑 cron-config.example 里的 schedule / prompt / skills # 2. 复制为真实调度配置(Hermes cron 或系统 crontab) # 3. 按 STATE.md 模板初始化状态 ``` ## 三段式设计(Pre-flight / Execute / Post-flight) ``` Pre-flight 读 STATE → 幂等键查重 → 确认本批未处理 Execute 按 SKILL 执行 → 每步写回 STATE(检查点) Post-flight 汇总结果 → Monitor 记录成败 → 失败进入 recovery ``` ## 验证 - [ ] 手动重跑不产生重复数据(幂等键生效) - [ ] 中途 kill 后从断点恢复,不重头跑 - [ ] 失败时 Monitor 有记录/告警,不静默 - [ ] 错误以压缩摘要进上下文,非全文 -
SKILL.md 890 B
--- maturity: experimental name: {job-name} description: 定时任务执行技能:有状态、幂等、可断点恢复 version: 1.0.0 triggers: - "scheduled: {job-name}" tools: - terminal - read_file - write_file - process mutating: true --- # {Job Name} ## 执行协议 ### Pre-flight(幂等闸门) 1. 读 STATE.md,取 Idempotency Keys 2. 生成本轮 key `{job}-{YYYYMMDD}-{batch}` 3. 若 key 已存在 → 本轮已处理,直接退出 ### Execute(带检查点) 1. 执行主逻辑,每处理 `CHECKPOINT_EVERY` 个单元写回 STATE.md 2. 中间产物落盘 `reports/{date}/`,不占上下文 ### Post-flight 1. 汇总结果 → 写 STATE.md(进度 + 本轮 key) 2. Monitor 记录成功;失败 → error_compact 压缩 → recovery 重试 ## 陷阱 - 无幂等键直接跑 → 重跑即重复 - 失败静默 → Monitor 必须记录 - 错误全文进上下文 → 先压缩 -
STATE.md 569 B
Loading…
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.