核心用途
cron-worker-guardrails 是一套针对 OpenClaw 隔离型 cron 任务（agentTurn）的可靠性加固技能。它聚焦于解决无人值守自动化中最常见的故障模式：多行 bash -lc 引号转义失败（unexpected EOF）、命令替换 $(...) 嵌套陷阱、pipefail 与 head 组合导致的 SIGPIPE 误报，以及环境/工作目录漂移造成的"本地正常、定时任务失败"现象。
显著优点
1. 脚本优先原则：强制要求复杂逻辑迁移至独立 Python 脚本，cron 仅保留单条短命令，从根本上消除 Shell 嵌套引号灾难。
2. 可复现执行环境：明确推荐 uv run --python 3.13 --frozen 模式，锁定依赖与 Python 版本，杜绝 ModuleNotFoundError 类故障。
3. 精准故障图谱：针对 4 类高频错误（EOF 引号、模块缺失、SIGPIPE 误报、rg 工具缺失）提供"症状→根因→修复模式"的快速对照。
4. 低噪音合约头：提供标准化的 2 行 hardening header，可直接嵌入 cron payload，建立防御性文档引用。
潜在局限
- 框架绑定较深：合约路径（
/root/.openclaw/workspace/...）与uv工具链假设对非 OpenClaw 用户可能需大量迁移改造。 - Python 生态偏向：对纯 Node.js/Rust 项目团队，Python 脚本优先的建议需额外适配。
- 无自动修复：仅为文档级 guardrails，不阻止错误代码生成，依赖开发者人工遵循。
适合人群
- 维护 OpenClaw
agentTurncron 任务的自动化工程师 - 遭遇"定时任务偶发失败"且根因不明的 SRE/运维人员
- 设计 Cron Agent 合约规范（AGENTS.md 风格）的架构师
常规风险
- 合规衰减风险：技能引用为 opt-in，开发者可能忽略 hardening header，导致防御失效。
- 路径漂移：合约文件若未版本锁定，文档与代码实现可能脱节。
- 过度简化：极端场景下"单条命令"限制可能迫使脚本膨胀，需权衡可读性与可靠性。