Diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

概览

The Diagnose skill, hosted in the mxyhi/ok-skills repository, provides a systematic framework for resolving complex software defects and performance bottlenecks. Designed for use with agents like Claude, Codex, and OpenClaw, it implements a disciplined six-step diagnostic loop. This process guides the agent through reproduction, minimization of the issue, hypothesis generation, instrumentation, fixing, and final regression testing. By following this structured methodology, the skill helps maintain code quality when users report broken functionality or unexpected system failures. The mxyhi/ok-skills repository, which maintains a popularity of over 400 stars, offers this tool to streamline the troubleshooting process across diverse environments including browser-based applications and ROS-integrated systems, ensuring a rigorous approach to software maintenance.

使用场景

Resolving intermittent software bugs through a structured reproduction and instrumentation cycle.
Identifying and fixing performance regressions in complex data or ROS-based systems.
Automating the regression testing process after applying fixes to reported code failures.

安装说明

# Review source first
open https://github.com/mxyhi/ok-skills/blob/main/diagnose/SKILL.md

Copy or clone the skill folder into your agent skills directory after reviewing its instructions and scripts.

安全提示

Users should ensure the AI agent has appropriate permissions to access the local environment for instrumentation and testing. Since this skill involves executing code to reproduce and fix bugs, it is recommended to run the diagnostic loop within isolated or development environments to prevent unintended side effects on production systems.

相关 Skills