pua-debugging

Force exhaustive tool-first troubleshooting and five-step verification on repeated task failures.

19.3k|1.2k|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/tanweai/pua --skill pua-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pua-debugging
Source: https://github.com/tanweai/pua/tree/main/skills/pua-debugging
Command: npx skills add https://github.com/tanweai/pua --skill pua-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents premature abandonment and excuse-driven stop conditions by forcing exhaustive, tool-first troubleshooting and validated verification when tasks fail repeatedly or the assistant attempts to deflect work to the user or the environment.

Core Features & Use Cases

  • Automatic activation on failure patterns, excuses, passive waiting, or user frustration phrases.
  • Three iron laws & five-step methodology that require tool usage, context reading, hypothesis reversal, and end-to-end verification.
  • Pressure escalation and flavors (阿里/字节/华为/腾讯/美团 etc.) to change tactics and mandate different verification actions as failures accumulate.
  • Structured exit and handoff: when all checks are done but the issue persists, produce a fact-based failure report for next steps.

Quick Start

Type /pua to activate the skill and ask the assistant to exhaustively debug the failing task, run tool-based diagnostics, and return verified fixes plus next-step recommendations.

Frequently Asked Questions about pua-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I force exhaustive debugging when the assistant gives up on fixing deployment or API integration failures?

To stop an assistant from abandoning failed tasks, you enforce exhaustive troubleshooting that blocks excuse-driven stop conditions. It automatically triggers on failure patterns, mandates tool-first diagnostics, and requires a five-step verification methodology to produce validated fixes instead of deflections.

What is root-cause troubleshooting for software engineering and when should I apply it?

Root-cause troubleshooting is an exhaustive, tool-first diagnostic process applied when tasks fail repeatedly. You should use it for debugging, implementation, configuration, deployment, DevOps, and API integration workflows to ensure context reading, hypothesis reversal, and end-to-end verification.

How to verify a fix and prevent premature task abandonment during DevOps configuration failures?

To verify a fix during DevOps configuration failures, apply a five-step verification methodology that mandates tool usage, context reading, and hypothesis reversal. This prevents premature task abandonment by enforcing exhaustive checks before producing validated fixes or a structured handoff report.

Can I use proactive debugging for data processing and general software engineering workflows?

Yes, you can use proactive debugging for data processing, API integration, deployment, and general software engineering workflows. It applies exhaustive troubleshooting automatically when failure patterns or passive waiting occur, mandating tool-first diagnostics to resolve issues.

What should I do when exhaustive troubleshooting fails to find the root-cause of a task failure?

When exhaustive troubleshooting fails to find the root-cause after all checks are done, you should generate a structured failure report. This fact-based handoff document outlines next steps for resolution instead of allowing premature abandonment or excuse-driven stop conditions.