Skill عملی برای AI Agent

Systematic Debugging

برای دیباگ مرحله‌ای بر اساس ریشه‌یابی، فرضیه‌سازی و تست استفاده می‌شود.

آمادهدیباگ سیستماتیکمتوسطبه‌روزرسانی ۱۶ تیر ۱۴۰۵
1

این Skill چه کاری می‌کند؟

این Skill به شما کمک می‌کند با کمک AI Agent مشکل را مرحله‌ای و بر اساس شواهد پیدا کنید. کافی است نشانه مشکل، محدوده رخداد و تغییر اخیر را به Agent بدهید تا فرضیه‌ها، تست‌های کوچک و علت ریشه‌ای دریافت کنید. این Skill برای کسانی مناسب است که می‌خواهند از patchهای سریع و حدسی دور بمانند.

2

ورودی لازم

  • نشانه مشکل
  • محدوده رخداد
  • تغییر اخیر
  • مواردی که رد شده‌اند
3

خروجی نهایی

  • فرضیه‌های مرتب‌شده
  • تست‌های کوچک
  • علت ریشه‌ای
  • راه‌حل تاییدشده
4

مناسب کدام Agentهاست؟

Claude CodeCursorCodexGeminiChatGPT
5

Copy Prompt / Workflow

دیباگ را مرحله‌ای و بر اساس شواهد انجام بده. ورودی: نشانه مشکل، محدوده رخداد و تغییر اخیر. خروجی: فرضیه، تست، نتیجه و علت ریشه‌ای.
6

آموزش استفاده مرحله‌ای

  1. مشکل را به یک نشانه قابل تست تبدیل کن.
  2. از Skill بخواه فرضیه‌ها را مرتب کند.
  3. برای هر فرضیه یک تست کوچک اجرا کن.
  4. فقط بعد از تایید شواهد، کد را تغییر بده.
7

مثال واقعی

اگر فرم ثبت‌نام گاهی submit نمی‌شود، این Skill می‌تواند مسیرهای ورودی، validation و state را جداگانه بررسی کند.
8

خطاهای رایج

  • به جای تحلیل، سریع patch می‌زنی.
  • تست‌های کوچک و قابل تکرار نمی‌سازی.
  • علت ریشه‌ای را با نشانه سطحی اشتباه می‌گیری.
9

منبع و نصب Skill

منبع اصلی و تأییدشده در skills.sh

npx skills add https://github.com/obra/superpowers --skill systematic-debugging
10
دیباگآمادهمتوسط

Diagnose

برای تشخیص مسئله قبل از تغییر کد و جلوگیری از fixهای حدسی استفاده می‌شود.

ورودینشانه خطا
خروجیفرضیه‌های محتمل
Compatible Agents
Claude CodeCursorCodexGeminiChatGPT
خروجی نهایی

فرضیه‌های محتمل · گام‌های بررسی · شواهد لازم · مسیر رفع مشکل

تست و توسعهآمادهمتوسط

TDD

برای اجرای توسعه تست‌محور با Agent و کاهش باگ قبل از نوشتن کد اصلی استفاده می‌شود.

ورودیرفتار مورد انتظار
خروجیتست fail اولیه
Compatible Agents
Claude CodeCursorCodexGitHub CopilotGemini
خروجی نهایی

تست fail اولیه · کد minimal برای pass · مراحل refactor · سناریوهای edge case

QA / Verificationآمادهساده

Verification Before Completion

برای چک نهایی قبل از اعلام اتمام کار توسط Agent استفاده می‌شود.

ورودیکار انجام‌شده
خروجیچک‌لیست تایید
Compatible Agents
Claude CodeCursorCodexGeminiChatGPT
خروجی نهایی

چک‌لیست تایید · موارد ناقص · خطاهای احتمالی · مرحله بعدی