Agent Skills
› sediman-agent/OpenSkynet
› principle-make-operations-idempotent
principle-make-operations-idempotent
GitHub指导设计具备幂等性的命令、生命周期步骤及处理循环，确保在崩溃、重启和重试场景下能收敛至相同终态。涵盖状态扫描、内容清理、自愈合锁及调度策略，提升系统鲁棒性。
触发场景
设计易受中断影响的后台任务
编写需要重试机制的命令或脚本
优化分布式系统中的状态一致性
安装
npx skills add sediman-agent/OpenSkynet --skill principle-make-operations-idempotent -g -y
SKILL.md
Frontmatter
{
"name": "principle-make-operations-idempotent",
"description": "Apply when designing commands, lifecycle steps, or processing loops that run amid crashes, restarts, and retries. Converge to the same end state regardless of partial prior runs.",
"disable-model-invocation": true
}
Make Operations Idempotent
Design operations so they converge to the correct state regardless of how many times they run or where they start from. Every state-mutating operation should answer: "What happens if this runs twice? What happens if the previous run crashed halfway?"
Why: Commands, lifecycle operations, and processing loops run where crashes, restarts, and retries are normal. If partial state changes the next run's outcome, every restart becomes a debugging session.
The pattern:
- Convergent startup: scan for existing state, clean stale artifacts, adopt live sessions
- Content-based cleanup: compare by content equivalence, not creation order
- Self-healing locks: use PID-based stale lock detection
- Idempotent scheduling: failed work respawns cleanly, fresh input regenerated after each cycle
The test:
- What happens if this runs twice in a row?
- What happens if the previous run crashed at every possible point?
- Does re-execution converge to the same end state?
If any answer is "it depends on what state was left behind," the operation needs a reconciliation step.
版本历史
- c9d8953 当前 2026-07-05 19:53
