aist-debug

Diagnose root causes of regressions in aist APIs, Celery tasks, and sast-pipeline workflows.

Updated Aug 31, 2025
One-click install
npx skills add https://github.com/aist-ai-sast/aist --skill aist-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aist-debug
Source: https://github.com/aist-ai-sast/aist/tree/main/.claude/skills/aist-debug
Command: npx skills add https://github.com/aist-ai-sast/aist --skill aist-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers identify and verify the root cause of regressions in aist APIs, Celery tasks, deduplication logic, and the sast-pipeline, ensuring fixes address the actual issue rather than symptoms.

Core Features & Use Cases

  • Root-cause analysis: Guides step-by-step diagnosis of regressions across API endpoints, task queues, and pipeline stages.
  • Structured debugging workflow: Provides a repeatable process to reproduce, hypothesize, test, and validate fixes with traceability.
  • Use Case: When a recent API change causes failing tasks, use this skill to pinpoint the faulty component, reproduce the failure, and confirm the fix resolves it without introducing new issues.

Quick Start

Follow the structured debugging plan to identify the root cause of the latest AIST regression and prepare a validated fix plan.

Frequently Asked Questions about aist-debug

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

FAQPage Schema
How do I debug a regression in a Celery task or SAST pipeline workflow?

To debug a regression in Celery tasks or SAST pipelines, follow a structured debugging workflow to reproduce the failure, hypothesize potential causes, and validate fixes with traceable documentation.

What is the best way to find the root cause of an AIST API regression?

Finding the root cause of an AIST API regression requires systematic tracing and hypothesis validation to pinpoint the faulty component, ensuring the fix addresses the actual issue rather than symptoms.

Can I use structured debugging for AIST regressions across staging and production environments?

Yes, structured debugging for AIST regressions applies to diagnosing issues across development, staging, and production environments, using structured tracing to validate hypotheses in each context.

How do I verify that a fix for a deduplication logic regression works?

To verify a fix for a deduplication logic regression, reproduce the original failure, apply the correction, and confirm the fix resolves the issue without introducing new problems.

Why does my recent API change cause failing tasks in the SAST pipeline?

A recent API change causing failing tasks indicates a regression in the SAST pipeline, which requires step-by-step diagnosis across endpoints and task queues to isolate the faulty component.

What should a structured debugging plan for AIST regressions include?

A structured debugging plan for AIST regressions should include steps to reproduce the failure, formulate and test hypotheses, validate fixes, and document findings for clear traceability.