Queue State Diff

该 Skill 对比前后两份队列或状态快照，用 Node 脚本执行确定性差异比较，识别数值漂移、缺失引用、新卡住任务和状态回归，并生成 Markdown 差异报告。

neo1307

热度 46.32

最近更新 2026-05-11 17:34:12

分类：数据依赖：代码执行 / 读写文件应用场景：数据处理 / 报告撰写 / DevOps

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add queue-state-diff

Metadata

name: queue-state-diff
description: Compare two queue or state snapshots and explain what changed between them. Use when Codex needs to analyze drift between JSON/JSONL snapshots, detect newly stuck jobs, missing queue references, changed counters, or state regressions across two points in time.

Queue State Diff

Use this skill to answer: what changed, what disappeared, and what got worse?

Workflow

Gather two comparable snapshots: before/after JSON, report JSON, or JSONL-derived exports.
Normalize them before reasoning; prefer deterministic diff over freehand comparison.
Run scripts/queue_state_diff.js for raw comparison.
Interpret the diff in terms of operational meaning: regressions, recoveries, or noise.

Script

node skills/queue-state-diff/scripts/queue_state_diff.js \
  --before out/report-before.json \
  --after out/report-after.json \
  --out out/queue-state-diff.md

Guardrails

Compare like with like; do not diff unrelated report formats.
Separate numeric drift from referential drift.
Call out missing keys explicitly instead of treating them as zero.