用途:驱动完整的改进循环,而非单次调试。开始前需加载并遵循 $diagnose,将其作为每一轮的证据引擎;本技能只增加外层循环,负责规划、实施、重新诊断并决定是否继续。显式调用即视为选择启用 $diagnose,并授权进行限定范围的本地修复与验证。
依赖与安装:选定安装不会自动安装依赖。若 $diagnose 未安装或不可用,应在改动前停止,并提示用 npx skills add LegendApp/legend-skills --skill diagnose 安装后重试。
循环步骤:1. 明确目标结果,锚定用户症状、性能目标、失败测试、UX 缺陷、回归或代码质量问题;若无可观察锚点,先建最快的反馈回路。2. 运行 $diagnose 一轮,记录因果证据及修复后要重跑的确切验证信号;仅在有可靠证据支持限定修复时推进,证据不足则继续可用探测,无法获得可信修复所需证据时停止并报告缺口。3. 制定带排序的修复计划,包含证据支持、改动文件或边界、预期改善的验证、以及计划可能出错的条件。4. 只实施排名第一的计划项,编辑限定在受支持的因果边界内。5. 用原始信号验证,先重跑复现路径或测量,再做聚焦回归,必要时扩大检查。6. 重新运行 $diagnose,基于新状态证据查找原症状仍失败、邻近遗留故障、修复引入的回归、新暴露的瓶颈或真实缝隙处的覆盖缺失。7. 决定是否继续,仅在证据指向可信的下一修复且安全时继续。
迭代纪律:保持简短日志,记录轮次、当前证据、所选修复、验证结果、下一问题或停止原因。失败实验应回退,除非有意保留且独立有用。若两轮无measurable改进且证据未更清晰,暂停实施,重新诊断反馈回路本身。
停止规则:仅在以下情况停止:$diagnose 无法用现有代码、工具或制品建立可信反馈回路;下一步需要用户输入、不可访问的外部状态、凭据、生产权限或破坏性操作;用户要求只读诊断而下一步将编辑文件;验证干净且新一轮 $diagnose 未发现可信故障;剩余改进属推测、表面或超出目标。停止时报告最终状态、验证证据、已知剩余风险,以及被阻塞时所需的最小用户动作或制品。