SuperAPI AI 工具集

triage

通用与其它

查看项目

更新于 10-16 03:36

技能介绍

用途:用于自诊断 autoloop 循环集群,交叉引用 registry.json、heartbeat.json 文件、launchctl list 输出、plist 文件,并轻量参考 ~/.claude/projects 的 JSONL 记录,识别僵尸进程、孤儿条目、标签冲突、多 cwd 污染、过期绑定和心跳缺失。

严重级别:RED 为已知损坏需处理,包括僵尸 launchctl 条目、多 cwd 污染、标签冲突、契约文件缺失、cwd_drift_detected;YELLOW 为可能正常但值得关注,如 pending-bind 超过 1 小时、pid 已死但心跳较新;GREEN 为健康。

参数:--json 输出结构化 JSON 而非可读终端报告;--fix 仅应用安全自动修复。运行时设置 PLUGIN_ROOT 并 source "$PLUGIN_ROOT/scripts/triage-lib.sh",解析参数后调用 loop_triage_fix 或 loop_triage_report。

自动修复范围:卸载无 registry 记录的 com.user.claude.loop.* 僵尸 launchctl 条目并删除孤儿 plist;清理 contract_path 以 /var/folders/ 开头的测试残留条目。不会执行:为任何原因启动 claude --resume、自动回收仍有活跃所有者的循环(应使用 /autoloop:reclaim <loop_id>)、修改绑定 cwd 或清除 cwd_drift_detected、删除心跳文件或状态目录。

配套:heal-self.sh 在每次 SessionStart 钩子触发时自动运行,受内容哈希控制;将 owner_session_id 为 unknown、unknown-session、空或 pending-bind 且超过 1 小时的条目归档到 ~/.claude/loops/registry.archive.jsonl,归档为追加式。该技能自称会随使用改进,遇到可复现问题时应更新 SKILL.md。参考资料包括 plugins/autoloop/scripts/triage-lib.sh 与 heal-self.sh。