用途:为 Helmor 本地开发缺陷提供自主调试循环,覆盖复现、插桩、检查、修复、验证五个阶段。实际本地应用控制由 $helmor-debug-operate 通过 Tauri MCP 完成,本技能负责调试策略与证据规范。
主要能力:先用一两句话定义疑似行为、预期行为与成功信号;尽量通过真实 UI 操作复现;收集截图、DOM/无障碍快照、IPC 监控、控制台/系统日志与终端缓冲区;证据不足时添加带唯一前缀(如 [debug-loop:<slug>])的最小临时日志或探针,重跑后移除或说明保留理由;先分析证据再改产品代码,优先窄修复;用同一用户路径验证,用户可见流程需连续三次成功,除非用户明确降低标准;在 .agent-contexts/<task-slug>/ 下生成证据包,含复现尝试、日志、截图、IPC、修复摘要与剩余不确定性。
证据来源顺序:终端缓冲区(用 $helmor-debug-operate 的 Call App Commands 运行 debug_list_terminal_buffers,再用返回的 raw scriptType 调用 debug_read_terminal_buffer);UI 状态(截图加无障碍或结构快照);IPC(启动监控、执行一次操作、捕获过滤后的命令/事件、停止监控);日志(Tauri 控制台/系统日志,必要时读取开发数据目录下的 sidecar JSONL);代码探针(带唯一前缀的临时日志)。需要完整清单或复现失败时读 references/debug-loop.md,用 scripts/ 汇总日志与构建证据包,避免把原始转储粘贴到对话。
容错:三次不同尝试仍无法复现时,不得编造失败,标记为未复现并保留证据,检查本应触发的代码路径,报告最可能的缺失前置条件;偶发缺陷至少跑三次并对比证据,间歇性通过/失败视为有效发现;Tauri MCP 无法连接时按 $helmor-debug-operate 恢复步骤处理,仍不可用则退回静态代码分析与终端测试,并将 UI 验证标记为受阻;技能配方失败三次时按 stale-skill 规则,基于新截图/DOM/代码推理,记录候选技能更新,未经用户明确要求先询问再改;日志有泄露密钥风险时只记录形状/数量/状态,绝不打印访问令牌、凭据、API 密钥、Cookie 或私有账户信息;验证会改动持久用户数据时,改用一次性工作区/会话或停止并说明风险。