Claude Skill

{job-name}

定时任务执行技能:有状态、幂等、可断点恢复

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
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(幂等闸门)

  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 必须记录
  • 错误全文进上下文 → 先压缩
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.

No comments yet.

Reviews (0)

No reviews yet.