QClaw 执行诊断与优化

要解决什么问题

在 QClaw 上跑自动化时，常见反馈是「指令没反应」「不执行」「权限被拒」或「AI 忘了上一步说了什么」。这类现象往往混在一起：有时是一条指令塞了太多动作，有时是 Agent 路由或工具调度错了，有时是沙箱/白名单挡在半路，还有时是 LCM 压缩把关键细节挤没了。本技能把排查收成固定顺序，定位到具体原因就停，直接给修复方案，而不是泛泛建议重试。

技能如何工作

收到问题报告后，按四段流程逐项核对：

1. 指令设计检查：对照复合指令、模糊变量、隐式依赖、过度限定等模式；用「一条指令 = 一个核心动作 + 明确参数」拆解，并核对动作动词、数据来源、筛选条件、输出路径是否写清。
2. 执行链路追踪：沿协议解析 → Agent 路由 → 上下文组装 → 工具调度 → 实际执行逐环对照日志；用简化复现、分段执行、对照测试缩小故障点。
3. 权限边界诊断：从读工作目录内文件、写文件、执行白名单命令到调用外部 API，用最小粒度测试判断卡在系统权限、QClaw 沙箱还是工具自身配额/认证。
4. 上下文连贯性：区分活跃上下文、压缩摘要与 MEMORY.md / memory/*.md 持久化；必要时用 lcm_expand 展开摘要，或用语义锚点在多轮里显式引用前序结果。

诊断结束后还会对照优化清单：单动作单元、参数完整、无隐式依赖、权限在范围内、关键信息已落盘、多步任务有锚点串联。

适用边界与注意点

• 语义锚点依赖同一会话里模型的理解，不是系统级记忆 API；跨会话仍要靠 memory 文件。
• 执行超时需结合网络与目标应用状态，常与链路、权限章节交叉排查。
• 本技能是诊断流程与修复对照表，不替代各工具/API 的官方文档；具体报错仍要按工具说明处理。