用途：诊断并修复停滞的智能体编码循环（agent loop）。当循环卡住、故事（story）不再推进或事件链断裂时使用。
主要能力：diagnose 命令按顺序执行 6 项检查——Redis 状态（PRD 故事 pass/skip/pending、进度条目、活跃 claim）、工作树（是否存在、提交、未提交改动、.out 文件）、Inngest 运行（运行中/失败的 agent-loop-* 函数、近期 plan 运行）、智能体进程（是否仍有 claude/codex 存活）、worker 健康（localhost:3111/api/inngest 的 function_count）、以及将上述模式匹配为根因。
常见失败模式与修复：CHAIN_BROKEN（judge 发出 story.passed 但 plan 未收到，事件丢失）自动重发 agent/loop.story.passed；ORPHANED_CLAIM（故事被 claim 但智能体已死且无活跃 Inngest 运行）清除 claim 并重发 plan 事件；STUCK_RUN（运行标记 RUNNING 但进程已死）清除 claim 并重发，可能需在 Inngest 面板手动取消；WORKER_UNHEALTHY（注册函数少于预期）重启 k8s 中的 system-bus-worker 部署；NO_PRD 无自动修复，需新建循环；COMPLETE 无需操作，可用 joelclaw loop nuke dead 清理。
使用方式：joelclaw loop diagnose all -c 诊断全部；joelclaw loop diagnose <loop-id> -c 诊断单个；加 --fix 自动修复；去掉 -c 输出完整 JSON。手动排查顺序：先 diagnose all -c，需要时加 --fix，等待约 30 秒后用 joelclaw loop status <loop-id> -c 验证，仍卡住则检查 worker，最后可用 joelclaw loop restart <loop-id>。
适用场景：循环停滞排查、事件链断裂定位、worker 健康检查。限制：NO_PRD 与 COMPLETE 无自动修复；STUCK_RUN 可能需手动取消；watchdog 为未来计划，尚未提供；具体平台与部署细节以实际环境为准。