用途:Tinker 面向已注册但无法触发的 autoloop,负责诊断并修复文档化的引导失败模式,支持按需随时调用,幂等且非破坏性,健康循环不会产生任何改动。
主要能力:一次性运行四项诊断并以 JSON 报告输出:F1 缺少 plist(launchd plist 可能未加载,导致没有触发计划);F2 缺少钩子(四个 autoloop 钩子可能不在 ~/.claude/settings.json 中,使 session-bind 永不运行、owner_session_id 一直停留在 pending-bind);F3 绑定过期(owner_session_id 处于 pending-bind 超过绑定宽限期);F4 唤醒路径陈旧(plist 的 runner 指向旧 waker 路径,例如市场升级移动插件树之后)。确认后可对上述失败模式执行修复,并在修复后重新诊断,断言 failure_modes 为空;若仍有残留则输出并退出码 1,提示需人工介入。
使用方式:可传入可选位置参数,loop 标识符支持三种形式:<loop_id>(12 位十六进制)、AL-<slug>--<hash>(显示名)、AL-<slug>(仅 slug,歧义时报错并给出候选)。若未提供参数,且当前工作目录下恰好只有一个 .autoloop/<slug>--<hash>/CONTRACT.md,则从契约路径推断 loop_id,否则提示用户。执行流程为:解析 loop_id、诊断、修复前确认(默认 Repair all,可选 Diagnose only)、修复、再次验证。相关脚本位于插件目录,使用 registry-lib.sh 与 tinker-lib.sh。
限制与注意:不要删除契约文件或修订日志;不要覆盖真实的 owner_session_id(当注册表中已是有效 UUID 时 F3 拒绝修改);所有权转移应使用 /autoloop:reclaim 而非本技能。若 CLAUDE_SESSION_ID 为空,F3 会跳过并提示在循环工作目录新开会话以自然触发 session-bind.sh;若 F2 反复出现,可能有其他工具重写 settings.json 并剥离钩子;F1 报 waker 未找到时可能是插件安装损坏,可尝试 claude plugin reinstall autoloop@cc-skills。费用、价格与平台信息暂未提供。